一个模型上下文协议（MCP）服务器，直接将Claude连接到您的Shopify商店。通过自然语言管理产品、订单、客户、收件、库存和履约。

---

你能用这个做什么

连接后，你可以这样与你的Shopify商店对话：

• “显示今天所有未完成的订单”
• “创建一款名为夏季T恤的新产品，售价€29.99，设置为draft”
• “我们有多少活性产品？”
• “用电子邮件 [email protected] 搜索客户”
• “将产品123的库存更新至50件”

---

要求

• Python 3.11 或更高版本
• Shopify 商店（任何套餐）
• Claude.ai Pro、Team 或 Enterprise 账户（用于远程 MCP 连接）

---

第一步 — 获取您的Shopify账号

你需要两个东西：你的商店名称和管理员API访问令牌。

找到你的店名

你的店名是.myshopify.com前面的部分。 举例来说：如果你的管理员网址是https://acme-store.myshopify.com/admin，那么你的商店名称是acme-store。

创建一个自定义应用，获取你的访问令牌

⚠️ 重要： 普通的Shopify API密钥无法使用。

Shopify MCP Server

A Model Context Protocol (MCP) server that connects Claude directly to your Shopify store. Manage products, orders, customers, collections, inventory, and fulfillments — all through natural language.

---

What you can do with this

Once connected, you can talk to your Shopify store like this:

• “Show me all unfulfilled orders from today”
• “Create a new product called Summer T-Shirt, price €29.99, set it to draft”
• “How many active products do we have?”
• “Search for customers with the email [email protected]”
• “Update inventory for product 123 to 50 units”

---

Requirements

• Python 3.11 or higher
• A Shopify store (any plan)
• A Claude.ai Pro, Team, or Enterprise account (for remote MCP connections)

---

Step 1 — Get your Shopify credentials

You need two things: your store name and an Admin API access token.

Find your store name

Your store name is the part before .myshopify.com. Example: if your admin URL is https://acme-store.myshopify.com/admin, your store name is acme-store.

Create a Custom App and get your access token

⚠️ Important: A regular Shopify API key will NOT work. You need an Admin API access token from a Custom App. Follow these steps exactly.

1. Go to Shopify Admin → Settings → Apps and sales channels
2. Click Develop apps in the top right corner
3. If prompted, click Allow custom app development
4. Click Create an app, give it a name (e.g. MCP Server), click Create app
5. Go to the Configuration tab → click Configure Admin API scopes
6. Enable the scopes you need. For full access, select:
   • read_products, write_products
   • read_orders, write_orders
   • read_customers, write_customers
   • read_inventory, write_inventory
   • read_fulfillments, write_fulfillments
   • read_webhooks, write_webhooks
7. Click Save
8. Go to the API credentials tab → click Install app → confirm
9. Click Reveal token once and copy the token immediately — it starts with shpat_

💡 Shopify only shows this token once. If you lose it, go back to API credentials, uninstall the app, then reinstall to generate a new one.

---

Step 2 — Set up the server locally

Clone this repo

git clone https://github.com/daanjonk/shopify-mcp.git
cd shopify-mcp

Install dependencies

pip install -r requirements.txt

Configure your environment variables

cp .env.example .env

Open .env and fill in your values:

SHOPIFY_STORE=your-store-name
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxx

Only these two are required. Leave everything else as-is.

Run the server

python server.py

You should see output like:

INFO  Token mode: static SHOPIFY_ACCESS_TOKEN (no auto-refresh)
INFO  Uvicorn running on http://0.0.0.0:8000

Your MCP server is running at http://localhost:8000/mcp.

---