Stripe
決済データ、売上、サブスクリプション、顧客情報を分析します。APIキー認証で簡単に接続できます。
概要
Stripe連携は、Pressoを通じてStripeの決済データをClaude Codeに接続します。売上、サブスクリプション、顧客、請求書、払い戻しなどのデータに自然言語で即座にアクセスできます。
Stripeダッシュボードでレポートを確認する代わりに、Claude Codeに「今月の売上はいくら?」と聞くだけで、即座に実用的な分析結果が得られます。
セットアップ
前提条件
- アクティブなStripeアカウント
- アクティブなサブスクリプションのあるPressoアカウント
- Presso MCPサーバーが設定されたClaude Code
Restricted API Keyの作成
Pressoとの接続には、読み取り専用のRestricted API Keyを使用します。
- Stripeダッシュボードを開きます。
- API Keys セクションで Create restricted key をクリックします。
- 以下の権限を Read に設定します:
- Charges
- Customers
- Disputes
- Invoices
- PaymentIntents
- Payouts
- Plans / Prices
- Products
- Subscriptions
- Balance
- Coupons
- キーを作成し、
rk_live_...形式のキーをコピーします。
重要: Secret Key(
sk_live_...)ではなく、必ず読み取り専用のRestricted Key(rk_live_...)を使用してください。
Stripeの接続
- Pressoダッシュボードを開きます。
- Add Connection をクリックし、Stripe を選択します。
- 作成したRestricted API Keyを入力します。
- キーが検証され、接続が完了すると緑色の Connected ステータスで表示されます。
注意: Pressoは読み取り専用アクセスのみを使用します。決済の作成、顧客情報の変更、サブスクリプションの操作を行うことはできません。
利用可能なツール
Stripe連携では、17種類のツールが利用できます。
アカウント・残高
| ツール | 説明 |
|---|---|
stripe_get_account | Stripeアカウント情報を取得 |
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_intents | PaymentIntent一覧を取得 |
stripe_search_charges | Stripeクエリ言語で課金を検索 |
サブスクリプション・請求書
| ツール | 説明 |
|---|---|
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>1000 | 1,000円(最小通貨単位)以上の課金 |
customer:'cus_xxx' | 特定の顧客の課金 |
status:'succeeded' AND amount>5000 | 複合条件での検索 |
注意: 金額は最小通貨単位(日本円の場合は円)で指定します。
クエリ例
売上分析
今月の売上合計を表示して。
過去30日間の日次売上推移を見せて。
直近の払い戻しとチャージバックを確認して。
サブスクリプション分析
アクティブなサブスクリプションの総数と月次収益を教えて。
過去1ヶ月でキャンセルされたサブスクリプションはいくつある?
プラン別のサブスクリプション内訳を表示して。
顧客分析
最も支払額が多い顧客を表示して。
このメールアドレスの顧客の決済履歴を確認して。
入金・残高
今の残高(利用可能額と保留額)を教えて。
直近の銀行口座への入金一覧を表示して。
今月の残高トランザクションの内訳を見せて。
ヒントとベストプラクティス
- Restricted Keyを使用する。 Secret Key(sk_live_)ではなく、必ずRestricted Key(rk_live_)を使用してください。必要最小限の権限だけを付与することでセキュリティを確保できます。
- 金額は最小通貨単位。 Stripe APIの金額はすべて最小通貨単位で返されます(日本円の場合は円、米ドルの場合はセント)。
- ページネーションを活用する。 大量のデータを取得する場合、
limitとstarting_afterパラメータで効率的にページングできます。 - 検索クエリで高度な分析を。
stripe_search_chargesは複合条件での検索が可能です。特定の条件に合う取引を素早く見つけられます。
制限事項
- すべてのツールは読み取り専用です。決済の作成や変更はできません。
- 1回のリクエストで取得できるデータは最大100件です。それ以上のデータはページネーションで取得します。
- Stripe APIのレート制限が適用されます。
- テスト環境のデータにアクセスするには、テスト用のRestricted Keyを使用してください。