mcp-coinbase-commerce について
mcp-coinbase-commerce は Coinbase Commerce 向けの MCP サーバーで、加盟店が暗号資産による支払いを受け付けられるようにします。価格は現地通貨で設定し、買い手は BTC、ETH、USDC などで決済します。チャージ、請求書、チェックアウトページをエージェントから作成したい加盟店や開発者に適しています。
主な機能
- 01法定通貨建ての暗号資産チャージの作成
- 02再利用可能なホスト型チェックアウトページ
- 03指定した受取人宛ての請求書
- 04為替レートとイベントの取得
- 05Webhook 署名のローカル検証
活用シーン
- 01エージェントによる買い手向けの暗号資産支払いリンクの生成
- 02商品ごとのチェックアウトページの管理
- 03チャージの状態追跡と Webhook イベントの確認
MCP 対応
チャージ、チェックアウト、請求書、イベント、為替レートに関する 18 の操作を MCP ツールとして公開し、MCP クライアントから呼び出せるようにします。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @codespar/mcp-coinbase-commerceCOINBASE_COMMERCE_API_KEYシークレットCoinbase Commerce API key. Create one at https://beta.commerce.coinbase.com/settings/security.COINBASE_COMMERCE_API_VERSIONCoinbase Commerce API version pin (X-CC-Version header). Defaults to 2018-03-22.COINBASE_COMMERCE_WEBHOOK_SECRETシークレットShared secret used to verify X-CC-Webhook-Signature on incoming webhooks. Only required for the verify_webhook_signature tool.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
18掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| name | string | はい | ホスト型決済ページに表示する短い商品/注文名 |
| metadata | object | いいえ | イベントでそのまま返してほしい任意の JSON(customer_id、order_id など) |
| cancel_url | string | いいえ | 購入者がホスト型ページを離脱した場合のブラウザーリダイレクト先 |
| description | string | はい | 購入者が支払う内容についての、より詳しい読みやすい説明 |
| local_price | object | いいえ | 請求額の提示に使用する法定通貨建ての価格です。pricing_type が fixed_price の場合は必須です。 |
| local_price.amount | string | はい | 10進数文字列で表した金額(例:"29.90") |
| local_price.currency | string | はい | ISO-4217の法定通貨コード(例:USD、BRL、EUR、MXN) |
| pricing_type | enum | はい | fixed_price:local_price の金額で固定します。no_price:購入者が金額を選択します(寄付)。fixed_price | no_price |
| redirect_url | string | いいえ | 決済成功後のブラウザーリダイレクト先 |
詳細
@codespar/mcp-coinbase-commerce
Coinbase Commerce 用 MCP サーバー — 世界中の加盟店向け暗号資産決済。
Coinbase Commerce は、暗号資産を「加盟店が受け付ける」ためのサービスです。店舗は注文価格を現地の法定通貨(USD、BRL、EUR、MXN、…)で設定し、購入者は BTC/ETH/USDC などの対応資産で支払い、Coinbase が希望する暗号資産または法定通貨で加盟店に精算します。
カタログ内の他サービスとの位置付け
| サーバー | ユースケース | 方向 |
|---|---|---|
@codespar/mcp-coinbase-commerce | 加盟店がチェックアウトで暗号資産を受け付ける | 購入者から加盟店への支払い |
@codespar/mcp-unblockpay | BRL/MXN <-> USDC の決済経路 | 価値の移転 |
@codespar/mcp-moonpay | エンドユーザーの法定通貨 <-> 暗号資産(100 以上の資産) | オンランプ/オフランプ |
@codespar/mcp-transak | エンドユーザーの法定通貨 <-> 暗号資産(幅広い地域に対応) | オンランプ/オフランプ |
エージェントが購入者に暗号資産で請求する必要がある場合は、Coinbase Commerce を使用してください — ホスト型の請求ページ、再利用可能なチェックアウト、または宛先指定の請求書に対応しています。
ツール(18)
| ツール | 目的 |
|---|---|
create_charge | 暗号資産の請求を作成 — 現地の法定通貨で価格を設定し、購入者が BTC、E... で支払える一回限りの加盟店向け請求書。 |
retrieve_charge | Coinbase Commerce の ID または短縮コード(ホスト型の請求に埋め込まれた 8 文字のコード)で請求を取得。 |
list_charges | 請求を新しい順に一覧表示。 |
cancel_charge | まだ支払われていない請求をキャンセル。 |
resolve_charge | 請求を支払い済みとして手動で確定。 |
create_checkout | 再利用可能なホスト型チェックアウトを作成 — 商品ページのようなリンクで、複数回の支払いに対応します。 |
retrieve_checkout | ID でチェックアウトを取得。 |
list_checkouts | 再利用可能なホスト型チェックアウトを新しい順に一覧表示。 |
update_checkout | 既存の再利用可能なチェックアウトを更新。 |
delete_checkout | 再利用可能なチェックアウトを削除。 |
list_events | イベントを一覧表示 — ライフサイクルの通知(charge:created、charge:confirmed、charge:failed、charge:delayed、charg...) |
retrieve_event | ID で単一のイベントを取得。 |
create_invoice | 請求書を作成 — 指定した名前の宛先に送信する請求書。 |
retrieve_invoice | コードで請求書を取得。 |
list_invoices | 請求書を新しい順に一覧表示。 |
void_invoice | 未払いの請求書を無効化。 |
list_exchange_rates | 基準資産(例:)の Coinbase 為替レートを取得。 |
verify_webhook_signature | ローカルヘルパー — HMAC-SHA256 を使って Coinbase Commerce の Webhook ペイロードを検証。 |
インストール
npm install @codespar/mcp-coinbase-commerce
環境変数
COINBASE_COMMERCE_API_KEY="..." # API key (required, secret)
COINBASE_COMMERCE_API_VERSION="..." # Optional. Defaults to 2018-03-22.
https://beta.commerce.coinbase.com/settings/security で API キーを作成してください。
認証
すべてのリクエストには 2 つのヘッダーが含まれます。
X-CC-Api-Key: <COINBASE_COMMERCE_API_KEY>
X-CC-Version: 2018-03-22
バージョンヘッダーは必須です。将来の API 変更によって連携が予期せず壊れないよう、バージョンを固定してください。
実行
# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-coinbase-commerce
# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-coinbase-commerce
エンタープライズ
エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか? CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。