详细介绍
概览
Shopify MCP(npm 包 shopify-mcp,GitHub GeLi2001/shopify-mcp)是社区维护的 Model Context Protocol 服务器,把 Shopify Admin GraphQL API 包装给 Claude Desktop、Claude Code、Cursor 等 AI 宿主。它面向希望用对话管理店铺运营(商品、顾客、订单、库存、Metafield、标签)的商家与开发者,而不是 Shopify 面向买家的 Storefront MCP。
项目文档支持 Dev Dashboard 应用的 Client Credentials(含 token 刷新)以及旧版静态 Admin API access token。README 中会标注默认 API 版本。这不是 Shopify 官方产品,应视为第三方开源。
主要功能
- 商品 CRUD: 通过 MCP 工具创建、更新并管理商品、变体与选项。
- 顾客与地址: 含合并与地址管理等顾客生命周期辅助能力。
- 订单与履约: 查询、取消、关闭/打开、标记已付款、履约与退款相关工具。
- Metafield 与标签: 在可打标签资源上获取/设置/删除 Metafield,以及增删标签。
- 库存: 在指定地点设置绝对库存数量。
- 列表体验: 列表接口支持游标分页、排序键,并可透传 Shopify 查询语法。
如何使用
- 安装兼容 MCP 的客户端(Claude Desktop、Cursor、Claude Code 等)。
- 从 https://github.com/GeLi2001/shopify-mcp 克隆或安装服务器,按 README 完成构建 /
npx/ Docker。 - 在对应平台申请 API 凭证,写入 MCP 的
env,切勿把密钥提交到 Git。 - 在客户端 MCP 配置(如 Claude Desktop 的
claude_desktop_config.json或 Cursor 的mcp.json)中注册该服务器,然后重启客户端。 - 先用只读问题验证;确认权限与确认开关后再启用写入类工具。
定价
MCP 服务器开源。你仍需要 Shopify 店铺以及具备相应 Admin API 权限范围的自定义应用。Shopify 订阅费用照常;MCP 包本身可通过 npx shopify-mcp 或全局安装免费本地运行。
| 方案 | 计费 | 价格 | 说明 |
|---|---|---|---|
| shopify-mcp(开源) | — | 免费 | 社区项目;自行托管 |
| Shopify 店铺 + 应用 | Shopify 套餐 | 按 Shopify | 需要 Admin API 凭证 |
适用人群
希望在客服或运营工作中用 Claude/Cursor 管理 Admin GraphQL 任务(改目录、处理订单、维护 Metafield)的 Shopify 运营与代理商。若目标是买家侧购物对话,优先使用官方 Storefront MCP。
常见问题
是官方 Shopify 服务器吗?
不是。这是 GeLi2001 社区服务器。Shopify 官方 Storefront MCP 文档在 shopify.dev。
包名注意点?
使用 shopify-mcp(命令 shopify-mcp)。README 提醒不要与要求不同环境变量的其他同名风格包混淆。
鉴权选项?
Client ID + Client Secret(Dev Dashboard),或旧版 shpat_ Admin token,再加上你的 *.myshopify.com 域名。
有多少工具?
README 宣传扩展后的 Admin 工具集(产品、顾客、订单、Metafield、库存、标签等 30+ 工具)。集成时请以仓库当前数字为准。