結論先說
- Stripe 官方遠程 MCP 地址是
https://mcp.stripe.com,既可通過stripe agent setup一鍵配置並同步安裝官方技能,也可手動寫入客戶端mcp.json。 - 交互式編輯器優先走 OAuth 登入,自動化程序必須改用帶 Agent 標記的受限密鑰(Agent API Key):按官方遷移要求,2026 年 11 月 30 日後無 Agent 標記的普通私鑰連接 MCP 會返回
401。 - 查詢與寫入濃縮為
stripe_api_read和stripe_api_write等精簡工具,不會把成百上千個接口一次性塞爆大模型上下文。 - 涉及退款或資金變動會觸發服務端人工確認(Human confirmation),AI 會給出控制檯確認連結,人工點批准(24 小時內有效)後再讓助手重試才能執行。
- 主力模型訂閱與帳號配套入口:跑通 MCP 工具鏈與多文件智能體編碼依賴穩定的底層大模型配額,國內免境外卡自助開通可見本站 Claude Code 訂閱頁、ChatGPT Plus 充值頁 與 AI 會員充值總覽。

圖:本站根據 Stripe 官方文檔:Model Context Protocol (MCP) 整理的示意圖
本文根據 Stripe 官方文檔《Model Context Protocol (MCP)》及 Claude Code 文檔整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Stripe 或 Anthropic 官方網站。
適用於誰
- 想在 Cursor、Claude Code 裏直接檢索 Stripe 最新支付接口文檔、查詢測試訂單或核對帳單的開發者;
- 打算用 API Key 配置無人值守客戶端,需要弄清 Agent 專用受限密鑰權限最小化規則的人;
- 讓 AI 發起退款或寫操作時遇到確認攔截,不知道怎麼在測試沙箱(Sandbox)安全聯調的團隊。
一、一鍵配置與手動接入 mcp.stripe.com
1. 官方推薦:用 Stripe CLI 自動配置
Stripe 官方推薦先裝好 Stripe CLI,再運行內置命令自動識別本機已安裝的 AI 編程工具並寫入 MCP 與配套技能(Skills):
bash
stripe agent setup
2. 手動配置 Claude Code 與 Cursor
如果只想單獨掛載遠程 MCP 伺服器,可在 Claude Code 終端執行:
bash
claude mcp add --transport http stripe https://mcp.stripe.com
在 Cursor 的 ~/.cursor/mcp.json 或項目 .cursor/mcp.json 中則填入:
json
{
"mcpServers": {
"stripe": {
"url": "https://mcp.stripe.com"
}
}
}
儲存後在客戶端觸發認證即可打開 Stripe 網頁授權頁。客戶端本地配置細節見 Claude Code MCP 配置教學 與 Cursor MCP 配置教學。在聯調複雜訂閱計費 webhook 時若高頻消耗 Claude 額度,也可在本站查看 Claude Code 充值說明。
二、OAuth 與受限密鑰(Agent API Key)權限最小化
Stripe 官方為 MCP 提供兩條認證路徑,安全邊界完全不同:
- 交互式客戶端用 OAuth:登入時可在授權頁勾選允許訪問的一個或多個正式帳戶(Live mode)或測試沙箱(Sandbox),並為不同環境單獨設定讀寫權限。不想繼續授權時,隨時去控制檯個人設定(User settings)的 OAuth sessions 列表點撤銷訪問(Revoke access)。
- 非交互代理用 Agent API Key:在無瀏覽器的後台服務或 Connect 平台代調場景下,需在 Stripe 控制檯創建帶有 Agent 徽標的專用受限密鑰,放入請求頭:
json
{
"mcpServers": {
"stripe": {
"url": "https://mcp.stripe.com",
"headers": {
"Authorization": "Bearer 你的_AGENT_API_KEY"
}
}
}
}
權限最小化三原則:
- 只勾選當前任務必需的資源讀取權(例如查單隻給 Customers 與 PaymentIntents 只讀,不給帳戶設定和提現權限);
- 嚴禁再把
sk_live_全權限主密鑰填進配置文件——官方自 2026 年 12 月起全面拒收非 Agent 標記密鑰; - 更換舊密鑰前先在測試沙箱驗證通過,再去後台作廢舊密鑰。更多 MCP 安全審計做法可參考 MCP 伺服器怎麼選、去哪找、裝之前怎麼審。
編程訂閱與高配額省心方案:在 Cursor、Claude Code 或 Codex 裏掛載外部工具做長鏈路開發時,固定月費訂閱通常比純按量 API 更易控成本。本站支持支付寶、微信支付與 AlipayHK 免密自助兌換 Claude Pro、Claude Max 與 ChatGPT Pro,團隊協作亦可定製 ChatGPT Business 團隊版。
三、查訂單、發起退款與測試沙箱聯調
Stripe MCP 通過少量聚合工具覆蓋絕大部分接口與文檔檢索:
- 查文檔與規劃集成:
search_stripe_documentation搜尋最新官方指南,stripe_implementation_planner輔助設計收款或訂閱接入方案; - 查接口定義與讀數據:先用
stripe_api_search和stripe_api_details確認參數,再用stripe_api_read調用任意受支持的GET接口查訂單、訂閱或餘額; - 寫操作與人工確認:創建退款等變更通過
stripe_api_write發起。遇到高風險動作時,Stripe 會返回一條待確認連結;你必須在瀏覽器打開該連結核對金額並點擊批准(Approve,有效期 24 小時),隨後回到聊天框告訴 AI 重試該操作才會真正落庫。

圖:本站根據 Stripe 官方文檔:Model Context Protocol (MCP) 整理的示意圖
日常開發收銀台和回調邏輯時,應在 OAuth 授權頁只勾選測試沙箱(Sandbox),配合 Stripe 官方文檔提供的標準測試卡號構造支付成功、拒付或爭議訂單,確認無誤後再切回代碼提交,不在本地編輯器掛着正式帳戶寫權限跑調試提示詞。
常見問題
問:為什麼用以前的受限密鑰(rk_)連 mcp.stripe.com 報 401?
答:按 Stripe 官方遷移要求,2026 年 11 月 30 日之後,MCP 接口停止接受全權限密鑰及不帶 Agent 標籤的舊版受限密鑰,並返回 401 提示改走 OAuth 或新建 Agent API Key。
問:公司電腦連不上 mcp.stripe.com 怎麼辦?
答:首先讓團隊管理員檢查 Stripe 控制檯的 MCP 與 CLI 訪問設定(mcp-and-cli-access)是否禁用了對應環境;若受企業內網管控攔截,需聯絡 IT 將 mcp.stripe.com 加入放行名單。
問:Stripe Connect 平台怎麼用 MCP 查子商戶數據?
答:官方說明操作關聯子帳戶(Connected accounts)不支持走個人 OAuth,需使用平台側創建的 Agent API Key,並在請求 headers 中額外傳入 "Stripe-Account": "acct_xxx"。
問:配置好開發環境後,國內沒有外幣卡怎麼開通 Claude 或 ChatGPT 編程訂閱?
答:可在 本站充值中心 自助選購卡密開通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程無需交出帳號密碼,支持開具增值稅發票;實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。
相關教學
- Claude Code MCP 配置教學:claude mcp add、配置文件位置與常用 MCP
- Cursor MCP 配置教學:mcp.json 寫法、項目與全局位置、OAuth 與連接失敗排查
- MCP 伺服器怎麼選、去哪找、裝之前怎麼審:官方安全清單與七步檢查
- Codex 怎麼配置 MCP:codex mcp add 命令、config.toml 寫法與常見問題
參考資料
- Stripe 官方文檔:Model Context Protocol (MCP) — https://docs.stripe.com/mcp
- Claude Code 官方文檔:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
0 條評論
還沒有評論,來搶沙發~