mcpField
M
mcp-coinbase-commerce

mcp-coinbase-commerce

ローカル
github.com/codespar金融データ2754 週間前に更新

mcp-coinbase-commerce について

mcp-coinbase-commerce は Coinbase Commerce 向けの MCP サーバーで、加盟店が暗号資産による支払いを受け付けられるようにします。価格は現地通貨で設定し、買い手は BTC、ETH、USDC などで決済します。チャージ、請求書、チェックアウトページをエージェントから作成したい加盟店や開発者に適しています。

主な機能

  1. 01法定通貨建ての暗号資産チャージの作成
  2. 02再利用可能なホスト型チェックアウトページ
  3. 03指定した受取人宛ての請求書
  4. 04為替レートとイベントの取得
  5. 05Webhook 署名のローカル検証

活用シーン

  1. 01エージェントによる買い手向けの暗号資産支払いリンクの生成
  2. 02商品ごとのチェックアウトページの管理
  3. 03チャージの状態追跡と Webhook イベントの確認

MCP 対応

チャージ、チェックアウト、請求書、イベント、為替レートに関する 18 の操作を MCP ツールとして公開し、MCP クライアントから呼び出せるようにします。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"codespar-mcp-coinbase-commerce": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-coinbase-commerce"
],
"env": {
"COINBASE_COMMERCE_API_KEY": "<COINBASE_COMMERCE_API_KEY>",
"COINBASE_COMMERCE_API_VERSION": "<COINBASE_COMMERCE_API_VERSION>",
"COINBASE_COMMERCE_WEBHOOK_SECRET": "<COINBASE_COMMERCE_WEBHOOK_SECRET>"
}
}
}
}
起動コマンドnpx -y @codespar/mcp-coinbase-commerce
設定が必要な環境変数
COINBASE_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 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-coinbase-commerce0.2.2

ツール

18

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
namestringはいホスト型決済ページに表示する短い商品/注文名
metadataobjectいいえイベントでそのまま返してほしい任意の JSON(customer_id、order_id など)
cancel_urlstringいいえ購入者がホスト型ページを離脱した場合のブラウザーリダイレクト先
descriptionstringはい購入者が支払う内容についての、より詳しい読みやすい説明
local_priceobjectいいえ請求額の提示に使用する法定通貨建ての価格です。pricing_type が fixed_price の場合は必須です。
local_price.amountstringはい10進数文字列で表した金額(例:"29.90")
local_price.currencystringはいISO-4217の法定通貨コード(例:USD、BRL、EUR、MXN)
pricing_typeenumはいfixed_price:local_price の金額で固定します。no_price:購入者が金額を選択します(寄付)。fixed_price | no_price
redirect_urlstringいいえ決済成功後のブラウザーリダイレクト先

詳細

@codespar/mcp-coinbase-commerce

Coinbase Commerce 用 MCP サーバー — 世界中の加盟店向け暗号資産決済。

Coinbase Commerce は、暗号資産を「加盟店が受け付ける」ためのサービスです。店舗は注文価格を現地の法定通貨(USD、BRL、EUR、MXN、…)で設定し、購入者は BTC/ETH/USDC などの対応資産で支払い、Coinbase が希望する暗号資産または法定通貨で加盟店に精算します。

カタログ内の他サービスとの位置付け

サーバーユースケース方向
@codespar/mcp-coinbase-commerce加盟店がチェックアウトで暗号資産を受け付ける購入者から加盟店への支払い
@codespar/mcp-unblockpayBRL/MXN <-> USDC の決済経路価値の移転
@codespar/mcp-moonpayエンドユーザーの法定通貨 <-> 暗号資産(100 以上の資産)オンランプ/オフランプ
@codespar/mcp-transakエンドユーザーの法定通貨 <-> 暗号資産(幅広い地域に対応)オンランプ/オフランプ

エージェントが購入者に暗号資産で請求する必要がある場合は、Coinbase Commerce を使用してください — ホスト型の請求ページ、再利用可能なチェックアウト、または宛先指定の請求書に対応しています。

ツール(18)

ツール目的
create_charge暗号資産の請求を作成 — 現地の法定通貨で価格を設定し、購入者が BTC、E... で支払える一回限りの加盟店向け請求書。
retrieve_chargeCoinbase Commerce の ID または短縮コード(ホスト型の請求に埋め込まれた 8 文字のコード)で請求を取得。
list_charges請求を新しい順に一覧表示。
cancel_chargeまだ支払われていない請求をキャンセル。
resolve_charge請求を支払い済みとして手動で確定。
create_checkout再利用可能なホスト型チェックアウトを作成 — 商品ページのようなリンクで、複数回の支払いに対応します。
retrieve_checkoutID でチェックアウトを取得。
list_checkouts再利用可能なホスト型チェックアウトを新しい順に一覧表示。
update_checkout既存の再利用可能なチェックアウトを更新。
delete_checkout再利用可能なチェックアウトを削除。
list_eventsイベントを一覧表示 — ライフサイクルの通知(charge:created、charge:confirmed、charge:failed、charge:delayed、charg...)
retrieve_eventID で単一のイベントを取得。
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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。