mcp-stripe-acp

@codespar/mcp-stripe-acp

Stripe ACP 用の MCP サーバー — AI エージェントのチェックアウト、決済の委任、商品管理のための Agentic Commerce Protocol

Stripe ACP とは？

Agentic Commerce Protocol（ACP） は、Stripe と OpenAI が共同開発したオープンスタンダードです。AI エージェントがユーザーに代わって購入を完了できるようにします。エージェントがチェックアウトの UX を処理し、販売者が在庫、価格設定、決済処理を担当します。

この MCP サーバーは、ACP プロトコルの操作（チェックアウトセッション、決済の委任）と、標準的な Stripe API の操作（顧客、商品、請求書、サブスクリプション）の両方に対応しています。

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_...",
        "STRIPE_ACP_BASE": "https://seller.example.com/acp"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_...",
        "STRIPE_ACP_BASE": "https://seller.example.com/acp"
      }
    }
  }
}

ツール（24）

Tool	Purpose
create_checkout	販売者との ACP チェックアウトセッションを作成します。
get_checkout	ステータス、価格、利用可能な決済手...など、ACP チェックアウトセッションの現在の状態を取得します。
update_checkout	ACP チェックアウトセッションを更新します。数量、配送先住所、またはフルフィルメントの選択内容を変更します
complete_checkout	決済トークンを送信して ACP チェックアウトを完了します。
cancel_checkout	ACP チェックアウトセッションをキャンセルします。
create_customer	Stripe の顧客を作成します
list_customers	オプションのフィルターを指定して Stripe の顧客を一覧表示します
create_payment_link	価格に対する共有可能な Stripe Payment Link を作成します
list_payment_intents	オプションのフィルターを指定して Stripe の Payment Intent を一覧表示します
create_refund	Stripe の Payment Intent または請求を返金します
get_balance	Stripe アカウントの残高を取得します
list_products	Stripe カタログの商品を一覧表示します
create_product	Stripe に新しい商品を作成します
list_prices	Stripe 商品の価格を一覧表示します
create_invoice	顧客向けの下書き請求書を作成します
list_subscriptions	有効な Stripe サブスクリプションを一覧表示します
create_subscription	継続課金の価格を使用して、顧客向けのサブスクリプションを作成します
cancel_subscription	Stripe サブスクリプションを即時または期間終了時にキャンセルします
create_invoice_item	次回または特定の請求書に明細項目を追加します
finalize_invoice	下書き請求書を確定し、支払い可能な状態にします
create_coupon	割引クーポンを作成します
list_disputes	決済の異議申し立て（チャージバック）を一覧表示します
create_checkout_session	Stripe Checkout Session（ホスト型決済ページ）を作成します
get_account	認証済みアカウントの Stripe アカウント情報を取得します

認証

Stripe では、シークレット API キー（または本番環境用の制限付きキー）を使用します。開発にはテストモードのキー（sk_test_...）を使用してください。

認証情報を取得する

1. Stripe Dashboard にアクセスします
2. シークレットキーをコピーします（または特定の権限を設定した制限付きキーを作成します）
3. ACP の場合：販売者の ACP エンドポイント URL を設定します
4. 環境変数を設定します

環境変数

Variable	Required	Description
STRIPE_API_KEY	はい	Stripe のシークレット API キーまたは制限付き API キー
STRIPE_ACP_BASE	いいえ	販売者の ACP エンドポイントのベース URL（ACP ツールに必要）

ACP チェックアウトのフロー

1. Agent calls create_checkout → sends items + buyer info
2. Seller returns pricing, shipping options, payment handlers
3. Agent calls update_checkout → selects shipping, updates address
4. Checkout reaches "ready_for_payment" status
5. Agent calls complete_checkout → submits payment token
6. Seller processes payment → order confirmed

ロードマップ

v0.2（予定）

• search_products — クエリでカタログを検索
• create_checkout_link — ACP チェックアウト URL を生成
• get_order_status — チェックアウト後の注文状況を追跡
• list_payment_handlers — 利用可能な決済方法を検出

v0.3（予定）

• SharedPaymentToken の作成と管理
• チェックアウト状況の更新に対応する Webhook
• 複数販売者のチェックアウトのオーケストレーション

貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

• ACP 仕様
• ACP GitHub
• Stripe Agent Toolkit
• Stripe API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT