Stripe

決済データ、売上、サブスクリプション、顧客情報を分析します。APIキー認証で簡単に接続できます。

概要

Stripe連携は、Pressoを通じてStripeの決済データをClaude Codeに接続します。売上、サブスクリプション、顧客、請求書、払い戻しなどのデータに自然言語で即座にアクセスできます。

Stripeダッシュボードでレポートを確認する代わりに、Claude Codeに「今月の売上はいくら?」と聞くだけで、即座に実用的な分析結果が得られます。

セットアップ

前提条件

  • アクティブなStripeアカウント
  • アクティブなサブスクリプションのあるPressoアカウント
  • Presso MCPサーバーが設定されたClaude Code

Restricted API Keyの作成

Pressoとの接続には、読み取り専用のRestricted API Keyを使用します。

  1. Stripeダッシュボードを開きます。
  2. API Keys セクションで Create restricted key をクリックします。
  3. 以下の権限を Read に設定します:
    • Charges
    • Customers
    • Disputes
    • Invoices
    • PaymentIntents
    • Payouts
    • Plans / Prices
    • Products
    • Subscriptions
    • Balance
    • Coupons
  4. キーを作成し、rk_live_... 形式のキーをコピーします。

重要: Secret Key(sk_live_...)ではなく、必ず読み取り専用のRestricted Key(rk_live_...)を使用してください。

Stripeの接続

  1. Pressoダッシュボードを開きます。
  2. Add Connection をクリックし、Stripe を選択します。
  3. 作成したRestricted API Keyを入力します。
  4. キーが検証され、接続が完了すると緑色の Connected ステータスで表示されます。

注意: Pressoは読み取り専用アクセスのみを使用します。決済の作成、顧客情報の変更、サブスクリプションの操作を行うことはできません。

利用可能なツール

Stripe連携では、17種類のツールが利用できます。

アカウント・残高

ツール説明
stripe_get_accountStripeアカウント情報を取得
stripe_retrieve_balance現在のアカウント残高(利用可能額・保留額)を取得
stripe_list_balance_transactions残高トランザクション(入金・出金の明細)を一覧表示

顧客

ツール説明
stripe_list_customers顧客一覧を取得(メールでフィルタ可能)
stripe_get_customer特定の顧客の詳細情報を取得

商品・価格

ツール説明
stripe_list_products商品一覧を取得
stripe_list_prices価格プラン一覧を取得(商品IDでフィルタ可能)

決済

ツール説明
stripe_list_charges課金一覧を取得(顧客IDでフィルタ可能)
stripe_list_payment_intentsPaymentIntent一覧を取得
stripe_search_chargesStripeクエリ言語で課金を検索

サブスクリプション・請求書

ツール説明
stripe_list_subscriptionsサブスクリプション一覧を取得(ステータスでフィルタ可能)
stripe_get_subscription特定のサブスクリプションの詳細を取得
stripe_list_invoices請求書一覧を取得(ステータスでフィルタ可能)

払い戻し・チャージバック

ツール説明
stripe_list_refunds払い戻し一覧を取得
stripe_list_disputesチャージバック・紛争一覧を取得

クーポン・入金

ツール説明
stripe_list_couponsクーポン一覧を取得
stripe_list_payouts銀行口座への入金一覧を取得

課金検索のクエリ言語

stripe_search_charges では、Stripeのクエリ言語を使って高度な検索ができます。

クエリ例説明
status:'succeeded'成功した課金のみ
amount>10001,000円(最小通貨単位)以上の課金
customer:'cus_xxx'特定の顧客の課金
status:'succeeded' AND amount>5000複合条件での検索

注意: 金額は最小通貨単位(日本円の場合は円)で指定します。

クエリ例

売上分析

今月の売上合計を表示して。
過去30日間の日次売上推移を見せて。
直近の払い戻しとチャージバックを確認して。

サブスクリプション分析

アクティブなサブスクリプションの総数と月次収益を教えて。
過去1ヶ月でキャンセルされたサブスクリプションはいくつある?
プラン別のサブスクリプション内訳を表示して。

顧客分析

最も支払額が多い顧客を表示して。
このメールアドレスの顧客の決済履歴を確認して。

入金・残高

今の残高(利用可能額と保留額)を教えて。
直近の銀行口座への入金一覧を表示して。
今月の残高トランザクションの内訳を見せて。

ヒントとベストプラクティス

  • Restricted Keyを使用する。 Secret Key(sk_live_)ではなく、必ずRestricted Key(rk_live_)を使用してください。必要最小限の権限だけを付与することでセキュリティを確保できます。
  • 金額は最小通貨単位。 Stripe APIの金額はすべて最小通貨単位で返されます(日本円の場合は円、米ドルの場合はセント)。
  • ページネーションを活用する。 大量のデータを取得する場合、limitstarting_after パラメータで効率的にページングできます。
  • 検索クエリで高度な分析を。 stripe_search_charges は複合条件での検索が可能です。特定の条件に合う取引を素早く見つけられます。

制限事項

  • すべてのツールは読み取り専用です。決済の作成や変更はできません。
  • 1回のリクエストで取得できるデータは最大100件です。それ以上のデータはページネーションで取得します。
  • Stripe APIのレート制限が適用されます。
  • テスト環境のデータにアクセスするには、テスト用のRestricted Keyを使用してください。

次のステップ

  • Shopify連携 — Stripeの決済データとShopifyの注文データを組み合わせた分析ができます。
  • ユースケース — 売上分析やサブスクリプション管理の実践例を紹介します。