变更内容
Storefront MCP 服务器上的购物车工具正逐步弃用,转而采用符合 UCP 规范的 Cart MCP 工具:
- get_cart和update_cart在https://{shop}.myshopify.com/api/mcp上已弃用。
Cart MCP实现了UCP购物车功能(dev.ucp.shopping.cart,版本2026-04-08),并在https://{shop-domain}/api/ucp/mcp端点暴露以下工具:
- create_cart: 创建包含行项目且可选买家上下文的新购物车。
- get_cart: 获取购物车的当前状态。
- update_cart: 替换购物车的内容。
- cancel_cart: 取消购物车。
这些已弃用的工具将保留至 2026 年 8 月 31 日,但所有文档都将引用 Cart MCP 工具。
您应采取的措施
如果您正在使用 Storefront MCP 购物车工具进行开发:
将get_cart和update_cart调用迁移到Cart MCP工具,并更新端点以使用https://{shop-domain}/api/ucp/mcp。
在每个请求中包含携带ucp-agent.profile的meta对象,以及用于cancel_cart的meta["idempotency-key"](UUID)。
请注意,update_cart使用PUT语义:每个请求都会替换购物车的完整状态,因此在每次更新时发送完整的line_items数组,而不是修补各个字段。
查阅所有购物车工具的更新后请求和响应模式,并相应地更新您的应用程序。
有关更多详细信息,请参阅Cart MCP文档(https://shopify.dev/docs/agents/carts-and-checkout/cart-mcp)。

