---

name: stripe-automation description: "通过 Rube MCP (Composio) 自动化 Stripe 任务：客户、收费、订阅、发票、产品、退款。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Stripe 自动化

通过 Composio 的 Stripe 工具包经由 Rube MCP 自动化 Stripe 支付操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 stripe 建立活跃的 Stripe 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 通过确认 RUBE_SEARCH_TOOLS 响应来验证 Rube MCP 可用
2. 使用工具包 stripe 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Stripe 连接
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 管理客户

适用场景：用户想要创建、更新、搜索或列出 Stripe 客户

工具序列：

1. STRIPE_SEARCH_CUSTOMERS - 按邮箱/姓名搜索客户 [可选]
2. STRIPE_LIST_CUSTOMERS - 列出所有客户 [可选]
3. STRIPE_CREATE_CUSTOMER - 创建新客户 [可选]
4. STRIPE_POST_CUSTOMERS_CUSTOMER - 更新客户 [可选]

关键参数：

• email：客户邮箱
• name：客户姓名
• description：客户描述
• metadata：键值对元数据
• customer：用于更新的客户 ID（如 'cus_xxx'）

注意事项：

• Stripe 允许相同邮箱的重复客户；先搜索以避免重复
• 客户 ID 以 'cus_' 开头

2. 管理收费和支付

适用场景：用户想要创建收费、支付意图或查看收费历史

工具序列：

1. STRIPE_LIST_CHARGES - 带过滤器列出收费 [可选]
2. STRIPE_CREATE_PAYMENT_INTENT - 创建支付意图 [可选]
3. STRIPE_CONFIRM_PAYMENT_INTENT - 确认支付意图 [可选]
4. STRIPE_POST_CHARGES - 创建直接收费 [可选]
5. STRIPE_CAPTURE_CHARGE - 捕获已授权的收费 [可选]

关键参数：

• amount：最小货币单位的金额（如美元的分）
• currency：三字母 ISO 货币代码（如 'usd'）
• customer：客户 ID
• payment_method：支付方式 ID
• description：收费描述

注意事项：

• 金额以最小货币单位表示（100 = $1.00 美元）
• 货币代码必须小写（如 'usd' 而非 'USD'）
• 支付意图是推荐的流程，优于直接收费

3. 管理订阅

适用场景：用户想要创建、列出、更新或取消订阅

工具序列：

1. STRIPE_LIST_SUBSCRIPTIONS - 列出订阅 [可选]
2. STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS - 创建订阅 [可选]
3. STRIPE_RETRIEVE_SUBSCRIPTION - 获取订阅详情 [可选]
4. STRIPE_UPDATE_SUBSCRIPTION - 修改订阅 [可选]

关键参数：

• customer：客户 ID
• items：价格项数组（price_id 和 quantity）
• subscription：用于检索/更新的订阅 ID（如 'sub_xxx'）

注意事项：

• 订阅需要有效的客户和支付方式
• 使用价格 ID（非产品 ID）作为订阅项
• 取消可以立即生效或在周期结束时生效

4. 管理发票

适用场景：用户想要创建、列出或搜索发票

工具序列：

1. STRIPE_LIST_INVOICES - 列出发票 [可选]
2. STRIPE_SEARCH_INVOICES - 搜索发票 [可选]
3. STRIPE_CREATE_INVOICE - 创建发票 [可选]

关键参数：

• customer：发票的客户 ID
• collection_method：'charge_automatically' 或 'send_invoice'
• days_until_due：发票到期天数

注意事项：

• 发票默认自动定稿；使用 auto_advance: false 保持草稿状态

5. 管理产品和价格

适用场景：用户想要列出或搜索产品及其定价

工具序列：

1. STRIPE_LIST_PRODUCTS - 列出产品 [可选]
2. STRIPE_SEARCH_PRODUCTS - 搜索产品 [可选]
3. STRIPE_LIST_PRICES - 列出价格 [可选]
4. STRIPE_GET_PRICES_SEARCH - 搜索价格 [可选]

关键参数：

• active：按活跃/非活跃状态过滤
• query：搜索端点的搜索查询

注意事项：

• 产品和价格是独立对象；一个产品可以有多个价格
• 价格 ID（如 'price_xxx'）用于订阅和结账

6. 处理退款

适用场景：用户想要对收费进行退款

工具序列：

1. STRIPE_LIST_REFUNDS - 列出退款 [可选]
2. STRIPE_POST_CHARGES_CHARGE_REFUNDS - 创建退款 [可选]
3. STRIPE_CREATE_REFUND - 通过支付意图创建退款 [可选]

关键参数：

• charge：收费 ID
• amount：退款金额（部分退款）
• reason：退款原因

注意事项：

• 退款不能超过原始收费金额
• 部分退款是允许的
• 退款可能需要 5-10 个工作日才能显示在客户账单上

重要规则

1. 始终先搜索工具：在执行任何操作前调用 RUBE_SEARCH_TOOLS 获取当前 schema
2. 验证连接：确保 Stripe 连接处于 ACTIVE 状态
3. 确认操作：对于破坏性操作（取消、退款），在执行前与用户确认
4. 处理错误：优雅地处理 API 错误并向用户报告
5. 金额格式：始终使用最小货币单位（分）