Stripeの決済データをAIエージェントが分析。権限と検証の決め方

売上や解約の数字を確かめるために、管理画面を開き、期間を選び、CSVを書き出して表計算に貼り直す。この手順に、もう一つの入口ができました。Stripeは2026年11月5日、自社に貯まっている決済・収益データへAIエージェントが構造化された形でアクセスできるようになったと、公式ブログで発表しました。冒頭の一文は「Agents can now have structured access to your Stripe data to help you make faster, better business decisions」で、提供範囲は「Now available for all Stripe users」と書かれています。

先に要点を書きます。これは読み取りの仕組みです。そして、エージェントが出した答えをそのまま信じる形にはなっていません。公式ブログは「For each analysis with our APIs, you can inspect the underlying SQL, confirm how the result was calculated, and edit the query as your needs change」と書いています。実行されたSQLを見て、どう計算されたかを確かめ、必要なら書き換えられる。数字を扱う仕事では、ここがいちばん重要な部分です。

この記事で扱うのは、公式ブログと公式ドキュメントに書かれている範囲だけです。日本での提供条件、導入した企業の数、回答の正しさの保証については記載がありません。確認日は2026年11月6日です。

発表で変わったのは「頼む相手」ではなく「問い方」

公式ブログが挙げている使い方は2つです。前の四半期に自社のどこが好調だったかを示す投資家向けのスライドを作ること、そして自社のStripeの収益が変わった理由を理解するためのダッシュボードを組むこと。どちらも、これまでは数字を取る人と資料を作る人のあいだで何度かやり取りが発生していた作業です。

精度の支えになっているのは、データの持ち方だと説明されています。公式ブログの記載はこうです。「The Reports API has the modeled data schema of more than 300 tables, as well as built-in guidance for how the agent should use the tables, so you can get the most accurate and reliable analysis」。300を超えるテーブルのモデル化済みスキーマがあり、エージェントがそれらをどう使うべきかの手引きも組み込まれている、という説明です。生のテーブルを手当たり次第に読ませるのではなく、使い方の指示を添えて渡す設計になっています。

マーケティングの側から見ると、変わるのは依頼先ではなく問い方です。「先月の数字をください」は依頼ですが、エージェントに渡すのは条件です。対象の期間、含める取引、除外する取引、分ける軸。ここを言葉で決められない人が投げると、返ってくるのは速いだけの数字になります。広告データについて同じ構造の入口ができた話は広告データにAIエージェントの正面入口。SnapとGoogleの公式MCPサーバーで扱いました。決済データでも、決める順番は変わりません。

3つの入口を取り違えない

Stripeはプログラムからデータを取る製品を3つ並べ、必要なデータの種類で選ぶよう案内しています。名前が似ているので、最初に役割を押さえておく価値があります。

Analytics APIは、Stripeが定義した指標を同期的にJSONで返すものです。ドキュメントには月間経常収益（MRR）、年間経常収益（ARR）、利用収益が例として挙げられています。少数の決まった指標を画面に出し続けたい場合や、エージェントに指標を渡したい場合に向くと書かれています。ただしこの製品はプレビューで、参加を申請する手順がドキュメントに載っています。

Reports APIは、ダッシュボードの財務レポートと同じ内容をCSVで非同期に返します。残高、入金の照合、手数料、税金といったレポートの種類が並んでいます。取引の生データを定期的に一括で書き出す用途です。

Queries APIは、Stripeの生データに対して任意のSQLを非同期で実行し、結果をCSVまたはレスポンスの行として返します。自由度がいちばん高く、料金の条件が付くのもこの製品です。

自分の数字だが、定義は自分の定義ではない

ここは見落としやすい点です。Analytics APIが返すのはStripeが定義した指標です。社内で使っているMRRの定義が、たとえば試用期間の扱いや値引きの反映で違っていれば、同じ名前の数字がずれます。エージェントは依頼された指標を取ってくるだけで、社内定義との差は埋めません。

単位も確認が必要です。ドキュメントには、金額の指標は通貨の最小単位で返り、割合の指標はベーシスポイントで返ると書かれています。桁をそのまま資料へ貼ると、意味が変わります。さらに、指標のバージョンはAPIのバージョンに紐づき、定義が変わると新しいIDが割り当てられ、共通名は新しいバージョンを指すと説明されています。去年の資料と今年の資料で同じ名前の指標を並べるとき、同じ定義とは限らないということです。

だからこそ、指標の定義を一箇所に置いておく作業が先に必要になります。どの数字をどう数えるかを決めて共有する手順はKPIレポートの作り方｜Looker Studioで毎週届く形にするに整理しています。定義が決まっていないチームにエージェントを足すと、数字の出所が増えるだけです。

つなぐ前に決める権限と、取り消す経路

接続の手順はドキュメントに書かれています。対応するエージェント向けにはプラグインが用意され、stripe agent setup を実行すると使っているエージェントを検出して設定します。プラグインに対応していないクライアントでは、サーバーのURLとして https://mcp.stripe.com を指定する手動設定の手順が案内されています。

渡す権限は、分析のためなら読み取りだけで足ります。ドキュメントはデータの指標、クエリ、レポートの読み取りを有効にするよう案内し、「These permissions let your agent analyze your data without changing anything in your account」と書いています。あわせて、ダッシュボードで自分が持っている権限しか付与できないとも明記されています。権限の線引きは、エージェントを入れる前の社内の権限設計がそのまま出てきます。

認証は2通りです。利用者の権限で対話的に使う場合はOAuth、利用者から独立して継続的に動かす必要がある場合はエージェントAPIキーを使うと説明されています。キーの扱いについては「Don’t paste a Stripe secret key into a chat, or save it in an unprotected file」という注意書きがあり、サインインの画面が出ないクライアントでは開発者か管理者にエージェントAPIキーで接続してもらうよう案内されています。

組織の側の設定も押さえておく必要があります。管理者はダッシュボードでチーム全体のMCPアクセスを有効または無効にでき、本番環境とサンドボックス環境は別に設定します。認証済みのクライアントはユーザー設定のOAuthセッションに並び、そこから個別に取り消せます。チームメンバーを管理する権限があれば、他のユーザーのセッションも取り消せると書かれています。社内の端末やネットワークが管理されている場合、IT部門が外部のMCPサーバーへの接続を止めていることがあるため、つながらないときは mcp.stripe.com への接続許可を依頼するよう案内されています。

読み取りで終わらせるか、書き込みまで許すか

今回の発表は分析の話ですが、同じサーバーには書き込みのツールも並んでいます。ドキュメントのツール一覧には、任意のGETメソッドでデータを読む stripe_api_read と、POSTなどでデータを書き込む stripe_api_write が載っています。分析だけが目的なら、書き込み側の権限を渡さない選択ができます。

そのうえで、影響の大きい操作には人の確認が入る仕組みが用意されています。返金の作成のような操作には確認のバッジが付き、エージェントが示したURLを開いて内容を確認し、承認する流れです。ドキュメントには注意点が2つ書かれています。承認してもエージェントが自動で続けるわけではなく、利用者が再試行を指示する必要があること。そして、承認しないまま24時間が過ぎると、その操作は期限切れになること。

決まること	どこで決まるか	ドキュメントの記載
何を読めるか	付与した読み取り権限	指標・クエリ・レポートの読み取りで分析ができる
何を書き込めるか	付与した権限とツール	書き込みは別のツールとして分かれている
人の確認が入るか	操作の内容	確認はツール名ではなく操作で決まる
呼び出し前に止めるか	クライアント側の設定	ツール承認の設定を有効にするよう案内

もう一つ、公式の注意書きを引いておきます。ドキュメントは、MCPクライアントのツール承認設定を有効にして呼び出しを確認できるようにすることと、Stripe MCPを他のサーバーと併用する場合はプロンプトインジェクション攻撃を防ぐため十分に注意することを求めています。複数のサーバーをつないだエージェントは、外から入ってきた文章を指示と読み違える余地が増えます。差し出す側から見た同じ問題はWebMCPはサイトが道具を差し出す仕組み｜草案と決めることで整理しました。

料金とキーには日付がある

運用に直接関わるのは、期限が決まっている2つの変更です。公式ブログの記載を引きます。「The Queries API is free for all Stripe users through January 31, 2027. After that, you’ll pay per credit of API usage, with no monthly subscription required. The Reports API will remain free」。Queries APIは2027年1月31日まで無料で、その後はAPI利用のクレジット単位の支払いになり、月額の契約は不要。Reports APIは無料のままだという説明です。ドキュメント側には、従量課金が2027年2月1日に始まるという記載もあります。

もう一つはキーの移行です。ドキュメントには、2026年11月30日までに移行を完了するよう求める案内が置かれています。12月以降、Stripe MCPはフルアクセスのシークレットキーと、Agentタグのない制限付きAPIキーを受け付けなくなり、新しく作ったエージェントAPIキーへ置き換えるか、OAuthで再接続することになります。

単価の記載はありません。クレジット単位という書き方だけなので、月あたりいくらになるかを見積もる材料は現時点では公開されていないことになります。無料の期間のうちに、どの問いを何回投げるのかを把握しておくほうが現実的です。

返ってくる速さと、データの新しさは別の話

エージェントが答えるのが速いことと、見ている数字が今日のものであることは別です。Reports APIのドキュメントには、レポート用のデータを半日単位で準備するという記載があります。レポートの実行はほとんどが数分で終わるものの、データセットの大きさや対象期間によってはそれより長くかかるとも書かれています。

つまり、今日の午後の売上をその場で確かめる用途ではありません。日や週で区切った判断、入金の消込、返金や不審請求の傾向を見る用途に向きます。ドキュメントの例として並んでいる問いかけも、直近3か月の入金を裏側の支払い・返金・不審請求・手数料・送金に突き合わせて、合わない金額を示させるもの、直近1週間の不審請求と返金を決済手段や理由別の傾向で見せるもの、今期の新しいプロモーションが収益にどう影響したかを尋ねるものです。いずれも締まったあとの数字を扱う問いです。

日本の実務者が先にできること

第一に、問いを文章で固定することです。期間、対象、除外、分ける軸を書いた問いを社内に残しておけば、誰が投げても同じ条件で比べられます。思いついた順に尋ねると、答えのあいだで条件が揃いません。

第二に、指標の対応表を作ることです。Stripeが定義した指標の名前と、社内で使っている指標の名前を並べ、違いを書き添えます。名前が同じで中身が違う指標は、資料に並んだ時点では見分けられません。

第三に、権限を最小にして、取り消す手順を書いておくことです。読み取りだけで足りるなら読み取りだけを渡し、誰がどのクライアントを接続しているかと、どこから取り消せるかを記録します。接続した本人が不在のときに止められない状態は避けられます。

第四に、社外へ出す数字にはSQLと期間を添えて保存することです。エージェントが出した結果をそのまま資料へ貼ると、あとで根拠を再現できません。実行されたSQLを見られる仕組みがあるので、見られるうちに保存します。自社の数字を外へ出すときの線引きは自社調査の結果を公表するときの注意点｜景品表示法から見た根拠と調査概要にまとめています。

参照した資料に書かれていないこと

推測で埋めないために、探しても見つからなかった項目を残します。

確認したかった項目	記載	どうするか
Queries APIの単価	クレジット単位という記載だけです	無料の期間に利用の規模を把握する
日本での提供条件	日本に限った条件の記載はありません	自社のアカウントで実際に確認する
回答の正しさの保証	保証の記載はありません	SQLと期間を人が確認する前提で使う
導入した企業の数や効果	記載がありません	社内資料に数値を書かない
読み取り以外を止める設定の細部	権限とツールの案内のみです	サンドボックスで試してから本番へ

記載がない項目が残るのは、公開直後の機能では普通のことです。問題になるのは、書かれていないことを社内の資料で埋めてしまうときです。共有するときは、ドキュメントの記載と自分たちの判断を分けて書いてください。

まとめ

Stripeは、決済・収益データへエージェントが構造化された形でアクセスできるようにし、全ユーザーが使える状態だと発表しました。支えているのはReports APIのモデル化済みスキーマで、300を超えるテーブルと使い方の手引きを持つと説明されています。分析のたびに実行されたSQLを見て、計算の仕方を確かめ、書き換えられるという点が、数字を扱う現場では効きます。

入口は3つに分かれます。Stripe定義の指標を同期的に返すAnalytics API、CSVを非同期で返すReports API、任意のSQLを非同期で実行するQueries APIです。Analytics APIはプレビューで参加の申請が必要と記載されています。

つなぐ前に決めることは4つです。渡す読み取り権限、OAuthとエージェントAPIキーのどちらを使うか、管理者側のMCPアクセスの設定、そして取り消しの経路です。料金とキーには日付があり、Queries APIの無料は2027年1月31日まで、キーの移行の期限は2026年11月30日と案内されています。

いま手を動かすなら、問いの固定と指標の対応表からです。この2つは、どのエージェントを選んでも無駄になりません。確認日は2026年11月6日です。