Stripe MCP Server:用自然语言管理你的整个支付业务
对于任何做在线业务的公司来说,Stripe是最重要的基础设施之一。从创建支付链接、管理客户、处理退款到分析收入数据,这些日常操作通常需要在Stripe Dashboard和代码之间不断切换。Stripe MCP Server让这一切变得前所未有的简单——你只需要用自然语言告诉AI助手你要做什么。
为什么Stripe需要MCP
传统方式的痛点
- 需要在Stripe Dashboard、API文档和代码之间频繁切换
- 查找特定客户或交易需要手动筛选和搜索
- 批量操作(如创建多个产品和价格)需要编写脚本
- 团队成员需要学习Stripe API才能完成简单的查询任务
MCP方式的优势
1 2 3 4 5 6
| 用户: 创建一个月度订阅产品"Pro Plan",价格$29.99/月, 并生成一个支付链接 AI: 已完成: - 创建产品 "Pro Plan" (prod_xxx) - 创建价格 $29.99/月 (price_xxx) - 生成支付链接: https://buy.stripe.com/xxx
|
25个核心MCP工具
Stripe MCP Server提供了25个工具,覆盖支付业务的完整生命周期:
账户与余额
| 工具名称 |
功能描述 |
get_stripe_account_info |
获取Stripe账户信息 |
retrieve_balance |
获取账户余额详情 |
客户管理
| 工具名称 |
功能描述 |
create_customer |
创建新客户记录 |
list_customers |
获取客户列表 |
产品与定价
| 工具名称 |
功能描述 |
create_product |
定义产品目录项 |
list_products |
浏览产品库存 |
create_price |
设置定价方案 |
list_prices |
查看价格配置 |
支付处理
| 工具名称 |
功能描述 |
create_payment_link |
创建可分享的支付链接 |
list_payment_intents |
跟踪支付意图列表 |
create_refund |
处理退款操作 |
订阅管理
| 工具名称 |
功能描述 |
list_subscriptions |
查看活跃订阅列表 |
update_subscription |
修改订阅参数 |
cancel_subscription |
取消订阅计划 |
发票系统
| 工具名称 |
功能描述 |
create_invoice |
生成账单文档 |
create_invoice_item |
添加发票行项目 |
finalize_invoice |
锁定发票准备收款 |
list_invoices |
浏览发票历史 |
优惠券与争议
| 工具名称 |
功能描述 |
create_coupon |
创建优惠券/折扣码 |
list_coupons |
查看现有优惠券 |
list_disputes |
查看争议案例 |
update_dispute |
修改争议状态 |
搜索与文档
| 工具名称 |
功能描述 |
search_stripe_resources |
搜索Stripe对象资源 |
fetch_stripe_resources |
检索特定Stripe对象 |
search_stripe_documentation |
搜索Stripe文档和知识库 |
两种部署方式
方式一:远程MCP服务器(推荐)
Stripe托管了一个远程MCP服务器,通过OAuth安全认证:
1 2
| 服务器地址: https://mcp.stripe.com 认证方式: OAuth
|
VS Code配置(.vscode/mcp.json):
1 2 3 4 5 6 7 8
| { "servers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com" } } }
|
方式二:本地MCP服务器
使用npx在本地启动,通过API Key认证:
1 2 3 4 5 6 7 8 9 10 11
| { "mcpServers": { "stripe": { "command": "npx", "args": ["-y", "@stripe/mcp", "--tools=all"], "env": { "STRIPE_SECRET_KEY": "sk_test_your_key_here" } } } }
|
你还可以通过--tools参数精确控制启用哪些工具:
1
| npx -y @stripe/mcp --tools=customers.create,products.list,payment_links.create
|
实际应用场景
场景1:SaaS订阅业务管理
1 2 3 4 5 6 7 8
| 用户: 查看这个月新增了多少付费客户, 以及总的MRR(月度经常性收入)是多少
AI: 本月数据汇总: - 新增付费客户: 47人 - 当前活跃订阅: 312个 - 本月MRR: $15,480 - 较上月增长: +8.3%
|
场景2:快速创建促销活动
1 2 3 4 5 6 7 8
| 用户: 创建一个"新年特惠"活动: 1) 创建优惠券 NEWYEAR2026,8折优惠 2) 为Pro Plan创建促销支付链接
AI: 已完成: - 优惠券 NEWYEAR2026 已创建(20% off) - 促销支付链接: https://buy.stripe.com/xxx (已应用优惠券,原价$29.99 -> $23.99/月)
|
场景3:退款和争议处理
1 2 3 4 5 6 7 8 9
| 用户: 查看过去一周的争议案例, 并为客户 cus_abc123 的最近一笔交易处理退款
AI: 过去7天争议情况: - 总计3笔争议 - 金额: $89.97 已为客户 cus_abc123 处理退款: - 退款金额: $29.99 - 退款ID: re_xxx
|
场景4:开发集成与调试
1 2 3 4 5 6
| 用户: 搜索Stripe文档,如何实现Webhook验证
AI: 根据Stripe文档,Webhook签名验证步骤: 1. 获取请求头中的 Stripe-Signature 2. 使用 endpoint secret 验证签名 [提供详细代码示例和最佳实践]
|
多框架集成
除了MCP协议,Stripe Agent Toolkit还直接支持多种AI代理框架:
| 框架 |
语言 |
包名 |
| OpenAI Agent SDK |
Python |
stripe-agent-toolkit |
| LangChain |
Python/TS |
stripe-agent-toolkit |
| CrewAI |
Python |
stripe-agent-toolkit |
| Vercel AI SDK |
TypeScript |
@stripe/agent-toolkit |
安全建议
Stripe官方强调以下安全最佳实践:
- 使用Sandbox环境: 开发和测试时务必使用测试密钥(sk_test_)
- 最小权限原则: 仅启用必需的工具,而非
--tools=all
- 评估非确定性: AI代理行为具有不确定性,建议在生产前充分测试
- 密钥安全: 远程模式优先使用OAuth,避免硬编码API Key
- Connected Accounts: 使用
context.account参数限制操作范围
总结
Stripe MCP Server 将支付业务管理的门槛降到了前所未有的低点。25个核心工具覆盖了从客户管理到订阅计费、从发票生成到争议处理的完整流程。远程+本地双部署模式兼顾了安全性和灵活性,再加上对主流AI代理框架的全面支持,使其成为构建AI驱动的金融科技应用的最佳基础设施之一。无论是运营人员日常管理支付业务,还是开发者构建智能商务助手,Stripe MCP Server都是值得认真考虑的选择。
评分: 4.60/5.0 | Stars: 1,200+ | 语言: TypeScript | 许可: MIT