Storefront MCP カートツールが廃止へ｜UCP Cart MCPへ移行

8月 04, 2026

API CHANGE

Storefront MCP カートツール廃止
UCP Cart MCPへ移行せよ

2026年8月31日までに /api/ucp/mcp エンドポイントへ切り替えが必要

AIエージェントやカスタムアプリからShopifyのカート操作に/api/mcpエンドポイントを利用している開発者は対応必須。get_cartとupdate_cartの2ツールがStorefront MCPサーバーから廃止され、UCP準拠の新エンドポイント/api/ucp/mcpへの移行が2026年8月31日までに求められます。新Cart MCPではcreate_cart・cancel_cartも追加され、カートライフサイクル全体をカバーします。

WHAT'S CHANGING

01廃止される機能と新ツールの全容

Storefront MCPサーバー(https://{shop}.myshopify.com/api/mcp)で提供されていたget_cartとupdate_cartが廃止対象となります。代わりに登場したCart MCPはUCP（Universal Cart Protocol）カートケイパビリティ（仕様ID: dev.ucp.shopping.cart、バージョン: 2026-04-08）に準拠しており、新エンドポイントhttps://{shop-domain}/api/ucp/mcpで以下の4ツールを提供します。

create_cart
ラインアイテムとオプションのバイヤーコンテキストを指定して新規カートを作成

get_cart
カートの現在の状態を取得。旧Storefront MCPと同名だがスキーマが異なる

update_cart
カートの内容を完全に置き換え（PUTセマンティクス）。差分パッチは不可

cancel_cart
カートをキャンセル。idempotency-key（UUID）が必須

MIGRATION GUIDE

02移行の仕組みをビジュアルで理解する

USE CASES

03業務に活かせる具体ユースケース

課題: AIチャットボットがShopifyカートを操作するアプリを構築したが、既存の/api/mcpエンドポイントを使っているため廃止後に動作しなくなる
打ち手: エンドポイントを/api/ucp/mcpへ変更し、get_cart/update_cartのリクエスト・レスポンススキーマを公式ドキュメントに合わせて更新。全リクエストにmetaオブジェクトとucp-agent.profileを付与する
効果: 廃止後も途切れることなく動作し、UCP標準への準拠によって将来的な相互運用性も確保される
技術メモ: update_cartはPUTセマンティクス。部分更新ではなく毎回line_items配列全体を送信する必要があります

課題: カートのキャンセル処理が今まで実装できておらず、ユーザーが離脱したセッションのカートが残り続けるという運用上の問題があった
打ち手: 新Cart MCPのcancel_cartツールを活用。キャンセル時にはmeta["idempotency-key"]にUUIDを設定して重複リクエストを防ぐ
効果: カートライフサイクルをアプリ側でコントロールできるようになり、不要な在庫ホールドの削減につながる
技術メモ: idempotency-keyはUUID形式が必須。リトライ時も同一キーを使い回すことで二重キャンセルを防止できます

課題: バイヤーコンテキスト（配送先・会員情報など）をカート作成時に渡せず、後から別APIで補完するフローが複雑だった
打ち手: create_cartのoptional buyer contextパラメータを利用し、カート生成と同時にバイヤー情報をセット
効果: API呼び出し回数を削減でき、パーソナライズされたカートを1ステップで生成できる
技術メモ: 旧Storefront MCPにはcreate_cart相当のツールが存在していなかったため、新Cart MCPでの新機能に当たります

DEVELOPER NOTES

04技術者が押さえるべき5つのポイント

#	ポイント	詳細
1	エンドポイント変更	`/api/mcp` → `/api/ucp/mcp` へ完全移行。ホストは`{shop-domain}`形式（`.myshopify.com`サブドメイン）
2	metaオブジェクト必須	全リクエストに`ucp-agent.profile`を含む`meta`オブジェクトを付与する必要あり。記載なしの場合の挙動は公式ドキュメントを要確認
3	PUTセマンティクス（update_cart）	`update_cart`は差分パッチではなくカート全体を置き換える。毎回`line_items`配列全体を送信しないと意図せずアイテムが消える可能性あり
4	cancel_cartのidempotency-key	UUID形式の`meta["idempotency-key"]`が`cancel_cart`呼び出し時に必須。冪等性保証のため同一操作では同じUUIDを再利用する
5	廃止期限とドキュメント方針	旧ツールのサポートは2026年8月31日まで。それ以降の公式ドキュメントはCart MCPのみを参照。早期移行を推奨