Shopify Admin MCP

A1 Shopify Admin MCP 通过 Admin API (GraphQL) 将 AI 应用连接到 Shopify 商店后台。它可以帮助你用自然语言处理商品和价格、订单、客户、库存和促销码。

服务器绑定到单个商店：域名由配置指定，令牌是自定义应用的 Admin API access token，任何工具都无法访问其他商店。

• 16 个工具。 商店、商品和变体、订单、客户、地点和库存、折扣——外加任意 GraphQL 查询以处理其他一切。

• 诚实的 HTTP 200。 Shopify 的变更操作即使失败也返回 200；服务器读取 userErrors 并将拒绝转换为清晰的错误。没有 data 对象的 200 响应——空的、截断的或根本不是 GraphQL——也会变成错误，而不是空结果。

• 不可逆操作可见。 取消订单（包括退款和退货的决定）和任意 GraphQL 被标记为 destructive。

• 成本桶受控。 每个响应都携带 cost：请求花费了多少，以及 GraphQL 桶中还剩多少积分。

从一个只读取数据的请求开始：

显示商店最近的订单和带库存的热门商品。

连接服务器 · 查看场景 · 打开技术文档

一分钟看到效果

你： 显示商店最近的订单和带库存的热门商品。

助手： 显示带有状态和金额的订单，以及带有价格和库存的商品。不会更改任何内容。

你： 准备一个为期两周、使用促销码 SUMMER 的 20% 折扣。

助手： 显示未来促销码的参数——代码、大小、期限、限制——并请求确认。

你： 我确认。

• 快速开始

• 可以委托什么

• 可能发生什么变化

• 获取访问权限

• 配置

• 数据、限制和后台工作

• 技术文档

• 支持

快速开始

需要 Node.js 20+、形如 my-store.myshopify.com 的商店域名，以及自定义应用的 Admin API access token（shpat_…）。创建应用需要商店所有者权限或员工的应用开发权限。

1. 获取访问权限。

2. 将服务器添加到 AI 应用。

3. 发送上面的安全第一个请求。

在 Settings → Plugins → MCP servers 中点击 Add server，然后添加 npx -y mcp-shopify-admin@latest，并设置 SHOPIFY_STORE_DOMAIN 和 SHOPIFY_ACCESS_TOKEN。

codex mcp add shopify-admin \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  -- npx -y mcp-shopify-admin@latest
codex mcp list

Codex MCP 文档

claude mcp add \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  --transport stdio --scope user shopify-admin \
  -- npx -y mcp-shopify-admin@latest
claude mcp list

Claude Code MCP 文档

打开 Settings → Developer → Edit Config 并添加：

{"mcpServers":{"shopify-admin":{"command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}}

如果 Edit Config 不可用，请在 macOS 上编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，或在 Windows 上编辑 %APPDATA%\Claude\claude_desktop_config.json。Claude Desktop MCP 文档

将 {"mcpServers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}} 添加到 macOS/Linux 上的 ~/.cursor/mcp.json 或 Windows 上的 %USERPROFILE%\.cursor\mcp.json。Cursor MCP 文档

运行 MCP: Open User Configuration 并添加：

{"servers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"${input:shopify_store_domain}","SHOPIFY_ACCESS_TOKEN":"${input:shopify_access_token}"}}},"inputs":[{"type":"promptString","id":"shopify_store_domain","description":"Домен магазина my-store.myshopify.com"},{"type":"promptString","id":"shopify_access_token","description":"Admin API access token (shpat_…)","password":true}]}

使用 MCP: List Servers 命令检查服务器。VS Code MCP 文档

可以委托什么

• 显示一周内的订单、它们的支付和发货状态。

• 查找没有库存的商品，并提高所选变体的价格。

• 以草稿形式创建新商品并填写描述。

• 盘点后设置实际库存。

• 创建带有使用限制的促销码。

• 通过 email 查找客户并显示其最近的订单。

可能发生什么变化

创建订单、执行发货、修改客户、将商品发布到销售渠道以及删除对象不在工具集中——如有必要，可通过 graphql_request 并明确确认来完成。

获取访问权限

1. 打开商店后台：Settings → Apps and sales channels → Develop apps（如果应用开发已关闭，请启用）。

2. 创建应用，并在 Configuration 选项卡中授予所需的 Admin API access scopes：read_products/write_products、read_orders、read_customers、read_locations/write_inventory、read_discounts/write_discounts——根据你的场景。

3. 安装应用，并在 API credentials 选项卡中复制 Admin API access token（shpat_…；仅显示一次）。

4. 将域名和令牌作为 SHOPIFY_STORE_DOMAIN 和 SHOPIFY_ACCESS_TOKEN 传递。

令牌是静态的，并绑定到商店。请像密码一样保管。如果之后授予应用新的 scopes，Shopify 将发布新令牌——请更新变量并重启服务器。对于安全的演练，development store 很方便。

配置

数据、限制和后台工作

• GraphQL 成本桶。 每个请求按复杂度消耗积分；桶每秒恢复。一页 first 最多 250 比一系列小请求更节省；服务器在每个结果中显示 cost。

• 临时错误。 THROTTLED 会根据桶的数学计算自动重试并等待。变更操作在网络或 5xx 错误后不会重试，以避免重复应用更改。

• 超过 60 天的订单 需要 scope read_all_orders，Shopify 按请求授予；没有它，旧订单根本不会返回。

• 没有持续监控。 服务器仅在调用时工作。如果 AI 应用支持定时任务，它可以定期检查订单和库存。

• 匿名遥测。 不包含机密、商店数据、参数和提示；禁用：ASKADS_TELEMETRY=0。

技术文档

• MCP 能力目录 — 每个工具的用户任务页面。

• 所有工具和参数

• 开发文档

• 发布文档

• Shopify Admin API (GraphQL) 文档

支持

发现错误或缺少场景？创建 issue 或通过 Telegram 联系我们。