Shopify MCP Server

基本能力

产品定位

Shopify MCP Server 是一个用于与 Shopify API 交互的中间件，提供了一套工具集，帮助开发者高效管理 Shopify 商店的数据。

核心功能

• 产品管理：搜索和检索产品信息
• 客户管理：加载客户数据和管理客户标签
• 订单管理：高级订单查询和过滤
• GraphQL 集成：直接与 Shopify 的 GraphQL Admin API 集成
• 全面的错误处理：清晰的 API 和认证错误消息

适用场景

• 需要自动化管理 Shopify 商店产品的场景
• 需要批量处理客户数据的场景
• 需要高级订单查询和过滤的场景
• 需要与 Shopify GraphQL API 深度集成的开发场景

工具列表

1. 产品管理工具
2. get-products: 获取所有产品或按标题搜索

3. get-product-by-id: 通过 ID 获取特定产品

4. 客户管理工具

5. get-customers: 获取客户或按名称/电子邮件搜索
6. update-customer: 更新客户信息

7. get-customer-orders: 获取特定客户的订单

8. 订单管理工具

9. get-orders: 获取订单并可选择过滤
10. update-order: 更新现有订单信息

常见问题解答

• 如何获取 Shopify 访问令牌？ 需要在 Shopify 商店中创建一个自定义应用，并配置相应的 API 范围。
• 如何调试问题？ 可以检查 Claude Desktop 的 MCP 日志文件。

使用教程

使用依赖

1. Node.js (版本 16 或更高)
2. Shopify 自定义应用访问令牌

安装教程

1. 获取 Shopify 访问令牌
2. 从 Shopify 管理员界面进入 设置 > 应用和销售渠道
3. 点击 开发应用
4. 创建新应用并配置以下 API 范围：
   • read_products, write_products
   • read_customers, write_customers
   • read_orders, write_orders

5. 安装应用并复制生成的访问令牌

6. 与 Claude Desktop 一起使用 在 claude_desktop_config.json 中添加配置： json { "mcpServers": { "shopify": { "command": "npx", "args": [ "shopify-mcp", "--accessToken", "<YOUR_ACCESS_TOKEN>", "--domain", "<YOUR_SHOP>.myshopify.com" ] } } }

7. 替代方案：使用环境变量本地运行

8. 创建 .env 文件并设置 Shopify 凭证

9. 运行命令：npx shopify-mcp-server

10. 直接安装（可选） npm install -g shopify-mcp-server 然后运行： shopify-mcp-server --accessToken=<YOUR_ACCESS_TOKEN> --domain=<YOUR_SHOP>.myshopify.com

调试方式

检查 Claude Desktop 的 MCP 日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。