mcp-stripe

@codespar/mcp-stripe

Stripe 用 MCP サーバー — 決済 API の世界標準

Stripe と Stripe ACP の違い

CodeSpar カタログには 2 つの Stripe MCP サーバーがあります。それぞれ異なる製品です。

パッケージ	対応する API	使用する場面
@codespar/mcp-stripe （このパッケージ）	Stripe の通常の決済 API（PaymentIntents、Checkout、Billing）	現在すでに Stripe で決済を受け付けている場合。Stripe を標準採用するラテンアメリカの SaaS 企業の 99％が該当します。
@codespar/mcp-stripe-acp	Stripe の Agentic Commerce Protocol	Stripe の新しいエージェントネイティブなチェックアウト仕様に基づいて開発する場合。対象範囲がかなり狭く、最先端の製品です。

Stripe を PSP として利用している一般的な SaaS なら、こちらのパッケージをお使いください。

CodeSpar カタログに Stripe を追加する理由

Stripe は、開発者を第一に考えた決済サービスの世界標準です。海外発行のカードで請求するラテンアメリカの SaaS のほぼすべてが Stripe を採用しています。Truora、Platzi、Rappi Pay（一部のフロー）、Y Combinator に参加する数多くのラテンアメリカ企業がその例です。Stripe を追加することで、ローカルファーストの決済ゲートウェイへの移行を強いることなく、エージェントがそうした SaaS ですでに稼働している決済スタックを操作できます。

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します。

{
  "servers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

ツール（30）

ツール	用途
create_payment_intent	PaymentIntent を作成します。顧客への請求に使う Stripe の最新の基本機能です。
confirm_payment_intent	confirm=false で作成した PaymentIntent を確定します。
retrieve_payment_intent	ID で PaymentIntent を取得します。
cancel_payment_intent	PaymentIntent をキャンセルします。
list_payment_intents	PaymentIntent の一覧を取得します。
create_refund	請求または PaymentIntent の返金を作成します。
list_refunds	返金の一覧を取得します。
create_customer	Stripe の Customer を作成します。
retrieve_customer	ID で Customer を取得します。
update_customer	Customer を更新します。
create_product	Product を作成します。Price が参照するカタログ項目です。
list_products	Product の一覧を取得します。
create_price	Product に紐付けた Price を作成します。
list_prices	Price の一覧を取得します。
create_subscription	既存の顧客に対する Subscription を作成します。
update_subscription	Subscription を更新します。
cancel_subscription	Subscription をキャンセルします。
list_subscriptions	Subscription の一覧を取得します。
create_checkout_session	ホスト型の Checkout Session を作成します。
create_payment_link	価格または複数の明細項目に対して請求する、長期間有効な Payment Link（共有可能な URL）を作成します。
list_payment_links	Payment Link の一覧を取得します。
create_invoice	顧客向けの Invoice の下書きを作成します。
list_invoices	Invoice の一覧を取得します。
finalize_invoice	Invoice の下書きを確定します。
send_invoice	確定済みの Invoice をメールで顧客に送信します。
pay_invoice	未払いの Invoice に対する決済の回収を試みます。
void_invoice	確定済みの Invoice を無効化します。
update_dispute	Dispute に関する証拠を提出します。
list_disputes	Dispute の一覧を取得します。
retrieve_balance	現在の Stripe アカウント残高を取得します。利用可能額、保留額、connect_reserved の資金が内訳ごとに表示されます。

認証

Stripe では、単一のシークレットキーを使用します。キーのプレフィックスで環境が決まります。

• sk_test_... → テストモード（実際のお金は動きません）
• sk_live_... → ライブモード

個別のベース URL はありません。キー自体がリクエストの送信先を決定します。STRIPE_SECRET_KEY を設定すれば準備完了です。

リクエストボディには、ブラケット記法（customer[name]=Foo、metadata[order]=123、expand[]=latest_invoice）を使う application/x-www-form-urlencoded 形式を使用します。このサーバーがネストされたオブジェクトや配列を処理します。

API バージョンの固定

Stripe は、カレンダーに基づくサイクルで互換性を損なう変更を自動的に適用します。エージェントに表示されるバージョンを固定する場合は、STRIPE_API_VERSION を設定してください（例：2024-06-20）。サーバーはすべての呼び出しで、Stripe-Version ヘッダーとしてこの値を渡します。

環境変数

変数	必須	説明
STRIPE_SECRET_KEY	はい	Stripe Dashboard > Developers > API keys で取得した sk_test_... または sk_live_...
STRIPE_API_VERSION	いいえ	Stripe-Version ヘッダーで API バージョンを固定します（例：2024-06-20）

サンドボックス／テスト

Stripe アカウントにはテストモードが組み込まれているため、別途登録する必要はありません。sk_test_... キーと、Stripe のテストカード（例：4242 4242 4242 4242）を使用してください。

認証情報を取得する

1. stripe.com で登録します
2. Dashboard > Developers > API keys に移動します
3. Secret key をコピーします（デフォルトではテストモードです）
4. STRIPE_SECRET_KEY を設定します

ロードマップ

v0.2（予定）

• update_payment_intent、capture_payment_intent（キャプチャを別途実行）
• retrieve_refund、list_refunds
• list_customers、search_customers
• update_subscription、retrieve_subscription
• retrieve_invoice、finalize_invoice、pay_invoice、send_invoice、void_invoice
• create_invoice_item、list_invoice_items
• create_price、create_product
• list_charges、retrieve_charge
• retrieve_dispute、close_dispute、list_disputes

v0.3（予定）

• Stripe Connect：アカウント、アカウントリンク、送金、入金
• create_setup_intent、confirm_setup_intent（後で使用するカードの保存）
• PaymentMethod の紐付け／解除／一覧表示
• Webhook イベントの構築ヘルパー

ツールの提供を早めに希望しますか？Issue または PR を作成してください。

リンク

• Stripe のウェブサイト
• Stripe API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントが開始した請求、返金、サブスクリプション変更に対するガバナンス、支出上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT