Shopify MCP Server 是一个面向生产环境的 Model Context Protocol（MCP）服务器，用于把 Shopify Admin GraphQL API 暴露给 AI 助手（例如 Claude Desktop）。它提供约 40 个带类型定义的工具，让 AI 助手通过结构化接口管理商品、客户、订单、库存、元字段以及店铺运营。
用途 该服务器把 MCP 工具调用翻译为 Shopify Admin GraphQL 操作，使 AI 助手能够以受控方式读写 Shopify 店铺数据。它支持静态访问令牌（旧版自定义应用）和 OAuth 客户端凭证流程（Dev Dashboard 应用），并可选启用 Redis 令牌缓存、结构化 JSON 日志、优雅关闭与错误处理。请求流程为：MCP 客户端 → 工具注册表 → Zod 校验 → Shopify GraphQL API → 格式化响应。
主要能力 工具按类别划分：商品（12 个，含 list、create、update、delete、variants）、客户（8 个，含 list、create、update、delete、merge）、订单（10 个，含 list、get、cancel、fulfill、refund）、元字段（4 个，get、set、delete，适用于任意资源）、库存（4 个，设置数量、获取库存层级/项目）、发现（2 个，店铺信息、位置）。所有列表工具均支持 first、after、query、sortKey、reverse 参数，并支持基于游标的分页。
使用方式 可通过 npx 快速启动：npx shopify-mcp --clientId YOUR_CLIENT_ID --clientSecret YOUR_CLIENT_SECRET --domain your-store.myshopify.com。也可从源码构建：git clone https://github.com/Cesarjoquin/shopify-mcp.git，然后 cd shopify-mcp、npm install、npm run build、npm start。在 Claude Desktop 中，需在 claude_desktop_config.json（macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%/Claude/claude_desktop_config.json）添加 mcpServers 配置，command 为 npx，args 包含 shopify-mcp 及相应参数。
配置方面，可通过环境变量或 CLI 标志提供：MYSHOPIFY_DOMAIN（必填）、SHOPIFY_ACCESS_TOKEN（静态令牌）或 SHOPIFY_CLIENT_ID 与 SHOPIFY_CLIENT_SECRET（OAuth）、SHOPIFY_API_VERSION、LOG_LEVEL，以及可选的 Redis 相关变量（REDIS_ENABLED、REDIS_URL、REDIS_KEY_PREFIX、REDIS_MAX_RETRIES、REDIS_CONNECT_TIMEOUT_MS）。CLI 标志可覆盖环境变量。为获得完整功能，需在 Shopify 自定义应用中授予以下作用域：read_products、write_products、read_customers、write_customers、read_orders、write_orders、read_inventory、write_inventory、read_metaobjects、write_metaobjects。
适用场景 适用于需要通过 AI 助手以结构化方式管理 Shopify 店铺商品、客户、订单、库存和元字段的场景，例如批量查询订单、创建商品、更新客户信息、设置库存数量、履行订单等。也适合开发者基于 createTool() 工厂模式扩展自定义工具，并借助 npm run typecheck、npm run lint、npm test、npm run validate、npm run build、npm run dev 等脚本进行开发与验证。
限制与注意事项 资料未提供收费、价格或平台兼容性等额外信息。使用中可能遇到认证失败（需提供静态令牌或 OAuth 凭证）、MCP 连接问题（可查看 Claude Desktop 日志）、Redis 连接错误（可启动本地 Redis 或禁用缓存）、GraphQL userErrors（字段级校验错误会以“Failed to create product: field: error message”形式返回）以及 API 版本兼容性问题（可通过 SHOPIFY_API_VERSION 指定版本）。OAuth 客户端凭证流程下令牌会缓存在 Redis，并在过期前 5 分钟自动刷新，也可手动清除缓存。生产部署需检查环境变量，并可使用 Docker 部署；服务器以结构化 JSON 日志输出到 stderr，便于监控错误、GraphQL API 速率限制警告和 Redis 连接失败。