mcp-ucp

@codespar/mcp-ucp

非推奨：稼働中のエンドポイントはありません。 2026-09-27 に測定したところ、commerce.googleapis.com はすべてのパスに対して、Google の汎用的な Error 404 (Not Found) ページを返します。また、UCP_SANDBOX=true で使用する sandbox.commerce.googleapis.com は、提供される証明書が *.googleapis.com を対象としており、追加のラベルを対象としていないため、TLS ハンドシェイクに失敗します。UCP はオープンな仕様であり、Google がホストする API ではありません。このサーバーのツールはいずれもサービスに接続できません。このパッケージは npm で非推奨となっており、参照用としてこのリポジトリに残されています。稼働中のエンドポイントをお持ちの場合は、UCP_BASE_URL を使ってサーバーの接続先を指定してください。パッケージの提供を再開するには、プロバイダーがドキュメントで公開しているベース URL を添えて、mcp-dev-latam に issue を作成してください。

エージェントによるショッピング、カート、チェックアウト、注文、配送のための Google UCP 用 MCP サーバー — Universal Commerce Protocol

UCP とは？

Universal Commerce Protocol（UCP） は、エージェント型コマースのための Google のオープン標準です。画面のスクレイピングや個別のマーチャント連携を行うことなく、AI エージェントが商品を自律的に検索し、カートを作成し、チェックアウトを行い、注文を管理し、配送状況を追跡できるようにします。

UCP は、決済処理の AP2 およびエージェント間の相互運用性を実現する A2A と連携し、MCP をトランスポートレイヤーとして使用します。

クイックスタート

Claude Desktop

{
  "mcpServers": {
    "ucp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-ucp"],
      "env": {
        "UCP_API_KEY": "your-key",
        "UCP_MERCHANT_ID": "your-merchant-id"
      }
    }
  }
}

Claude Code

claude mcp add ucp -- npx @codespar/mcp-ucp

ツール（20）

ツール	目的
search_products	マーチャントの商品カタログを検索します。
get_product	価格、バリエーション、在庫状況、レビューなど、商品の詳細情報を取得します
check_availability	指定した場所への商品の在庫状況と配送可否を確認します
list_merchants	オプションのカテゴリーおよび地域フィルターを使って、UCP 対応マーチャントの一覧を取得します
create_cart	マーチャント用の新しいショッピングカートを作成します
add_to_cart	商品をショッピングカートに追加します
remove_from_cart	商品をショッピングカートから削除します
get_cart	カートの内容、商品ごとの合計、税金、送料の見積もりを取得します
clear_cart	カート内のすべての商品を削除します
get_delivery_options	カートで利用可能な配送オプションを取得します
initiate_checkout	カートのチェックアウト手続きを開始します。
apply_payment	チェックアウトセッションに決済方法を適用します。
confirm_order	注文を確定して発注します。
get_order	商品、ステータス、決済、配送情報など、注文の詳細を取得します
list_orders	オプションのフィルターを指定して注文一覧を取得します
cancel_order	保留中または確定済みの注文をキャンセルします
request_return	配達済みの注文について返品または返金を申請します
track_shipment	注文のリアルタイムな配送追跡情報を取得します
link_identity	マーチャントをまたいだパーソナライズと注文履歴のために、購入者の本人情報を連携します
get_profile	購入者のプロフィール、設定、連携済みマーチャントを取得します

UCP + AP2 + A2A — フルスタック

AI Agent
  └── MCP (tool interface)
       └── UCP (commerce: discover → cart → checkout → order → delivery)
            ├── A2A (agent-to-agent discovery & communication)
            └── AP2 (payment: authorize → execute → settle)

環境変数

変数	必須	説明
UCP_API_KEY	はい	Authorization: Bearer として送信されます
UCP_MERCHANT_ID	いいえ	X-Merchant-Id ヘッダーとして送信されます
UCP_SANDBOX	いいえ	true にすると BASE_URL が https://sandbox.commerce.googleapis.com/ucp/v1 に切り替わりますが、TLS に失敗します

リンク

• Google UCP の発表
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントによる決済にガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

認証

サーバーは、すべてのリクエストでUCP_API_KEYをAuthorization: Bearerヘッダーとして、UCP_MERCHANT_IDをX-Merchant-Idヘッダーとして送信します（src/index.ts:78-83）。

これらの認証情報を発行するポータルはありません。このREADMEが以前リンクしていた開発者ポータルdevelopers.google.com/agents/commerceは、HTTP 404を返します。

ライセンス

MIT