# Model Context Protocol (MCP) AI エージェントを Stripe API と対話させるには、当社の MCP サーバーを使用します。 Stripe Model Context Protocol (MCP) サーバーは、AI エージェントが Stripe API と対話し、Stripe のナレッジベース (ドキュメントやサポート記事を含む) を検索するために使用できる一連のツールを提供します。 このページでは、エージェントまたは IDE を Stripe の MCP サーバーに接続する方法について説明します。独自の MCP アプリやチャットインターフェイスを構築しており、ユーザーからの決済を受け付ける場合は、代わりに [MCP アプリの収益化](https://docs.stripe.com/agentic-commerce/apps.md) を参照してください。 ## Connect to Stripe’s MCP server #### Cursor [Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJ1cmwiOiJodHRwczovL21jcC5zdHJpcGUuY29tIn0%3D) To open Cursor and automatically add the Stripe MCP server, click **Install**. Alternatively, add the following to your `~/.cursor/mcp.json` file. To learn more, see the Cursor [documentation](https://docs.cursor.com/context/model-context-protocol). ```json { "mcpServers": { "stripe": { "url": "https://mcp.stripe.com" } } } ``` #### Claude Code To add MCP to Claude code, run the following command. To learn more, see the Claude Code [documentation](https://docs.anthropic.com/en/docs/claude-code/mcp#configure-mcp-servers). ```bash claude mcp add --transport http stripe https://mcp.stripe.com/ ``` After adding the server to Claude, you must authenticate with Stripe. ```bash claude /mcp ``` #### ChatGPT You can enable MCP servers on ChatGPT if you have a Pro, Plus, Business, Enterprise or Education account. Follow the [OpenAI documentation](https://platform.openai.com/docs/guides/developer-mode) for instructions. Use the following parameters when setting up your custom connector: - The server url is `https://mcp.stripe.com`. - Use “OAuth” as the connection mechanism. Stripe’s MCP server also works with OpenAI’s response API, when building [autonomous agents](https://docs.stripe.com/mcp.md#agents). #### Other ### VS Code [Install in VS Code](https://vscode.dev/redirect/mcp/install?name=stripe&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.stripe.com%22%7D) To open VS Code and automatically add the Stripe MCP server, click **Install**. Alternatively, add the following to your workspace `.vscode/mcp.json` file. To learn more, see the VS Code [documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers). ```json { "servers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com" } } } ``` ### Custom MCP is an open protocol that many clients support. Your client documentation can explain how to connect. If possible, use the server URL `https://mcp.stripe.com` and OAuth as the connection mechanism. If your MCP client doesn’t support OAuth, you can pass a [restricted API key](https://docs.stripe.com/keys.md#create-restricted-api-key) in the `Authorization` header as a bearer token. For example, a client might accept the following header property: ```json { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer <>" } } } ``` After installing, you can manage MCP client sessions in your Dashboard settings. ### Manage MCP client sessions The Stripe MCP server uses OAuth to connect MCP clients according to the [MCP spec](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#2-1-1-oauth-grant-types). OAuth is more secure than using your secret key because it allows more granular permissions and user based authorization. When you add the Stripe MCP to a client, the MCP client opens an OAuth consent form which allows you to authorize the client to access your Stripe data. #### Manage your own sessions To view authorized OAuth client sessions, go to your [user settings](https://dashboard.stripe.com/settings/user) in the Stripe Dashboard. If you’ve authorized an MCP client, it appears under **OAuth sessions**. To revoke OAuth access for a specific MCP client session: 1. Scroll to the OAuth sessions section in your [user settings](https://dashboard.stripe.com/settings/user). 2. Find the client sessions in the list, and click the overflow menu (⋯). 3. Select **Revoke access**. #### Manage sessions as an admin If you’re an administrator, you can view and revoke the MCP OAuth sessions of other users in your organization or account. This requires a role with permission to manage team members and OAuth sessions (for example, the **Administrator** role). To manage another user’s sessions: 1. Go to the [Team and security](https://dashboard.stripe.com/settings/team) settings page and select the team member you want to manage. 2. On the team member details page, find the **OAuth sessions** table. 3. To revoke a single session, click the overflow menu on its row and select **Revoke access**. To revoke every session in the table, select **Revoke all**. Session management is scoped to the account or organization you’re currently viewing and to the current environment, live mode or a sandbox. Revoking a session only removes access for the accounts in your current scope. If the same session also has access to accounts outside your scope, it stays active for those accounts. When you view an organization, the table includes an **Accounts** column because a session can be tied to more than one account in the organization. ### Manage MCP access Administrators can [enable MCP access](https://dashboard.stripe.com/settings/mcp) in the Dashboard. Access is managed separately between sandbox and live mode environments. ### Building autonomous agents If you’re building agentic software, you can pass a Stripe API key as a bearer token to the MCP remote server. We strongly recommend using [restricted API keys](https://docs.stripe.com/keys/restricted-api-keys.md) to limit your agent’s access to exactly the functionality it requires. For example, you can use this authorization method with [OpenAI’s Responses API](https://platform.openai.com/docs/guides/tools-remote-mcp#authentication). Don’t embed restricted or secret API keys in code. Instead, provide API keys to your agent through a secrets vault or environment variable. To learn how to manage keys safely, see [best practices for managing secret API keys](https://docs.stripe.com/keys-best-practices.md). ```bash curl https://mcp.stripe.com/ \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <>" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "create_customer", "arguments": {"name": "Jenny Rosen", "email": "jenny.rosen@example.com" } }, "id": 1 }' ``` ## ツール サーバーは以下の[MCP ツール](https://modelcontextprotocol.io/docs/concepts/tools)を公開しています。プロンプトインジェクション攻撃を回避するために、ツールの手動確認を有効にし、他のサーバーで Stripe MCP を使用する際には注意を払うことをお勧めします。フィードバックがある場合や、その他のツールをご希望の場合は、[mcp@stripe.com](mailto:mcp@stripe.com) までメールでご連絡ください。 | リソース | ツール | 説明 | | --- | --- | --- | | **API ツール** | `stripe_api_search` | キーワードで Stripe API メソッドを検索します | | `stripe_api_details` | 特定の Stripe API メソッドのパラメーターの詳細情報を取得します。 | | `stripe_api_read` | 任意の Stripe API `GET` メソッドでデータを読み取ります | | `stripe_api_write` | 任意の Stripe API `POST`、`PATCH`、`PUT`、および `DELETE` メソッドでデータを書き込みます | | **口座** | `get_stripe_account_info` | [アカウントの取得](https://docs.stripe.com/api/accounts/retrieve.md) | | **返金** | `create_refund` | [返金する](https://docs.stripe.com/api/refunds/create.md) | | **Treasury** (Public preview) | `get_balance_summary` | Stripe 残高と Treasury アカウント全体のインタラクティブな残高サマリーを表示 | | **その他** | `search_stripe_documentation` | 指定された質問と言語について Stripe ドキュメントを検索します | | `stripe_implementation_planner` | Stripe 製品を案内し、決済の受け付け、オンラインでの商品の販売、請求の設定、または任意の Stripe 実装の構築を支援します | | `send_stripe_mcp_feedback` | Stripe の MCP サーバーツールに関するユーザーまたはエージェントからのフィードバックを送信します | | `stripe_report` | レポートとレポート実行を検索、取得、作成します | Stripe MCP サーバーは、`stripe_api_read` および `stripe_api_write` ツールで呼び出すことができる複数の API を公開しています。このアクセスにより、コンテキストウィンドウを不必要に増やすことなく、API の大部分を MCP を通じて利用できるようになります。 ### サポートされている API メソッド - [すべての顧客をリスト](https://docs.stripe.com/api/customers/list.md) - [顧客を取得](https://docs.stripe.com/api/customers/retrieve.md) - [顧客の作成](https://docs.stripe.com/api/customers/create.md) - [顧客を更新](https://docs.stripe.com/api/customers/update.md) - [すべての支払い (Charge) をリスト](https://docs.stripe.com/api/charges/list.md) - [支払い (Charge) を取得](https://docs.stripe.com/api/charges/retrieve.md) - [チャージのすべての返金一覧を取得 (`GET /v1/charges/:charge/refunds`)](https://docs.stripe.com/api/refunds/list.md) - [すべての返金をリスト](https://docs.stripe.com/api/refunds/list.md) - [返金を取得](https://docs.stripe.com/api/refunds/retrieve.md) - [返金する](https://docs.stripe.com/api/refunds/create.md) - [すべての PaymentIntent をリスト](https://docs.stripe.com/api/payment_intents/list.md) - [PaymentIntent を取得](https://docs.stripe.com/api/payment_intents/retrieve.md) - [すべての Checkout Sessions をリスト](https://docs.stripe.com/api/checkout/sessions/list.md) - [Checkout Session を取得](https://docs.stripe.com/api/checkout/sessions/retrieve.md) - [Checkout セッションの項目を取得](https://docs.stripe.com/api/checkout/sessions/line_items.md) - [すべての請求書をリスト](https://docs.stripe.com/api/invoices/list.md) - [請求書を取得](https://docs.stripe.com/api/invoices/retrieve.md) - [請求書の項目を取得](https://docs.stripe.com/api/invoice-line-item/retrieve.md) - [請求書の作成](https://docs.stripe.com/api/invoices/create.md) - [請求書を更新](https://docs.stripe.com/api/invoices/update.md) - [請求書を確定](https://docs.stripe.com/api/invoices/finalize.md) - [請求書を回収不能とマーク](https://docs.stripe.com/api/invoices/mark_uncollectible.md) - [請求書を無効にする](https://docs.stripe.com/api/invoices/void.md) - [すべての請求書項目の一覧を取得](https://docs.stripe.com/api/invoiceitems/list.md) - [請求書項目を取得](https://docs.stripe.com/api/invoiceitems/retrieve.md) - [請求書項目を作成](https://docs.stripe.com/api/invoiceitems/create.md) - [請求書項目を更新](https://docs.stripe.com/api/invoiceitems/update.md) - [請求書のすべての支払い一覧を取得](https://docs.stripe.com/api/invoice-payment/list.md) - [サブスクリプションをリスト](https://docs.stripe.com/api/subscriptions/list.md) - [サブスクを取得](https://docs.stripe.com/api/subscriptions/retrieve.md) - [サブスクの作成](https://docs.stripe.com/api/subscriptions/create.md) - [サブスクの更新](https://docs.stripe.com/api/subscriptions/update.md) - [サブスクのキャンセル](https://docs.stripe.com/api/subscriptions/cancel.md) - [すべてのスケジュールの一覧を取得](https://docs.stripe.com/api/subscription_schedules/list.md) - [スケジュールを取得](https://docs.stripe.com/api/subscription_schedules/retrieve.md) - [すべてのサブスク項目の一覧を取得](https://docs.stripe.com/api/subscription_items/list.md) - [すべてのクーポンをリスト](https://docs.stripe.com/api/coupons/list.md) - [クーポンを取得](https://docs.stripe.com/api/coupons/retrieve.md) - [クーポンの作成](https://docs.stripe.com/api/coupons/create.md) - [クーポンの更新](https://docs.stripe.com/api/coupons/update.md) - [クーポンの削除](https://docs.stripe.com/api/coupons/delete.md) - [すべてのプロモーションコードをリスト](https://docs.stripe.com/api/promotion_codes/list.md) - [プロモーションコードを取得](https://docs.stripe.com/api/promotion_codes/retrieve.md) - [プロモーションコードの作成](https://docs.stripe.com/api/promotion_codes/create.md) - [すべての商品をリスト](https://docs.stripe.com/api/products/list.md) - [商品を取得](https://docs.stripe.com/api/products/retrieve.md) - [商品の作成](https://docs.stripe.com/api/products/create.md) - [商品の更新](https://docs.stripe.com/api/products/update.md) - [すべての価格をリスト](https://docs.stripe.com/api/prices/list.md) - [価格を取得](https://docs.stripe.com/api/prices/retrieve.md) - [価格を作成](https://docs.stripe.com/api/prices/create.md) - [価格の更新](https://docs.stripe.com/api/prices/update.md) - [すべての決済用リンクをリスト](https://docs.stripe.com/api/payment_links/list.md) - [決済用リンクを取得](https://docs.stripe.com/api/payment_links/retrieve.md) - [決済用リンクの項目を取得](https://docs.stripe.com/api/payment_links/line_items.md) - [決済用リンクを作成](https://docs.stripe.com/api/payment_links/create.md) - [決済用リンクを更新](https://docs.stripe.com/api/payment_links/update.md) - [すべての不審請求の申し立てをリスト](https://docs.stripe.com/api/disputes/list.md) - [不審請求の申し立てを取得](https://docs.stripe.com/api/disputes/retrieve.md) - [不審請求の申し立てを更新](https://docs.stripe.com/api/disputes/update.md) - [すべての Webhook エンドポイントの一覧表示](https://docs.stripe.com/api/webhook_endpoints/list.md) - [Webhook エンドポイントの取得](https://docs.stripe.com/api/webhook_endpoints/retrieve.md) - [Webhook エンドポイントの作成](https://docs.stripe.com/api/webhook_endpoints/create.md) - [ポータルの設定の一覧を取得](https://docs.stripe.com/api/customer_portal/configurations/list.md) - [ポータルの設定を取得](https://docs.stripe.com/api/customer_portal/configurations/retrieve.md) - [残高を取得](https://docs.stripe.com/api/balance/retrieve.md) - [税金設定を取得](https://docs.stripe.com/api/tax/settings/retrieve.md) - [税金設定を更新](https://docs.stripe.com/api/tax/settings/update.md) - [すべての税コードを一覧表示](https://docs.stripe.com/api/tax_codes/list.md) - [税コードを取得](https://docs.stripe.com/api/tax_codes/retrieve.md) - [すべての税務登録の一覧表示](https://docs.stripe.com/api/tax/registrations/list.md) - [税務登録の取得](https://docs.stripe.com/api/tax/registrations/retrieve.md) - [税務登録の作成](https://docs.stripe.com/api/tax/registrations/create.md) - [すべての取引残高をリスト](https://docs.stripe.com/api/balance_transactions/list.md) - [取引残高を取得](https://docs.stripe.com/api/balance_transactions/retrieve.md) - [すべての入金をリスト](https://docs.stripe.com/api/payouts/list.md) - [入金を取得](https://docs.stripe.com/api/payouts/retrieve.md) - [すべてのオーソリをリスト](https://docs.stripe.com/api/issuing/authorizations/list.md) - [オーソリを取得](https://docs.stripe.com/api/issuing/authorizations/retrieve.md) - [すべてのカード会員をリスト](https://docs.stripe.com/api/issuing/cardholders/list.md) - [カード会員を取得](https://docs.stripe.com/api/issuing/cardholders/retrieve.md) - [すべてのカードをリスト](https://docs.stripe.com/api/issuing/cards/list.md) - [カードを取得](https://docs.stripe.com/api/issuing/cards/retrieve.md) - [すべての不審請求の申し立てをリスト](https://docs.stripe.com/api/issuing/disputes/list.md) - [不審請求の申し立てを取得](https://docs.stripe.com/api/issuing/disputes/retrieve.md) - [すべての取引をリスト](https://docs.stripe.com/api/issuing/transactions/list.md) - [取引を取得](https://docs.stripe.com/api/issuing/transactions/retrieve.md) - [アカウントをリスト](https://docs.stripe.com/api/v2/core/accounts/list.md) - [アカウントを取得](https://docs.stripe.com/api/v2/core/accounts/retrieve.md) - [調整をリスト](https://docs.stripe.com/api/v2/money-management/adjustments/list.md?api-version=2026-05-27.preview) - [調整を取得](https://docs.stripe.com/api/v2/money-management/adjustments/retrieve.md?api-version=2026-05-27.preview) - [金融アカウントをリスト](https://docs.stripe.com/api/v2/money-management/financial-accounts/list.md?api-version=2026-05-27.preview) - [金融アカウントを取得](https://docs.stripe.com/api/v2/money-management/financial-accounts/retrieve.md?api-version=2026-05-27.preview) - [金融アドレスをリスト](https://docs.stripe.com/api/v2/money-management/financial-addresses/list.md?api-version=2026-05-27.preview) - [金融アドレスを取得](https://docs.stripe.com/api/v2/money-management/financial-addresses/retrieve.md?api-version=2026-05-27.preview) - [インバウンド送金をリスト](https://docs.stripe.com/api/v2/money-management/inbound-transfers/list.md?api-version=2026-05-27.preview) - [インバウンド送金を取得](https://docs.stripe.com/api/v2/money-management/inbound-transfers/retrieve.md?api-version=2026-05-27.preview) - [アウトバウンド決済の見積もりを取得](https://docs.stripe.com/api/v2/money-management/outbound-payment-quotes/retrieve.md?api-version=2026-05-27.preview) - [アウトバウンド決済をリスト](https://docs.stripe.com/api/v2/money-management/outbound-payments/list.md?api-version=2026-05-27.preview) - [アウトバウンド決済を取得](https://docs.stripe.com/api/v2/money-management/outbound-payments/retrieve.md?api-version=2026-05-27.preview) - [アウトバウンド Setup Intent をリスト](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/list.md?api-version=2026-05-27.preview) - [アウトバウンド Setup Intent を取得](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/retrieve.md?api-version=2026-05-27.preview) - [アウトバウンド送金をリスト](https://docs.stripe.com/api/v2/money-management/outbound-transfers/list.md?api-version=2026-05-27.preview) - [アウトバウンド送金を取得](https://docs.stripe.com/api/v2/money-management/outbound-transfers/retrieve.md?api-version=2026-05-27.preview) - [入金手段をリスト](https://docs.stripe.com/api/v2/money-management/payout-methods/list.md?api-version=2026-05-27.preview) - [入金手段を取得](https://docs.stripe.com/api/v2/money-management/payout-methods/retrieve.md?api-version=2026-05-27.preview) - [銀行口座の仕様を取得](https://docs.stripe.com/api/v2/money-management/payout-methods-bank-account-specs/retrieve.md?api-version=2026-05-27.preview) - [受け取ったクレジットをリスト](https://docs.stripe.com/api/v2/money-management/received-credits/list.md?api-version=2026-05-27.preview) - [受け取ったクレジットを取得](https://docs.stripe.com/api/v2/money-management/received-credits/retrieve.md?api-version=2026-05-27.preview) - [受け取ったデビットをリスト](https://docs.stripe.com/api/v2/money-management/received-debits/list.md?api-version=2026-05-27.preview) - [受け取ったデビットを取得](https://docs.stripe.com/api/v2/money-management/received-debits/retrieve.md?api-version=2026-05-27.preview) - [取引エントリをリスト](https://docs.stripe.com/api/v2/money-management/transaction-entries/list.md?api-version=2026-05-27.preview) - [取引エントリを取得](https://docs.stripe.com/api/v2/money-management/transaction-entries/retrieve.md?api-version=2026-05-27.preview) - [取引をリスト](https://docs.stripe.com/api/v2/money-management/transactions/list.md?api-version=2026-05-27.preview) - [取引を取得](https://docs.stripe.com/api/v2/money-management/transactions/retrieve.md?api-version=2026-05-27.preview) ## 連結アカウントのサポート Connect プラットフォームは、連結アカウントとして MCP コールを実行できます。ただし、OAuth は使用できません。代わりに、適切な Connect 権限を持つ[制限付きアクセスキー](https://docs.stripe.com/keys/restricted-api-keys.md#create-a-restricted-api-key)を使用してください。 連結アカウントとして MCP コールを実行するには、`Stripe-Account` ヘッダーを渡します。これは、連結アカウントがプラットフォームを介して MCP コールを実行できるようにするエージェントを提供する場合に便利です。 ```json { "mcpServers": { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer rk_.....", "Stripe-Account": "acct_xxxxxxxxx" } } } } ``` ## See also - [AI を活用して Stripe 上に構築](https://docs.stripe.com/agents.md) - [Stripe スキル](https://docs.stripe.com/skills.md)