Stripe MCP Server (Official)注目

Stripe MCP Server (Official) とは？

Stripe MCP Server (Official) は、Stripe が公式にホストする stripe mcp エンドポイント（https://mcp.stripe.com）です。AI エージェントが OAuth またはエージェント API キーを使って、Stripe API の呼び出し、アカウントデータの参照、Stripe のドキュメントやサポート記事の検索を行えます。

サーバーは Stripe 自身が運用しているため、インストールは不要です。少数の汎用ツール（stripe_api_read、stripe_api_write、API 検索ツール）で多数の対応 Stripe API メソッドにアクセスでき、モデルのコンテキストを圧迫しません。Stripe はサーバーを自動設定するエージェントプラグインとスキルも提供しています。

Stripe MCP Server (Official) の使い方

前提条件：Stripe アカウント（live mode またはサンドボックス）と、リモートサーバーに対応した MCP クライアント。

Stripe が推奨する最短の方法は、Stripe CLI によるプラグインセットアップです。使用中のエージェントを検出し、Stripe MCP サーバーを設定して Stripe のスキルをインストールします。

npm install -g @stripe/cli@latest
stripe agent setup

手動で設定する場合は、クライアントの接続先を https://mcp.stripe.com にします。

Claude Code

claude mcp add --transport http stripe https://mcp.stripe.com/

Claude Code を起動し、/mcp を実行して OAuth でサインインします。代わりにエージェント API キーを使う場合は、プロジェクトの .mcp.json にサーバーを追加し、キーを環境変数から読み込みます。

{
  "mcpServers": {
    "stripe": {
      "type": "http",
      "url": "https://mcp.stripe.com",
      "headers": {
        "Authorization": "Bearer ${AGENT_API_KEY}"
      }
    }
  }
}

Claude Desktop

Claude のディレクトリから公式 Stripe コネクタをインストールし、OAuth ウィンドウで Stripe にサインインしてから、会話内の Connectors で Stripe を有効にします。Team および Enterprise プランでは、先にオーナーがワークスペースにコネクタを追加する必要があります。

Cursor

Stripe ドキュメントの "Install in Cursor" ボタンを使うか、~/.cursor/mcp.json に次を追加します。

{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com"
    }
  }
}

VS Code

ワークスペースの .vscode/mcp.json に次を追加します。

{
  "servers": {
    "stripe": {
      "type": "http",
      "url": "https://mcp.stripe.com"
    }
  }
}

Codex

codex mcp add stripe --url https://mcp.stripe.com

ChatGPT デスクトップアプリ、Codex CLI、Codex IDE 拡張機能はこの設定を共有します。エージェント API キーを使う場合は、Codex 設定の [mcp_servers.stripe] に bearer_token_env_var = "AGENT_API_KEY" を設定します。

認証

• OAuth は対話型クライアント向けです。同意画面で 1 つ以上の live mode アカウントやサンドボックスへのアクセスを許可でき、環境ごとに異なる権限を設定できます。
• エージェント API キー は自律型クライアント向けです。エージェントに必要な権限だけを持つキーを作成し、Authorization ヘッダーで bearer トークンとして送信します。Stripe によると、2026 年 12 月以降、サーバーはフルアクセスのシークレットキーと Agent タグのない制限付きキーを受け付けなくなるため、2026 年 11 月 30 日までに移行してください。

Stripe MCP Server (Official) の主な機能

• Stripe 公式・Stripe がホスト。ローカルのプロセスやパッケージの保守は不要
• 汎用の読み書きツールで、顧客、決済、返金、請求書、サブスクリプション、商品、価格、Payment Links、不審請求の申し立て、Webhook、税金など多数の対応 API メソッドをカバー
• Stripe のドキュメントとサポート記事を検索
• 環境ごとに権限を設定できる OAuth、または権限を絞ったエージェント API キー
• 返金や送金など、機密性の高い stripe_api_write 操作には人による確認が必要
• Connect 対応：Stripe-Account ヘッダーで連結アカウントとして操作（エージェント API キーのみ）
• 管理者は環境ごとに MCP アクセスのオン／オフを切り替え、OAuth セッションを取り消せる

Stripe MCP Server (Official) のツール

• API ツール： stripe_api_search はキーワードで API メソッドを検索し、stripe_api_details はメソッドのパラメータを返し、stripe_api_read は GET メソッドを、stripe_api_write は POST、PATCH、PUT、DELETE メソッドを実行します。
• アカウントと分析： get_stripe_account_info はアカウント情報を取得し、stripe_analytics（プレビュー）は指標や財務レポートを照会し、Sigma が有効なら自然言語から SQL を作成します。
• Treasury（パブリックプレビュー）： get_balance_summary、convert_currency、send_money、setup_recipient、transfer_money。
• ガイダンス： search_stripe_documentation、連携を計画する stripe_implementation_planner、Stripe Atlas 用の atlas_company_formation、send_stripe_feedback。

Stripe MCP Server (Official) のユースケース

• カスタマーサポート：「顧客 jane@example.com を探して、直近 3 件の支払いを表示して」
• 請求業務：「Pro 商品に月額 $20 の価格を作成し、その Payment Link を作って」
• 安全確認付きの返金：返金を依頼し、Stripe が返す確認 URL で承認する。
• 収益に関する質問：stripe_analytics で「先月の MRR はいくら？」と尋ねる。
• 連携の計画：「無料トライアル付きのサブスクリプションはどう設定すべき？」に Stripe ドキュメントから回答する。
• Connect プラットフォーム：特定の連結アカウントの決済を調査する。

Stripe MCP Server (Official) と代替ツールの比較

ホスト型サーバーが公式の選択肢で、Stripe の stripe/ai リポジトリも MCP についてはこれを案内しています。mcp.so にある この Stripe MCP Server のようなコミュニティ製 Stripe MCP サーバーは、環境変数に設定した自分の Stripe シークレットキーでローカル実行します。これらは Stripe が保守しておらず、ホスト型サーバーの OAuth サインインや機密性の高い書き込みに対する人による確認もありません。他の決済サービスでは、PayPal が独自の PayPal MCP Server を提供しています。

Stripe MCP Server (Official) のトラブルシューティング

• OAuth チャレンジ付きの 401： サーバーがそのキー種別を受け付けなくなっています。OAuth で再接続するか、エージェント API キーを作成してください。
• 会社の PC から接続できない： 管理されたネットワークでは外部 MCP サーバーがブロックされることがあります。IT 部門に mcp.stripe.com の許可を依頼してください。
• チームで MCP が無効： 管理者は Dashboard の設定で live mode とサンドボックスの MCP アクセスを有効にできます。
• 書き込み操作が保留中： 一部の書き込みには人の承認が必要です。エージェントが示す URL を開いて Approve をクリックし、エージェントに再試行を指示します。承認は 24 時間で期限切れになります。
• OAuth で連結アカウントの呼び出しが失敗する： Connect にはエージェント API キーと Stripe-Account ヘッダーが必要です。