结论先说
- 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 条评论
还没有评论,来抢沙发~