stripe-automation

Rube MCP による Stripe の自動化

Rube MCP を介して Composio の Stripe ツールキットを使い、Stripe の決済業務を自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット stripe を指定した RUBE_MANAGE_CONNECTIONS による有効な Stripe 接続
• 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の入手：クライアントの設定で、https://rube.app/mcp を MCP サーバーとして追加します。MCP エンドポイントを利用するには、インストール済みの Rube サービスから返されるプロバイダー接続と認証フローも必要です。URL を追加しただけでは、アカウントへのアクセス権は付与されません。

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：通貨の最小単位で指定する金額（例：USD のセント）
• currency：3 文字の ISO 通貨コード（例：'usd'）
• customer：顧客 ID
• payment_method：決済方法 ID
• description：請求の説明

注意点：

• 金額は通貨の最小単位で指定します（USD の場合、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 - 請求書を一覧表示する [Optional]
2. STRIPE_SEARCH_INVOICES - 請求書を検索する [Optional]
3. STRIPE_CREATE_INVOICE - 請求書を作成する [Optional]

主なパラメーター：

• customer：請求書の顧客 ID
• collection_method：'charge_automatically' または 'send_invoice'
• days_until_due：請求書の支払期限までの日数

注意点：

• 意図する請求書のワークフローに従って、auto_advance を明示的に設定してください。ツールや API のデフォルト値を前提にしないでください。下書きの準備は、確定、支払い、メール配信を許可するものではありません。

5. 商品と価格を管理する

使用する状況：ユーザーが商品とその価格の一覧表示や検索を希望している場合

ツールの実行順序：

1. STRIPE_LIST_PRODUCTS - 商品を一覧表示する [Optional]
2. STRIPE_SEARCH_PRODUCTS - 商品を検索する [Optional]
3. STRIPE_LIST_PRICES - 価格を一覧表示する [Optional]
4. STRIPE_GET_PRICES_SEARCH - 価格を検索する [Optional]

主なパラメーター：

• active：有効／無効の状態でフィルタリングします
• query：検索エンドポイントで使用する検索クエリ

注意点：

• 商品と価格は別々のオブジェクトです。1 つの商品に複数の価格を設定できます
• 価格 ID（例：'price_xxx'）は、サブスクリプションとチェックアウトで使用します

6. 返金を処理する

使用する状況：ユーザーが請求に対する返金を希望している場合

ツールの実行順序：

1. STRIPE_LIST_REFUNDS - 返金を一覧表示する [Optional]
2. STRIPE_POST_CHARGES_CHARGE_REFUNDS - 返金を作成する [Optional]
3. STRIPE_CREATE_REFUND - Payment Intent 経由で返金を作成する [Optional]

主なパラメーター：

• charge：返金対象の請求 ID
• amount：一部返金の金額（全額返金の場合は省略）
• reason：返金理由（'duplicate'、'fraudulent'、'requested_by_customer'）

注意点：

• 返金が顧客の明細に反映されるまで、5～10 営業日かかることがあります
• 金額は通貨の最小単位で指定します

よくあるパターン

金額の形式

Stripe では通貨の最小単位を使用します：

• USD：$10.50 = 1050 セント
• EUR：10.50 = 1050 セント
• JPY：1000 = 1000（小数なし）

ページネーション

• limit パラメーターを使用します（最大 100）
• レスポンスの has_more を確認します
• 次のページを取得するには、最後のオブジェクト ID を starting_after に渡します
• has_more が false になるまで続けます

既知の注意点

金額の単位：

• 常に通貨の最小単位を使用します（USD／EUR ではセント）
• 小数を使用しない通貨（JPY、KRW）では、金額をそのまま指定します

ID のプレフィックス：

• 顧客：cus_、請求：ch_、サブスクリプション：sub_
• 請求書：in_、商品：prod_、価格：price_
• Payment Intents：pi_、返金：re_

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
顧客を作成する	STRIPE_CREATE_CUSTOMER	email, name
顧客を検索する	STRIPE_SEARCH_CUSTOMERS	query
顧客を更新する	STRIPE_POST_CUSTOMERS_CUSTOMER	customer, fields
請求を一覧表示する	STRIPE_LIST_CHARGES	customer, limit
Payment Intent を作成する	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
Payment Intent を一覧表示する	STRIPE_LIST_PAYMENT_INTENTS	customer

使用するタイミング

概要で説明されているワークフローまたはアクションを実行する場合に、このスキルを使用できます。

例

ユーザーのリクエスト：

Rube MCP（Composio）を介してStripeのタスクを自動化してください。対象：顧客、請求、サブスクリプション、請求書、商品、返金。

制限事項

• タスクが上記で説明されている範囲に明確に一致する場合にのみ、このスキルを使用してください。
• 環境固有の検証、テスト、専門家によるレビューの代わりとして、出力を扱わないでください。
• 必要な入力、権限、安全上の境界、成功基準が不足している場合は、作業を中断して確認してください。

接続されているアカウント、テストモードか本番モードか、通貨ごとの最小単位での金額、通貨、顧客、意図する財務上の影響を正確に確認してください。検索結果が一致しても、承認があることの証明にはならず、競合状態も防げません。書き込みにはプロバイダーがサポートする冪等性キーを使用し、再試行時も同じキーを保持してください。結果が不明な場合は、別の請求、返金、サブスクリプション変更を行う前に照合してください。決済データや顧客データ全体をログに記録したり、ツールの呼び出しから決済の完了を推測したりしないでください。