# Model Context Protocol (MCP) AI エージェントを Stripe API と対話させるには、当社の MCP サーバーを使用します。 Stripe Model Context Protocol (MCP) サーバーは、AI エージェントが Stripe API と対話し、Stripe のナレッジベース (ドキュメントやサポート記事を含む) を検索するために使用できる一連のツールを提供します。 ## Stripe の MCP サーバーに接続する #### Cursor [Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJ1cmwiOiJodHRwczovL21jcC5zdHJpcGUuY29tIn0%3D) Cursor を開いて Stripe MCP を自動的に追加するには、インストールをクリックします。または、`~/.cursor/mcp.json` ファイルに以下を追加します。詳細は、Cursor の[ドキュメント](https://docs.cursor.com/context/model-context-protocol)を参照してください。 ```json { "mcpServers": {"stripe": { "url": "https://mcp.stripe.com" } } } ``` #### 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) VS Codeを開いて Stripe MCPを自動的に追加するには、インストールをクリックします。または、ワークスペースの`.vscode/mcp.json`ファイルに以下を追加します。詳細は、VS Code の[ドキュメント](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)をご覧ください。 ```json { "servers": {"stripe": { "type": "http", "url": "https://mcp.stripe.com" } } } ``` #### クロード・コード Claude コードに MCP を追加するには、次のコマンドを実行します。詳細については、Claude コードの[ドキュメント](https://docs.anthropic.com/en/docs/claude-code/mcp#configure-mcp-servers)を参照してください。 ```bash claude mcp add --transport http stripe https://mcp.stripe.com/ ``` サーバーを Claude に追加したら、Stripe で認証してください。 ```bash claude /mcp ``` #### ChatGPT Pro、Plus、Business、Enterprise、または Education のアカウントをお持ちの場合は、ChatGPT で MCP サーバーを有効にできます。手順については、[OpenAI ドキュメント](https://platform.openai.com/docs/guides/developer-mode)に従ってください。カスタムコネクタを設定する際には、次のパラメーターを使用します。 - サーバーの URL は `https://mcp.stripe.com`. です - 接続メカニズムとして「OAuth」を使用します。 Stripe の MCP サーバーは、[自律型エージェント](https://docs.stripe.com/mcp.md#agents)を構築する際に、Open AI のレスポンス API とも連携します。 #### その他 MCP は、多くのクライアントでサポートされているオープンプロトコルです。特定のクライアントのドキュメントで、接続方法をアドバイスできます。接続メカニズムとして、可能であればサーバーの URL`https://mcp.stripe.com` と「OAuth」を使用してください。MCP クライアントが OAuth をサポートしていない場合は、`Authorization` ヘッダーで[制限された API キー](https://docs.stripe.com/keys.md#create-restricted-api-secret-key)をベアラートークンとして渡すことができます。たとえば、クライアントが次のヘッダープロパティを受け入れるとします。 ```bash "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer <>" } } ``` インストール後、ダッシュボードの設定で MCP クライアントセッションを管理できます。 ### MCP クライアントセッションの管理 Stripe の MCP サーバーは、[MCP 仕様](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#2-1-1-oauth-grant-types)に従って MCP クライアントと接続する際に OAuth を使用します。OAuth はシークレットキーを使うよりも安全で、より細かい権限設定やユーザー単位の認可が可能です。Stripe MCP をクライアントに追加すると、MCP クライアントは OAuth 同意画面を開き、クライアントがあなたの Stripe データにアクセスすることを許可できます。 認証済みの OAuth クライアントセッションを表示するには、Stripe ダッシュボードの[ユーザー設定](https://dashboard.stripe.com/settings/user)に移動します。MCP クライアントを認証している場合は、**OAuth Sessions** に表示されます。特定の MCP クライアントセッションの OAuth アクセスを取り消すには、以下のようにします。 1. [ユーザー設定](https://dashboard.stripe.com/settings/user)の OAuth Sessions セクションまでスクロールします。 1. リストでクライアントセッションを見つけ、オーバーフローメニューをクリックします。 1. **アクセスを取り消す** を選択します。 ### MCP アクセスの管理 管理者はダッシュボードで [MCP アクセスを有効](https://dashboard.stripe.com/settings/mcp)にできます。アクセスはサンドボックス環境と本番環境で別々に管理されます。 ### 自律エージェントの構築 エージェントソフトウェアを構築している場合は、Stripe API キーをベアラートークンとして MCP リモートサーバーに渡すことができます。エージェントのアクセスを必要な機能のみに制限するため、[制限付き API キー](https://docs.stripe.com/keys/restricted-api-keys.md)を使用することを強くお勧めします。たとえば、この認証方法は [OpenAI のレスポンス API ](https://platform.openai.com/docs/guides/tools-remote-mcp#authentication)で使用できます。 制限付きまたはシークレットの API キーをコードに埋め込まないでください。代わりに、シークレットボールトまたは環境変数を使用して API キーをエージェントに提供してください。キーを安全に管理する方法については、シークレット API キーの管理に関する[ベストプラクティス](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 サーバーを実行する ローカル設定を希望または必要な場合、[ローカル Stripe MCP サーバー](https://github.com/stripe/ai/tree/main/tools/modelcontextprotocol)を実行します。 #### Cursor [Cursor にインストール](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJlbnYiOnsiU1RSSVBFX1NFQ1JFVF9LRVkiOiIifSwiY29tbWFuZCI6Im5weCAteSBAc3RyaXBlL21jcCJ9) Cursor を開いて Stripe MCP を自動的に追加するには、インストールをクリックします。または、`~/.cursor/mcp.json` ファイルに以下を追加します。詳細については、Cursor の[ドキュメント](https://cursor.com/docs/context/mcp/directory)を参照してください。 ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` コードエディタエージェントは、利用可能なすべてのツールを自動的に検出し、チャットに関連する質問を投稿すると、関連するツールを呼び出します。 #### VS Code [Install in VS Code](https://vscode.dev/redirect/mcp/install?name=stripe&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22stripe_secret_key%22%2C%22description%22%3A%22Stripe%20secret%20API%20key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40stripe%2Fmcp%22%5D%2C%22env%22%3A%7B%22STRIPE_SECRET_KEY%22%3A%22%24%7Binput%3Astripe_secret_key%7D%22%7D%7D) VS Codeを開いて Stripe MCPを自動的に追加するには、インストールをクリックします。または、ワークスペースの`.vscode/mcp.json`ファイルに以下を追加します。詳細は、VS Code の[ドキュメント](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)をご覧ください。 ```json { "servers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### Windsurf 以下を ‘~/.codeium/windsurf/mcp_config.json’ ファイルに追加してください。詳細については、Windsurf [ドキュメンテーション](https://docs.windsurf.com/windsurf/cascade/mcp) を参照してください。 ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### Claude `claude_desktop_config.json` ファイルに以下を追加します。詳細については、Claude Desktop [ドキュメンテーション](https://modelcontextprotocol.io/quickstart/user)を参照してください。 ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### CLI 次のコマンドを使用して、MCPサーバーをローカルで起動します。 ```bash npx -y @stripe/mcp@latest --api-key=<> ``` MCP サーバーは、渡された `--api-key` または `STRIPE_SECRET_KEY` 環境変数を使用します。 ## ツール サーバーは以下の[MCP ツール](https://modelcontextprotocol.io/docs/concepts/tools)を公開しています。プロンプトインジェクション攻撃を回避するために、ツールの手動確認を有効にし、他のサーバーで Stripe MCP を使用する際には注意を払うことをお勧めします。フィードバックがある場合や、その他のツールをご希望の場合は、[mcp@stripe.com](mailto:mcp@stripe.com) までメールでご連絡ください。 | リソース | 具 | API | | ----------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------- | | **口座** | `get_stripe_account_info` | [アカウントの取得](https://docs.stripe.com/api/accounts/retrieve.md) | | **残高** | `retrieve_balance` | [残高の取得](https://docs.stripe.com/api/balance/balance_retrieve.md) | | **クーポン** | `create_coupon` | [クーポンを作成](https://docs.stripe.com/api/coupons/create.md) | | `list_coupons` | [クーポンをリスト](https://docs.stripe.com/api/coupons/list.md) | | **顧客** | `create_customer` | [顧客の作成](https://docs.stripe.com/api/customers/create.md) | | `list_customers` | [顧客をリスト](https://docs.stripe.com/api/customers/list.md) | | **不審請求の申し立て** | `list_disputes` | [不審請求の申し立てをリスト](https://docs.stripe.com/api/disputes/list.md) | | `update_dispute` | [不審請求の申し立ての更新](https://docs.stripe.com/api/disputes/update.md) | | **請求書** | `create_invoice` | [請求書の作成](https://docs.stripe.com/api/invoices/create.md) | | `create_invoice_item` | [インボイスアイテムの作成](https://docs.stripe.com/api/invoiceitems/create.md) | | `finalize_invoice` | [請求書を確定する](https://docs.stripe.com/api/invoices/finalize.md) | | `list_invoices` | [請求書をリスト](https://docs.stripe.com/api/invoices/list.md) | | **Payment Link** | `create_payment_link` | [決済用リンクの作成](https://docs.stripe.com/api/payment-link/create.md) | | **PaymentIntent** | `list_payment_intents` | [PaymentIntents のリスト](https://docs.stripe.com/api/payment_intents/list.md) | | **価格** | `create_price` | [価格の作成](https://docs.stripe.com/api/prices/create.md) | | `list_prices` | [価格をリスト](https://docs.stripe.com/api/prices/list.md) | | **プロダクト** | `create_product` | [商品の作成](https://docs.stripe.com/api/products/create.md) | | `list_products` | [商品をリスト](https://docs.stripe.com/api/products/list.md) | | **返金** | `create_refund` | [返金する](https://docs.stripe.com/api/refunds/create.md) | | **サブスクリプション** | `cancel_subscription` | [サブスクリプションのキャンセル](https://docs.stripe.com/api/subscriptions/cancel.md) | | `list_subscriptions` | [サブスクリプションをリスト](https://docs.stripe.com/api/subscriptions/list.md) | | `update_subscription` | [サブスクリプションの更新](https://docs.stripe.com/api/subscriptions/update.md) | | **その他** | `search_stripe_resources` | [Stripe のリソースを検索](https://docs.stripe.com/search.md) | | `fetch_stripe_resources` | Stripe オブジェクトを取得 | | `search_stripe_documentation` | Stripe の知識を検索 | ## Agentic Treasury へのアクセスをリクエスト Agentic Treasury を使用すると、AI エージェントは資金の移動、請求書の支払い、カードの作成と管理を行えます。先行提供版をリクエストするには、以下にメールアドレスを入力してください。 ## See also - [AI を活用して Stripe 上に構築](https://docs.stripe.com/building-with-ai.md) - [エージェントワークフローに Stripe を追加](https://docs.stripe.com/agents.md)