名称: stripe-automation 描述: “通过Rube MCP（Composio）自动化Stripe任务：客户、收费、订阅、发票、产品、退款。始终首先搜索工具以获取当前模式。” 要求: mcp: [rube] 类别: 电商

通过Rube MCP的Stripe自动化

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

工具包文档: composio.dev/toolkits/stripe

先决条件

Rube MCP必须已连接（RUBE_SEARCH_TOOLS可用）
通过RUBE_MANAGE_CONNECTIONS与工具包stripe建立活动的Stripe连接
始终首先调用RUBE_SEARCH_TOOLS以获取当前工具模式

设置

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

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

核心工作流

1. 管理客户

何时使用: 用户想要创建、更新、搜索或列出Stripe客户

工具序列:

STRIPE_SEARCH_CUSTOMERS - 通过电子邮件/姓名搜索客户 [可选]
STRIPE_LIST_CUSTOMERS - 列出所有客户 [可选]
STRIPE_CREATE_CUSTOMER - 创建新客户 [可选]
STRIPE_POST_CUSTOMERS_CUSTOMER - 更新客户 [可选]

关键参数:

email: 客户电子邮件
name: 客户姓名
description: 客户描述
metadata: 键值元数据对
customer: 用于更新的客户ID（例如，‘cus_xxx’）

陷阱:

Stripe允许重复的客户具有相同的电子邮件；先搜索以避免重复
客户ID以’cus_'开头

2. 管理收费和支付

何时使用: 用户想要创建收费、支付意图，或查看收费历史

工具序列:

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

关键参数:

amount: 最小货币单位的金额（例如，USD的 cents）
currency: 三字母ISO货币代码（例如，‘usd’）
customer: 客户ID
payment_method: 支付方法ID
description: 收费描述

陷阱:

金额以最小货币单位表示（对于USD，100 = $1.00）
货币代码必须小写（例如，‘usd’ 不是 ‘USD’）
推荐使用支付意图流而不是直接收费

3. 管理订阅

何时使用: 用户想要创建、列出、更新或取消订阅

工具序列:

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

关键参数:

customer: 客户ID
items: 价格项数组（price_id和数量）
subscription: 用于检索/更新的订阅ID（例如，‘sub_xxx’）

陷阱:

订阅需要具有有效支付方法的有效客户
订阅项使用价格ID（而不是产品ID）
取消可以立即或周期结束时

4. 管理发票

何时使用: 用户想要创建、列出或搜索发票

工具序列:

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

关键参数:

customer: 客户ID用于发票
collection_method: ‘charge_automatically’ 或 ‘send_invoice’
days_until_due: 发票到期前的天数

陷阱:

发票默认自动完成；使用auto_advance: false用于草稿发票

5. 管理产品和价格

何时使用: 用户想要列出或搜索产品及其定价

工具序列:

STRIPE_LIST_PRODUCTS - 列出产品 [可选]
STRIPE_SEARCH_PRODUCTS - 搜索产品 [可选]
STRIPE_LIST_PRICES - 列出价格 [可选]
STRIPE_GET_PRICES_SEARCH - 搜索价格 [可选]

关键参数:

active: 按活动/非活动状态过滤
query: 搜索端点的查询

陷阱:

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

6. 处理退款

何时使用: 用户想要对收费进行退款

工具序列:

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

关键参数:

charge: 收费ID用于退款
amount: 部分退款金额（省略则为全额退款）
reason: 退款原因（‘duplicate’, ‘fraudulent’, ‘requested_by_customer’）

陷阱:

退款可能需要5-10个工作日出现在客户账单上
金额以最小货币单位表示

常见模式

金额格式

Stripe使用最小货币单位：

USD: $10.50 = 1050 cents
EUR: 10.50 = 1050 cents
JPY: 1000 = 1000（无小数）

分页

使用limit参数（最大100）
检查响应中的has_more
传递starting_after与最后一个对象ID用于下一页
继续直到has_more为false

已知陷阱

金额单位:

始终使用最小货币单位（USD/EUR的 cents）
零小数货币（JPY, KRW）直接使用金额

ID前缀:

客户: cus_, 收费: ch_, 订阅: sub_
发票: in_, 产品: prod_, 价格: price_
支付意图: pi_, 退款: re_

快速参考

任务	工具 slug	关键参数
创建客户	STRIPE_CREATE_CUSTOMER	email, name
搜索客户	STRIPE_SEARCH_CUSTOMERS	query
更新客户	STRIPE_POST_CUSTOMERS_CUSTOMER	customer, fields
列出收费	STRIPE_LIST_CHARGES	customer, limit
创建支付意图	STRIPE_CREATE_PAYMENT_INTENT	amount, currency
确认支付	STRIPE_CONFIRM_PAYMENT_INTENT	payment_intent
列出订阅	STRIPE_LIST_SUBSCRIPTIONS	customer
创建订阅	STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS	customer, items
更新订阅	STRIPE_UPDATE_SUBSCRIPTION	subscription, fields
列出发票	STRIPE_LIST_INVOICES	customer
创建发票	STRIPE_CREATE_INVOICE	customer
搜索发票	STRIPE_SEARCH_INVOICES	query
列出产品	STRIPE_LIST_PRODUCTS	active
搜索产品	STRIPE_SEARCH_PRODUCTS	query
列出价格	STRIPE_LIST_PRICES	product
搜索价格	STRIPE_GET_PRICES_SEARCH	query
列出退款	STRIPE_LIST_REFUNDS	charge
创建退款	STRIPE_CREATE_REFUND	charge, amount
支付方法	STRIPE_LIST_CUSTOMER_PAYMENT_METHODS	customer
结账会话	STRIPE_CREATE_CHECKOUT_SESSION	line_items
列出支付意图	STRIPE_LIST_PAYMENT_INTENTS	customer