用途:在 Stripe 上执行账单与支付运营操作,包括客户、产品、价格、发票、支付链接、订阅、退款、争议和余额。MCP 为可选项,可通过 MCP(自动)、Stripe CLI 或 Dashboard 执行,具体见 BACKENDS.md。
主要能力与工作流:创建客户前先按邮箱搜索/列出以避免重复;创建产品与价格时先列出产品检查是否已存在,再 create_product 与 create_price;创建并发送发票依次为确认客户 ID、create_invoice、create_invoice_item、finalize_invoice,返回 inv_xxx 与 hosted_invoice_url;创建支付链接先确认价格 ID,再 create_payment_link 并返回链接 URL;退款先 list_payment_intents 定位支付,展示 pi_xxx、金额与客户信息,确认后 create_refund;取消订阅先 list_subscriptions 定位,展示 sub_xxx、状态与下次账单日,确认立即取消或期末取消后执行。
三条硬性规则:写前先读,创建客户/产品/价格前检查是否已存在;资金操作需确认,退款、订阅变更、争议更新执行前必须确认;不确定时先搜索,不要猜测对象 ID 或参数。
安全规则:读取类(list、get、search)直接执行;创建类(客户、产品、价格、发票)先查重;资金类(退款、订阅取消/更新、争议)需展示详情、等待确认、再执行。默认测试模式,实时模式需明确说明“live mode”并二次确认。危险操作包括 create_refund、cancel_subscription、update_subscription、update_dispute,执行前需展示对象 ID 与关键字段、说明金额/时间/后果、等待明确确认,再执行并返回结果、对象 ID 与状态。
默认配置:货币优先用户指定,其次沿用已有对象货币,否则询问;金额接受小数并自动转换为最小单位(如 $19.99 → 1999);输出对象类型、ID、关键字段与后续步骤。
限制:标准工具不支持直接创建 PaymentIntent/扣款、创建订阅(仅可列出/更新/取消)、创建促销码(仅优惠券)、删除对象,这些需使用 Dashboard 或 API。文件式流水线使用 runs/<workflow>/active/<run_id>/ 目录,含 proposal.md、context.json、tasks.md、evidence/stripe-actions.md、evidence/receipt.md 与 logs/events.jsonl。错误处理:对象不存在则搜索正确 ID;参数错误查文档;权限不足检查 API key 范围;网络错误重试或检查连接。相关文件:BACKENDS.md、SETUP.md、tools.md。