商品カタログを扱う MCP ツールが search_catalog / lookup_catalog / get_product の3本に再編。呼び出し先も /api/ucp/mcp へ。旧ツールは 2026年6月15日まで維持され、その後廃止。
従来の検索・ルックアップ用ツールを利用。リクエスト/レスポンスの形式も旧仕様。2026年6月15日まで維持されるが、その後廃止される。
search_catalog / lookup_catalog / get_product に再編。呼び出し先は /api/ucp/mcp。形式も UCP に合わせて更新される。
search_catalogストアの商品カタログを検索する。フィルタ・ページネーション・購入者コンテキスト(buyer context)に対応。
lookup_catalog識別子(identifier)で商品やバリアントを一括(batch)ルックアップ。入力との相関付け(inputs correlation)に対応。
get_product商品の全詳細を取得。インタラクティブなバリアント選択、在庫シグナル(availability signals)などを含む。
| ツール | 役割 | 記事に明記された特徴 |
|---|---|---|
search_catalog |
カタログ検索 | フィルタ/ページネーション/購入者コンテキスト |
lookup_catalog |
識別子での一括取得 | 商品・バリアントのバッチルックアップ/inputs correlation |
get_product |
単一商品の詳細取得 | バリアント選択/在庫シグナル/その他 |
https://{storedomain}/api/ucp/mcp に対して行う。{storedomain} は自分のストアドメインに置き換える。旧エンドポイントの具体パスについては記事に記載なし。Storefront MCP ツールで開発している場合に必要な対応(記事「What you should do」より)。
search_catalog / lookup_catalog / get_product のいずれかに置き換える。
呼び出し先を https://{storedomain}/api/ucp/mcp に変更する。
全ツール呼び出しの新しいリクエスト/レスポンススキーマを確認し、アプリを合わせる。
本記事(Developer Changelog)では、Storefront Catalog のカタログツールが 「UCP を実装する(implements UCP)」 こと、そしてリクエスト/レスポンスの形が 「UCP に合わせて(to match UCP)」 更新されることが述べられている。
UCP という略語の正式名称・定義そのものは、この記事には記載なし。 推測を避け、正確な定義・仕様は公式ドキュメントで確認すること。本ページでは「カタログツールが準拠する新しい仕様」として扱う。
buyer context / inputs correlation / availability signals といった用語は記事内で名前として挙がっているが、具体的なフィールド仕様までは記載なし。実装前にスキーマドキュメントで確認すること。旧ツールはこの日まで維持され、その後廃止。Action Required の破壊的変更なので、稼働中アプリは期日までに移行計画を立てる必要がある。
旧 search/lookup 系から search_catalog / lookup_catalog / get_product へ。MCP クライアント側のツール参照を全て書き換える。
呼び出し先は /api/ucp/mcp に一本化。ベース URL/環境変数として外出ししておくと移行とロールバックが楽。
リクエスト/レスポンスの shape そのものが UCP 準拠に変わる。パーサ・型定義・バリデーションの更新が伴う前提で見積もる。
買い手コンテキスト(buyer context)、入力相関(inputs correlation)、在庫シグナル(availability signals)といった機能名が新ツールに紐づくが、UCP の定義や各フィールドの詳細仕様は本記事に記載なし。実装前に Storefront Catalog MCP のスキーマドキュメントを必ず確認する。
search_catalog・get_product にリネーム、エンドポイントを /api/ucp/mcp に変更、レスポンスを新スキーマに合わせて再マッピング。lookup_catalog のバッチ取得で再構築lookup_catalog の識別子バッチルックアップに移行し、inputs correlation で「入力した識別子」と「返ってきた結果」を対応付ける。get_product の在庫シグナルで強化get_product のインタラクティブなバリアント選択と availability signals を使い、在庫切れバリアントを抑制・グレーアウト表示する。get_product の新レスポンスに含まれる。表示ロジックを在庫シグナル駆動に切り替える。search_catalog / lookup_catalog / get_product の3ツール+/api/ucp/mcp エンドポイントへ移行が必要。