メインコンテンツへスキップ
ブログ
ブログに戻る

Claude Code で使う Stripe MCP:安全な設定と 11 月 30 日のキー変更

Stripe の MCP サーバーを使うと、Claude Code は開発中に Stripe のドキュメントを調べ、あなたのアカウントを読み取り、商品、価格、支払いリンクなどのオブジェクトを作成できます。Stripe のドキュメントによると、2026 年 11 月 30 日を過ぎると、同社の MCP サーバーはフルアクセスのシークレットキーと、Agent タグのない制限付きキーを受け付けなくなります。数か月前に設定ファイルへキーを貼り付けて Stripe MCP を設定したなら、その接続は 12 月に動かなくなります。このガイドは、Claude Code を使って一人で開発している創業者向けです:Stripe が現在推奨する方法で Stripe を接続する方法、サンドボックスから始めるべき理由、エージェントの設定ファイルから古いキーを見つける方法、移行の手順、そしてアカウントにいるのがあなた一人のときに承認がどう機能するかを説明します。Soloop のアカウントがなくても使えます。セキュリティ監査ではありません。

短い答え

Stripe CLI をインストールし、stripe agent setup を実行します。このコマンドは Claude Code を検出して Stripe のプラグインをインストールし、mcp.stripe.com でホストされている MCP サーバーと Stripe のスキルを設定します。Claude Code を起動して /mcp を実行し、OAuth で Stripe にサインインします。Stripe の同意ページでは、まずサンドボックスを許可し、ライブモードは必要になったときにだけ追加してください。

いずれかのツールが sk_ シークレットキー、または Agent タグのない rk_ 制限付きキーを mcp.stripe.com に送っている場合は、2026 年 11 月 30 日までに置き換えてください:OAuth で再接続するか、その作業に必要な権限だけを持つエージェント API キーを作成し、環境変数から読み込みます。返金とサブスクリプションのキャンセルは承認の後ろに置き、Stripe の書き込みツールを常に許可するよう Claude Code に指示することは決してしないでください。

2026 年 11 月 30 日に変わること

Stripe の MCP サーバーには 2 つのサインイン方法があります:あなたの Stripe ユーザーアカウントに代わって動作するクライアント向けの OAuth と、独立した永続的なアクセスを必要とする AI アプリケーション向けのエージェント API キーです。エージェント API キーとは、作成時に自律型エージェントのものとしてタグ付けされた制限付きキーです。ほかの制限付きキーと同じように認証されますが、自動的に Stripe の承認ルールの対象になります。

12 月以降、フルアクセスのシークレットキーや Agent タグのない制限付きキーを使った MCP サーバーへのリクエストには、OAuth ディスカバリーのチャレンジを含む 401 レスポンスが返されます。Stripe の告知は、MCP サーバーに送られるキーについてのものです。顧客への請求にアプリケーションが使うキーが変わるとは書かれていません。アプリが自分のサーバー上で使うキーは別の問題であり、制限付きキーを優先するという Stripe の一般的な助言が当てはまります。

受付終了

"Migrate by November 30, 2026. Starting in December, Stripe MCP will stop accepting full-access secret keys and restricted API keys without the Agent tag. Replace these keys with newly created agent API keys or reconnect with OAuth."(2026 年 11 月 30 日までに移行してください。12 月から、Stripe MCP はフルアクセスのシークレットキーと Agent タグのない制限付き API キーを受け付けなくなります。これらのキーを新しく作成したエージェント API キーに置き換えるか、OAuth で再接続してください。)

Stripe のドキュメント:Model Context Protocol
どちらを使うか

対話型の MCP クライアントには OAuth を使う。API キーを共有せずにクライアントを認可・取り消しできる。OAuth を使えない自律型クライアントには、クライアントが必要とする権限だけを持つエージェント API キーを作成し、サンドボックスでテストしてから古いキーを失効させる。

Stripe のドキュメント:Model Context Protocol
エージェントキー

制限付きキーをエージェントキーとしてタグ付けするには、Stripe がキーの用途を尋ねたときに "Authorizing agent access to your account"(アカウントへのエージェントのアクセスを認可する)を選ぶ。Agent タグ付きのキーは承認ルールの対象になり、最初の 1 つを作成したときに Stripe がデフォルトのルールを追加する。

Stripe のドキュメント:API keys
古いローカルサーバー

@stripe/mcp と @stripe/agent-toolkit のパッケージは非推奨で、"will receive no further updates, including security fixes"(セキュリティ修正を含め、今後アップデートは提供されない)。Stripe は代わりにホスト型サーバーを案内している。

GitHub:stripe/ai

どのアクセス方法がどの作業に合うか

自分のキーボードの前で Claude Code を使う創業者のほとんどは、OAuth だけで十分です。エージェントキーは、スケジュールされたジョブや CI で動くヘッドレスのエージェントなど、あなたがいなくても動く作業のためのものです。

AI コーディングツールが Stripe にアクセスする方法と、それぞれが合う場面
観点合う場面2026 年 11 月 30 日以降
プラグインまたは /mcp と OAuthClaude Code、Codex、Cursor で作業し、ブラウザーからサインインできる場合。サンドボックスかライブアカウントか、そして権限を Stripe の同意ページで選びます。Stripe が推奨。セッションは Stripe のユーザー設定の OAuth sessions で取り消せます。
環境変数に置いたエージェント API キーエージェントがあなたなしで動く場合、またはクライアントが OAuth に対応していない場合。キーにはあなたが設定した権限だけが付きます。受け付けられます。機密性の高い操作はあなたの承認ルールに従います。
mcp.stripe.com に送られるシークレットキー(sk_)またはタグのない制限付きキー(rk_)設定ファイルにキーを貼り付けていた古い設定。401 で拒否されます。受付終了までに置き換えてください。
--api-key 付きのローカルの @stripe/mcp パッケージ古いチュートリアルでは npx とシークレットキーで起動していました。非推奨で、セキュリティ修正はありません。ホスト型サーバーに移行してください。

Claude Code で Stripe を設定する(サンドボックスから)

サンドボックスとは、隔離された Stripe のテスト環境です。カードネットワークは何も処理せず、そのオブジェクトがライブモードと混ざることはありません。サンドボックスで開発すれば、プロンプトが混乱しても作られるのは本物ではなくテスト用の価格です。

  1. Stripe CLI(バージョン 1.43.3 以降)を npm install -g @stripe/cli または Stripe のインストールスクリプトでインストールします。
  2. プロジェクトのディレクトリで stripe agent setup --client claude-code を実行します。インストールされているものは、いつでも stripe agent setup --status で確認できます。
  3. Claude Code を起動して /mcp を実行します。Stripe のサーバーを選んでサインインします。Stripe の同意ページでサンドボックスと必要な権限を許可し、ライブモードは今のところ外しておきます。
  4. アカウントの管理者であれば、ダッシュボードの MCP と CLI のアクセス設定を開き、ライブモードとサンドボックスでそもそも MCP を許可するかどうかを別々に決めます。
  5. Claude Code のツール承認をオンのままにして、何かを変更する Stripe の呼び出しがすべてあなたを待つようにします。
  6. まず "List the products and prices in my Stripe sandbox"(Stripe サンドボックスの商品と価格を一覧して)のような読み取りのみの作業を頼み、答えがダッシュボードと一致するかを確認します。
  7. 実際の支払いを受け付ける前に、Stripe の本番稼働チェックリストに従ってください。MCP 接続にライブモードを許可するのは、それが必要な作業に限ります。

エージェントの設定から古い Stripe キーを見つける

キーの値が AI のトランスクリプトに残らないよう、これらはエージェント経由ではなくターミナルから実行してください。各コマンドが出力するのはファイル名かコミット ID だけです。macOS 上の grep と git で確認しています。Linux では、Claude Desktop の設定ファイルは別の場所にあります。

  1. Stripe キーを含むユーザーレベルのエージェント設定:grep -lE '(sk|rk)_(live|test)_' ~/.claude.json ~/.cursor/mcp.json ~/.codex/config.toml ~/Library/"Application Support"/Claude/claude_desktop_config.json 2>/dev/null
  2. 各リポジトリのプロジェクト設定(リポジトリのルートで実行):grep -rlE '(sk|rk)_(live|test)_' .mcp.json .claude .cursor .vscode 2>/dev/null
  3. そもそも Stripe MCP を使っている設定:grep -rlE 'mcp\.stripe\.com|@stripe/mcp' ~/.claude.json .mcp.json .claude .cursor .vscode 2>/dev/null
  4. キーが git の履歴に入ったことがあるか:git log --all --oneline -G '(sk|rk)_(live|test)_' は、すでに削除したファイルも含め、キーを追加または削除したすべてのコミットを一覧します。
  5. コマンドが示した各ファイルを開き、MCP サーバーのエントリー、Authorization ヘッダー、--api-key 引数、保存されたコマンドの許可の中に Stripe キーがないかを確認します。

受付終了までに移行する

  1. 検索で見つかった接続ごとに判断します:OAuth でサインインできるか。できるなら、設定からキーを削除し、/mcp を実行して再接続します。
  2. 作業があなたなしで動く必要がある場合は、API キーのページで新しいキーを作成します:Create restricted key を選び、"Authorizing agent access to your account" を選んで、作業が読み書きするリソースだけを許可します。まずサンドボックスで作成してください。
  3. キーはシークレットマネージャーか環境変数に保存し、.mcp.json そのものには決して書かず、名前で参照します(下のテンプレートを参照)。
  4. 読み取りのみのリクエストを 1 回実行し、成功することを確認します。OAuth チャレンジ付きの 401 が返る場合、そのキーはエージェントキーとしてタグ付けされていません。
  5. 古いキーを失効させるか、アプリでも使っている場合は猶予期間を設けてローテーションします。ローテーション中、Stripe では最大 7 日間、両方のキーが使えます。
  6. npx で起動している @stripe/mcp のエントリーを削除し、ホスト型サーバーに置き換えます。

エージェントキー用の .mcp.json をコピーする

OAuth が使えない場合にだけ使ってください。プロジェクトに .mcp.json として保存し、Claude Code を起動する前にシェルかシークレットマネージャーで STRIPE_AGENT_KEY を設定し、.env ファイルとキーそのものは git に入れないでください。変数名は一例です。Stripe のドキュメントでは AGENT_API_KEY を使っています。

Markdownをダウンロード

作業に必要なものだけを許可する

説明のための例であり、Stripe のデフォルトではありません:まず作業を決め、それから権限を決めます。制限付きキーとエージェントキーでは、リソースごとに none(なし)、read(読み取り)、write(書き込み)を設定できます。

創業者によくある作業ごとの権限の例(説明用)
観点許可するもの外すもの
「この支払いはなぜ失敗したのか」に答える顧客、請求(charges)、支払いインテント(payment intents)、請求書への読み取りアクセス。すべての書き込みアクセス。
開発中に商品、価格、支払いリンクを設定するサンドボックスでの、商品、価格、支払いリンクへの書き込みアクセス。ローンチまではライブモード。返金と入金(payouts)。
毎週の売上サマリーサブスクリプション、請求書、残高への読み取りアクセス。顧客情報の更新と、すべての書き込みアクセス。
あなたのレビュー用に返金を準備する返金への書き込みアクセス。デフォルトの承認ルールはオンのまま。入金(payouts)、送金(transfers)、銀行口座の変更。

一人で作業するときの承認

ゲートは 3 つあり、それぞれ役割が異なります。Claude Code 自身の権限プロンプトは、ツールが実行される前に確認します。Stripe の Human confirmation(人による確認)は、返金の作成など OAuth 経由の一部の操作に適用されます:Stripe がエージェントにリンクを渡し、あなたが 24 時間以内にダッシュボードで承認し、その後エージェントに再試行するよう伝えます。Stripe の承認ルールは、Agent タグ付きのキーに適用されます。

Agent タグ付きのキーに対する Stripe のデフォルトのルールは、返金、サブスクリプションのキャンセル、入金、外部への支払いと送金、通貨換算をレビュー待ちにします。エージェントは approval_required エラーを受け取り、Stripe がリクエストを作成します。あなたはダッシュボードか Stripe のモバイルアプリで承認または拒否し、リクエストは 14 日後に失効します。二者承認では通常、依頼者とは別のレビュー担当者が必要なため、一人だけの Stripe アカウントでは、こうしたルールを Agent タグ付きのキーによる操作に対してのみ保存できます。これも、無人で動くエージェントにはあなた自身のログインではなく専用のエージェントキーを与えるべき理由の一つです。

Claude Code の権限プロンプトで許可するもの
観点役割推奨する設定
search_stripe_documentation, stripe_api_search, stripe_api_detailsStripe のドキュメントと API リファレンスを検索します。許可する。
stripe_api_read, get_stripe_account_info接続したアカウントのオブジェクトを、顧客データも含めて読み取ります。サンドボックスでは許可し、ライブモードでは確認する。
stripe_api_write価格から返金やサブスクリプションのキャンセルまで、あらゆる作成、更新、削除の呼び出し。常に確認する。"don't ask again"(今後確認しない)は決して選ばない。
send_money などの Treasury のツールTreasury のアカウントからお金を移動します。Treasury を運用していない限り使わない。Stripe は Human confirmation を必須としています。

移行ワークシートをコピーする

自分のマシン用に 1 部、リポジトリごとに 1 部ずつ使ってください。接続とその新しいアクセス方法を記録しておけば、後できれいに取り消せます。

Markdownをダウンロード

Soloop の役割

Soloop は Stripe に接続せず、あなたの Stripe のデータを読まず、API キーも管理しません。上記のことはすべて、Stripe のツールとダッシュボードで行ってください。

Soloop は支払いを受け付けられるようになった後の作業のためのものです:Soloop のマニュアルによると、Soloop は情報源つきで市場を調べること、接続済みのアカウントから X の投稿や返信を書いて公開すること、接続済みの Gmail アカウントからアウトリーチを送ること、そして設定と支払いを完了した後に Google Ads の検索キャンペーンを準備することができ、各操作はデフォルトであなたの承認を待ちます。Soloop を含め、どの AI ツールのプロンプトにも Stripe キーを貼り付けないでください。

情報源、限界、更新

Stripe の Model Context Protocol、API keys、承認、エージェントプラグイン、agent setup、スキルの各ドキュメントと、stripe/ai の README は 2026 年 11 月 11 日に確認しました。Stripe は "starting in December"(12 月から)より正確な受付終了の時刻を公表していません。コマンド、権限の組み合わせ、ツールの設定はサンプルのディレクトリで確認した編集部の指針であり、セキュリティ監査でも Stripe や Anthropic の声明でもありません。

このガイドは 2027 年 2 月 11 日までに、または Stripe が受付終了の時期や MCP サーバーの認証方法を変更した場合はそれより早く見直します。

承認

Agent タグ付きのキーに対するデフォルトのルールは、返金、サブスクリプションのキャンセル、外部への支払いと送金、入金、通貨換算を対象とする。リクエストは 14 日後に失効する。ユーザーが一人のアカウントでは、実行者の条件を Agent タグ付きの API キーに設定した場合にのみ、二者承認のルールを保存できる。

Stripe のドキュメント:Two-party approvals
設定コマンド

stripe agent setup は Claude Code、Codex、Cursor を検出し、該当するプラグイン、スキル、MCP サーバーをインストールする。--client で対象を 1 つのツールに絞り、--status でインストール済みのものを表示する。

Stripe CLI:agent setup
プロダクトの機能

Soloop のマニュアルには、情報源つきの調査、接続済みのアカウントからの X への投稿、Gmail でのアウトリーチ、設定と支払い後の Google Ads の検索キャンペーンが記載されている。デフォルトでは承認が先に行われる。Stripe には接続しない。

Soloop のプロダクトマニュアル