# Model Context Protocol (MCP) AI エージェントを Stripe API と対話させるには、当社の MCP サーバーを使用します。 Stripe Model Context Protocol (MCP) サーバーは、AI エージェントが Stripe API を操作したり、ドキュメントやサポート記事などを含む Stripe のナレッジベースを検索したりするためのツールを提供します。 ## プラグインを使用した Stripe MCP セットアップ (推奨) Stripe 向け[エージェントプラグイン](https://docs.stripe.com/agents/plugin.md)は、Stripe MCP サーバーの設定、[スキル](https://docs.stripe.com/skills.md)のインストール、最新状態の維持を自動的に行います。設定やメンテナンスを行うことなく、最新の機能を利用できます。 インストールの実行手順は以下のとおりです。 ```bash npm install -g @stripe/cli@latest stripe agent setup ``` このコマンドにより、使用しているエージェントが自動的に検出され、該当するコマンドが実行されます。 ## Stripe MCP の手動セットアップ MCP クライアントが Stripe 向けの[エージェントプラグイン](https://docs.stripe.com/agents/plugin.md)をサポートしていない場合や、Stripe MCP サーバーを手動で設定してスキルをインストールする場合は、以下の手順に従ってください。 #### Cursor [Cursor にインストール](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJ1cmwiOiJodHRwczovL21jcC5zdHJpcGUuY29tIn0%3D) **Cursor にインストール**を選択して Cursor を開き、Stripe MCP サーバーを追加します。手動で設定するには、`~/.cursor/mcp.json` に以下の設定を追加します。 詳細については、[Cursor の MCP ドキュメント](https://docs.cursor.com/context/model-context-protocol)を参照してください。 ```json { "mcpServers": { "stripe": { "url": "https://mcp.stripe.com" } } } ``` #### Claude Code 以下のコマンドを実行して、Claude Code に Stripe MCP サーバーを追加します。 ```bash claude mcp add --transport http stripe https://mcp.stripe.com/ ``` サーバーを追加した後、OAuth を使用して Stripe の認証を行います。 ```bash claude /mcp ``` OAuth の代わりに[エージェント API キー](https://docs.stripe.com/keys.md#agent-keys)で認証するには、コマンドラインでキーを渡すのではなく、プロジェクトの `.mcp.json` ファイルにサーバーを追加し、エージェント API キーを保持する環境変数を参照します。この例では、`${AGENT_API_KEY}` はプレースホルダーです。`AGENT_API_KEY` を実際の環境変数名に置き換え、Claude Code を実行する前にシェルでその環境変数を設定します。 ```json { "mcpServers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer ${AGENT_API_KEY}" } } } } ``` 詳細については、[Claude Code の MCP ドキュメント](https://docs.anthropic.com/en/docs/claude-code/mcp#configure-mcp-servers)を参照してください。 #### Claude Desktop ウェブ上の Claude および Claude Desktop に[公式の Stripe Connector をインストール](https://claude.ai/directory/de127013-63f1-43d0-8dd2-b6cb5b4e5d1b)できます。 1. **Claude に接続** を選択し、アカウントまたはワークスペースにコネクターを追加します。 2. Stripe アカウントにサインインし、求められたら OAuth ウィンドウを使用して Claude に権限を付与します。 3. 会話内でプラスアイコンを選択し、**コネクター** を選択して Stripe を有効にします。 チームアカウントおよびエンタープライズアカウントの場合、メンバーが Stripe アカウントを接続する前に、所有者がワークスペースにコネクターを追加する必要があります。 #### Codex 次のコマンドを実行して、Stripe MCP サーバーを Codex に追加します。 ```bash codex mcp add stripe --url https://mcp.stripe.com ``` ChatGPT デスクトップアプリ、Codex CLI、Codex IDE 拡張機能は MCP サーバーをサポートしており、コンピューターで同じ設定を共有します。詳細については、OpenAI の[Codex MCP ドキュメント](https://learn.chatgpt.com/docs/extend/mcp)をご覧ください。 認証した後は、Stripe MCP サーバーを再設定することなく、ChatGPT デスクトップアプリ、Codex CLI、Codex IDE 拡張機能の間で切り替えることができます。 OAuth の代わりに[エージェント API キー](https://docs.stripe.com/keys.md#agent-keys)で認証するには、`bearer_token_env_var` にエージェント API キーを保持する環境変数名を設定します。この例では、`AGENT_API_KEY` はプレースホルダーです。中括弧で囲まれた変数名ではなく、実際の環境変数名に置き換えてください。 ```toml [mcp_servers.stripe] url = "https://mcp.stripe.com" bearer_token_env_var = "AGENT_API_KEY" # Replace with the name of your environment variable ``` #### ChatGPT [公式の Stripe プラグインを ChatGPT にインストール](https://chatgpt.com/plugins/plugin_connector_690ab09fa43c8191bca40280e4563238)できます。Stripe アカウントを接続し、プロンプトが表示されたら OAuth ウィンドウで ChatGPT に権限を付与します。 詳細については、OpenAI の[Codex MCP ドキュメント](https://learn.chatgpt.com/docs/extend/mcp)をご覧ください。 #### VS Code [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 にインストール** を選択して VS Code を開き、Stripe MCP サーバーを追加します。手動で設定するには、ワークスペース内の `.vscode/mcp.json` に以下の設定を追加します。 詳細については、[VS Code の MCP ドキュメント](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)を参照してください。 ```json { "servers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com" } } } ``` #### その他 MCP は、多くのクライアントでサポートされているオープンプロトコルです。クライアントの MCP 設定手順に従い、サーバー URL として `https://mcp.stripe.com` を使用してください。 クライアントがサポートしている場合は OAuth を使用します。クライアントが OAuth をサポートしていない場合は、`Authorization` ヘッダーのベアラートークンとして[エージェント API キー](https://docs.stripe.com/keys.md#agent-keys)を使用してください。たとえば、クライアントが `headers` プロパティを受け付ける場合は、以下の設定を使用します。 ```json { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer {{AGENT_API_KEY}}" } } } ``` ## MCP のアクセスとセッションの管理 Stripe の MCP サーバーは、次の 2 つの認証方法に対応しています。 1. **OAuth**: クライアントが Stripe ユーザーアカウントの権限で Stripe にアクセスする場合は、OAuth を使用します。 2. **API キー**: AI アプリケーションがユーザーとは独立して継続的に Stripe にアクセスする必要がある場合は、API キーを使用します。 OAuth を使用して MCP クライアントを接続すると、MCP クライアントが Stripe の OAuth 同意ページを開きます。1 つ以上の本番環境のアカウントまたはサンドボックスへのアクセスを許可し、環境ごとに異なる権限を設定できます。詳しくは、[MCP 仕様](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#2-1-1-oauth-grant-types)を参照してください。 組織がデバイスやネットワークを管理している場合、IT 管理者が外部の MCP サーバーへの接続をブロックしている可能性があります。管理対象の環境で Stripe MCP サーバーが接続されない場合は、IT 部門に `mcp.stripe.com` への接続許可を依頼してください。 ### すべてのチームメンバーの MCP アクセスを管理する 管理者は、ダッシュボードでチーム全体の [MCP アクセスを有効または無効にする](https://dashboard.stripe.com/settings/mcp-and-cli-access)ことができます。本番環境とサンドボックス環境へのアクセスは、それぞれ個別に設定します。 ### セッションの管理 認証済みの MCP クライアントは、[ユーザー設定](https://dashboard.stripe.com/settings/user)の **OAuth セッション**に表示されます。セッションを取り消すには、以下の手順を実行します。 1. **OAuth セッション**リストで対象のクライアントを見つけます。 2. オーバーフローメニュー (⋯) をクリックします。 3. **アクセスの取り消し**を選択します。 ### 管理者としてのセッション管理 他のユーザーのセッションを表示または取り消すには、チームメンバーを管理する権限がロールに含まれている必要があります。**管理者**ロールには、これらの権限が含まれています。 1. ダッシュボードで[チームとセキュリティ](https://dashboard.stripe.com/settings/team)を開きます。 2. 管理するチームメンバーを選択します。 3. **OAuth セッション**テーブルを見つけます。 4. 1 つのセッションを取り消すには、そのオーバーフローメニューをクリックして**アクセスを取り消す**を選択します。リストにあるすべてのセッションを取り消すには、**すべて取り消す**を選択します。 セッション管理は、現在表示しているアカウントまたは組織、および環境 (本番環境またはサンドボックス) にのみ適用されます。セッションを取り消すと、そのスコープ内でのみアクセス権が削除されます。現在のスコープ外のアカウントについては、セッションは有効なまま維持されます。 組織を表示すると、**アカウント**列に各セッションに関連付けられているアカウントが表示されます。 ## Stripe MCP を認証する インタラクティブな MCP クライアントには OAuth を使用します。OAuth を使用すると、API キーを共有することなくクライアントの承認や取り消しを行えます。 OAuth を使用できない自律型クライアントの場合は、クライアントに必要な権限のみを持つ[エージェント API キー](https://docs.stripe.com/keys.md#agent-keys)を作成します。エージェント API キーは、ダッシュボードの **Agent** バッジで識別できます。リクエストの `Authorization` ヘッダーにベアラートークンとしてエージェント API キーを渡します。サンドボックスで新しい設定をテストしてから、古いキーを失効させます。 > #### 2026 年 10 月 31 日までに API キー認証を更新する > > 2026 年 10 月 31 日以降、Stripe MCP ではフルアクセスのシークレットキー、および Agent タグのない制限付き API キーを受け付けなくなります。それまでに、これらのキーを新しく作成したエージェントキーに置き換えるか、OAuth で再接続してください。サポートされていないキーを使用したリクエストには、OAuth ディスカバリーチャレンジを含む `401` レスポンスが返されます。 ## ツール サーバーでは、以下の[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) | | **[分析](https://docs.stripe.com/data/analyze-with-ai.md)** | `stripe_analytics` | - (プレビュー) 指標をクエリし、サブスクと請求を分析して、財務レポートを実行します - (Sigma が必要) 自然言語に基づいて SQL クエリを構築します | | **Treasury** (Public preview) | `get_balance_summary` | Stripe 残高と Treasury アカウント全体のインタラクティブな残高サマリーを表示 | | **その他** | `search_stripe_documentation` | 指定された質問と言語について Stripe ドキュメントを検索します | | `stripe_implementation_planner` | Stripe 製品を案内し、決済の受け付け、オンラインでの商品の販売、請求の設定、または任意の Stripe 実装の構築を支援します | | `send_stripe_feedback` | Stripe のプロダクトに関するフィードバックを共有する | 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) - [支払いのすべての返金を一覧表示](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) - [PaymentMethod の一覧](https://docs.stripe.com/api/payment_methods/list.md) - [PaymentMethod の取得](https://docs.stripe.com/api/payment_methods/retrieve.md) - [顧客の PaymentMethod の一覧](https://docs.stripe.com/api/payment_methods/list.md) - [顧客の PaymentMethod の取得](https://docs.stripe.com/api/payment_methods/retrieve.md) - [決済手段の設定一覧](https://docs.stripe.com/api/payment_method_configurations/list.md) - [決済手段の設定取得](https://docs.stripe.com/api/payment_method_configurations/retrieve.md) - [決済手段のドメイン一覧](https://docs.stripe.com/api/payment_method_domains/list.md) - [決済手段のドメインの作成](https://docs.stripe.com/api/payment_method_domains/create.md) - [すべての SetupIntent の一覧](https://docs.stripe.com/api/setup_intents/list.md) - [SetupIntent の取得](https://docs.stripe.com/api/setup_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) - [Checkout Session の作成](https://docs.stripe.com/api/checkout/sessions/create.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/invoices/create_preview.md) - [すべてのクレジットノートの一覧](https://docs.stripe.com/api/credit_notes/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-link/list.md) - [決済用リンクを取得](https://docs.stripe.com/api/payment-link/retrieve.md) - [決済用リンクの項目を取得](https://docs.stripe.com/api/payment_links/line_items.md) - [決済用リンクを作成](https://docs.stripe.com/api/payment-link/create.md) - [決済用リンクを更新](https://docs.stripe.com/api/payment-link/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/v2/core/event-destinations/list.md) - [イベント送信先を取得する](https://docs.stripe.com/api/v2/core/event-destinations/retrieve.md) - [イベント送信先を作成する](https://docs.stripe.com/api/v2/core/event-destinations/create.md) - [イベント送信先を更新する](https://docs.stripe.com/api/v2/core/event-destinations/update.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/customer_portal/configurations/create.md) - [ポータル設定を更新する](https://docs.stripe.com/api/customer_portal/configurations/update.md) - [ポータルセッションの作成](https://docs.stripe.com/api/customer_portal/sessions/create.md) - [すべてのプラットフォーム手数料の一覧](https://docs.stripe.com/api/application_fees/list.md) - [すべての送金の一覧](https://docs.stripe.com/api/transfers/list.md) - [送金の取得](https://docs.stripe.com/api/transfers/retrieve.md) - [顧客取引残高の一覧](https://docs.stripe.com/api/customer_balance_transactions/list.md) - [現金残高の取得](https://docs.stripe.com/api/cash_balance/retrieve.md) - [現金取引残高の一覧](https://docs.stripe.com/api/cash_balance_transactions/list.md) - [テストクロックの作成](https://docs.stripe.com/api/test_clocks/create.md) - [残高の取得](https://docs.stripe.com/api/balance/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/all.md) - [税務登録の取得](https://docs.stripe.com/api/tax/registrations/retrieve.md) - [税務登録の作成](https://docs.stripe.com/api/tax/registrations/create.md) - [税務登録を更新する](https://docs.stripe.com/api/tax/registrations/update.md) - [メトリッククエリ結果の作成](https://docs.stripe.com/api/v2/data/analytics/metric-query-results/create.md?api-version=2026-07-29.preview) - [クエリ実行の作](https://docs.stripe.com/api/v2/data/reporting/query-runs/create.md?api-version=2026-07-29.preview) - [税額計算の作成](https://docs.stripe.com/api/tax/calculations/create.md) - [税額計算の取得](https://docs.stripe.com/api/tax/calculations/retrieve.md) - [税額計算の項目の取得](https://docs.stripe.com/api/tax/calculations/line_items.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) ## 代理で操作するエージェントのアクションを確認する ユーザー認証情報を使用して MCP サーバー経由で AI エージェントを Stripe に接続すると、ユーザーに代わって Stripe 内のデータを利用し、アクションを実行する権限をエージェントに付与します。 エージェントのミスを防ぐため、返金や送金などの特定の `stripe_api_write` アクションを実行する前に、Stripe では人による確認が必要になります。アクションを確認するには、エージェントが提供する URL をクリックし、リクエストの詳細を確認します。 ![返金リクエストを確認する](https://b.stripecdn.com/docs-statics-srv/assets/human-confirmation.d768e677a3bf87585ee29a003df41b00.png) 返金リクエストを確認する **承認**をクリックすると、Stripe からエージェントに承認トークンが提供されますが、ユーザーは操作を再試行するようエージェントに指示する必要があります。この再試行に人による確認は必要ありません。24 時間以内にアクションを承認しない場合、アクションは期限切れになります。 ## 連結アカウントで MCP を使用する デフォルトでは、Stripe MCP ツールは OAuth セッションまたは API キーに関連付けられた Stripe アカウントで動作します。エージェントをプラットフォームアカウントのみで動作させる場合は、上記の標準セットアップを使用します。 [Connect プラットフォーム](https://docs.stripe.com/connect.md)の場合は、MCP を使用して連結アカウントのリソースを取得または更新することもできます。たとえば、サポートエージェントが特定の連結アカウントの顧客情報を取得したり、支払いを調査したりできます。 連結アカウントに代わって操作する場合、MCP は OAuth をサポートしていません。代わりに、プラットフォームの[制限付き API キー](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 {{AGENT_API_KEY}}", "Stripe-Account": "acct_xxxxxxxxx" } } } } ``` ## See also - [エージェント向けプラグイン](https://docs.stripe.com/agents/plugin.md) - [エージェントスキル](https://docs.stripe.com/skills.md) - [ワークベンチでの MCP ツールコールログの表示](https://docs.stripe.com/workbench/overview.md#mcp-tool-call-logs)