服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- Shop MCP 已上线;Shopify 原有 Catalog API 集成不需要迁移或修改。
- 服务地址是 https://mcp.shop.com/,没有 /mcp 路径;仅支持旧 initialize 握手的客户端无法连接。
- 商品搜索不需要 API key;公告提到更高搜索限额可使用 key,但未公布具体限额或费用。
- 购物车和结账一次只对应一家商店;创建结账不等于下单,买家确认订单和付款方式后才能调用 complete_checkout。
Shop MCP 带来了什么?
Shopify 在 2026 年 10 月 13 日宣布 Shop MCP 已上线。一个连接可以搜索 Shopify Catalog 商品、读取商品详情、建立购物车、创建商店结账,并在买家确认付款后完成订单。
这与 Shopify 现有 Catalog API 是并行入口,官方说现有 API 集成不需要改动。它也不同于Shopify Checkout WebMCP:那篇指南讲的是代理在买家浏览器里的当前结账页操作;本文讲连接到 Shop MCP 远程服务的代理。
接入时为什么不能加 /mcp?
Shop MCP 的地址是 https://mcp.shop.com/ 根路径。官方文档明确说服务没有 /mcp 子路径,访问该路径会返回 404;应把根地址填入兼容客户端,并加载 https://mcp.shop.com/skill.md 让代理理解工具的使用边界。
服务采用 MCP 2026-07-28 协议和 server/discover 握手。只支持旧 initialize 握手的客户端即使标称支持 MCP 也无法连接;可改用官方文档支持的 CLI 或 HTTP 接入方式。Claude、ChatGPT、Claude Code 及其他兼容远程 HTTP MCP 的客户端各有自己的配置步骤。
搜索、购物车和账户权限有什么区别?
商品搜索可在未登录时使用,也不要求 API key。Shopify 公告称更高搜索限额可创建 API key,但公开说明没有给出限额数字、收费规则或各地区的具体可用范围,不应把免 key 搜索理解成不限量或免费交易。
购物车与结账工具也可不登录使用;登录 Shop 后,结账才可按商家提供情况使用已保存地址和 Shop Pay。读取账户、查找订单及五项购买审批工具需要买家授权的账户令牌。Shopify 文档要求把令牌仅放在发往 https://mcp.shop.com/ 的 Authorization 请求头,不要放进 URL、工具参数或日志。
结账什么时候可以创建或付款?
每个购物车和结账都属于一家商店,搜索结果来自三家商店就需要分别结账。Shopify 建议只有买家明确要求时才创建购物车或结账;仅仅对商品感兴趣不算请求。
创建结账本身不会下单。只有状态为 ready_for_complete 时,代理才应向买家展示商家、商品与数量、当前总价和可选付款方式,让买家选择并确认后,再调用一次 complete_checkout;不要替买家选默认付款方式。若买家需要在商店页面补信息或复核,就交还 continue_url。
没有 webhook 时怎样核对订单?
Shopify 公告说明,Shop MCP 上线时没有提供 webhook,因此集成方需要轮询 get_checkout 读取结账状态。只有返回 status: completed 且包含 order,才可向买家显示订单已创建;在 complete_in_progress 时应继续读取状态,不要重复提交付款。
结账 ID 和 continue_url 含有可访问该结账的密钥,应避免写入日志或分析系统,并只把 continue_url 交给对应买家。遇到 404 先检查是否误加了 /mcp;遇到限流按响应给出的 retry_after 等待,未知结果时先读取当前结账再决定是否重试写操作。
发布状态和仍未知的范围
Shop MCP 已由 Shopify 宣布上线,适用对象是构建或配置 MCP 兼容代理及工具的开发者。现有 Catalog API 使用者没有必须迁移的动作;购买、配送、税费和可用付款方式仍由相应商店的结账结果决定。
官方公开资料没有在上述公告中列明更高搜索限额的数字、完整计费方式或逐国覆盖清单。集成前应以目标 MCP 客户端实际支持的协议、工具清单和商店返回的结账信息为准,不能从“兼容 MCP”推断每个客户端、账户或商家都可用。
资料来源
常见问题
Shop MCP 可以直接用在 ChatGPT 或 Claude 吗?
Shopify 的接入文档提供 ChatGPT、Claude 和 Claude Code 的配置步骤,也允许支持远程 HTTP MCP 2026-07-28 的其他客户端接入。具体账户或组织可能需要先启用连接;旧 initialize 握手客户端不兼容。
Shop MCP 搜索需要 API key 或付费吗?
Shopify 公告称商品搜索不需要 API key,并提到更高搜索限额可创建 key,但没有公开具体限额或费用。免 key 不等于不限量,也不代表商品、结账或付款免费。
买家没登录 Shop,代理还能创建购物车吗?
可以。Shopify 文档说购物车和结账工具无需登录也能工作;登录后才可能使用已保存地址和 Shop Pay。访问账户、订单和购买审批则需要授权令牌。
代理能在买家没有确认时完成订单吗?
不应这样做。Shopify 要求代理展示商家、商品、当前总价和付款选项,让买家选择并确认后再调用 complete_checkout。若结账需要买家补资料或在商店页面复核,应交还 continue_url。
Shop MCP 有订单 webhook 吗?
Shopify 的上线公告称当时没有 webhook,需要轮询 get_checkout。返回 status: completed 并包含 order 才能确认订单完成。
Shop MCP 地址后面要加 /mcp 吗?
不要。Shop MCP 使用 https://mcp.shop.com/ 根地址,官方文档说 /mcp 子路径会返回 404。客户端还必须支持 MCP 2026-07-28 的 server/discover 握手。