Storefront MCP の get_cart / update_cart が非推奨に。UCP 準拠の Cart MCP(新エンドポイント /api/ucp/mcp)へ移行する。旧ツールは 2026年8月31日 まで維持。
get_cart / update_cart は 2026年8月31日まで動くが、以降はドキュメントもすべて新ツール前提になる。
https://{shop}.myshopify.com/api/mcp の get_cart / update_cart が対象。
https://{shop-domain}/api/ucp/mcp。UCP カート機能 dev.ucp.shopping.cart(version 2026-04-08)を実装。
旧ツールはこの日まで維持。それまでに移行を完了させる必要がある。
dev.ucp.shopping.cart(version 2026-04-08)に準拠する。旧ツールに無かった create_cart / cancel_cart が加わり、ライフサイクル全体をカバーする。
| 項目 | 旧 : Storefront MCP | 新 : UCP Cart MCP |
|---|---|---|
| エンドポイント | https://{shop}.myshopify.com/api/mcp |
https://{shop-domain}/api/ucp/mcp |
| ツール | 2種 get_cart / update_cart | 4種 create / get / update / cancel |
| 準拠仕様 | Shopify 独自 | UCP dev.ucp.shopping.cart(2026-04-08) |
| meta オブジェクト | 記載なし | 全リクエストに ucp-agent.profile が必要。cancel は idempotency-key(UUID)も |
| update の意味 | 記載なし | PUT 完全置換(毎回全 line_items を送る) |
| サポート期限 | 2026-08-31 まで | 今後の標準 |
get_cart / update_cart の呼び先を /api/ucp/mcp の Cart MCP ツールへ。
ucp-agent.profile を必ず含める。cancel_cart には idempotency-key(UUID)も。
update_cart は完全置換。毎回 完全な line_items 配列を送る。
全カートツールの新しい request/response スキーマを確認し、アプリを合わせる。
shopify.dev/docs/agents/carts-and-checkout/cart-mcp)を参照。移行猶予は 2026年8月31日 まで。meta["idempotency-key"] に UUID を入れる。リトライ時の二重キャンセルを防ぐための仕組み。カート操作が UCP dev.ucp.shopping.cart(2026-04-08)に準拠。エージェント連携をベンダー横断の標準に寄せる動き。
旧は get/update のみ。新は create_cart / cancel_cart が加わりカートのライフサイクル全体を扱える。
差分パッチではなく状態のリプレイス。クライアント側で完全な明細を組み立てる設計に変える必要がある。
全リクエストに ucp-agent.profile。cancel は idempotency-key(UUID) も。共通のリクエストラッパを1本用意すると楽。
旧ツールはこの日まで維持されるが以降はドキュメントも全て新ツール前提。エンドポイントURL(myshopify.com/api/mcp → {shop-domain}/api/ucp/mcp)とスキーマ差分を、期限前に洗い出して切り替える。
/api/ucp/mcp)へ移行。create/get/update/cancel の4ツールでカート操作を完結させる。meta.ucp-agent.profile を自動付与。cancel だけ UUID 冪等キーを生成して差し込む。/api/mcp)とツール名で検索するとヒットしやすい。移行後は新スキーマでの結合テストを CI に追加。/api/ucp/mcp・create/get/update/cancel の4ツール)へ移行が必要。