stripe-automation

Rube MCP を介した Stripe の自動化

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

ツールキットのドキュメント：composio.dev/toolkits/stripe

前提条件

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

セットアップ

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：最小通貨単位での金額（例：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 - 請求書を一覧表示します［任意］
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：検索エンドポイントの検索クエリ

注意点：

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

6. 返金を処理する

使用するタイミング：ユーザーが請求に対する返金を希望している場合

ツールの手順：

1. STRIPE_LIST_REFUNDS - 返金を一覧表示します［任意］
2. STRIPE_POST_CHARGES_CHARGE_REFUNDS - 返金を作成します［任意］
3. STRIPE_CREATE_REFUND - 支払いインテント経由で返金を作成します［任意］

主なパラメーター：

• 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_
• 支払いインテント：pi_、返金：re_

クイックリファレンス

タスク	ツールのスラッグ	主なパラメーター
顧客を作成	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

---

Composio によって提供