What is Advanced Stripe Mcp Server

The advanced-stripe-mcp-server is a server that utilizes the Model Context Protocol (MCP) to manage and operate multiple Stripe accounts seamlessly. It allows integration with AI assistants like Claude, enabling natural language queries and operations on Stripe account data.

Use cases

Use cases include efficient management of multiple accounts, quick customer support through name or email searches, financial management by tracking unpaid invoices, and automating operations using AI with natural language commands.

How to use

To use advanced-stripe-mcp-server, first set up the environment by ensuring you have Node.js (v18 or higher) and npm (v8 or higher). Clone the repository, install the dependencies, and build the server using the provided commands.

Key features

Key features include integrated management of multiple Stripe accounts, customer-related functionalities such as searching by name or email, subscription management, and invoice handling including listing and searching invoices based on various criteria.

Where to use

This server is suitable for businesses that manage multiple Stripe accounts, particularly in sectors like e-commerce, subscription services, and any organization requiring efficient financial and customer management.

日本語ドキュメント: advanced-stripe-mcp-server について

このプロジェクトについて

advanced-stripe-mcp-serverは、MCPプロトコル（Model Context Protocol）を活用して、複数のStripeアカウントを横断的に管理・操作することを可能にするサーバーです。このサーバーをClaudeなどのAIアシスタントと連携させることで、自然言語を使ってStripeアカウントのデータを検索・操作することができるようになります。

主な機能

複数Stripeアカウントの統合管理

• 複数のStripeアカウントを一元管理
• すべてのアカウントを横断して検索・操作が可能
• 特定のアカウントに限定した操作も簡単に実行可能

顧客（Customer）関連機能

• 名前による顧客検索（search_stripe_customer_by_name）
• メールアドレスによる顧客検索（search_stripe_customer_by_email）

サブスクリプション関連機能

• 顧客ID、ステータス、商品IDなどによるサブスクリプション検索（search_stripe_subscriptions）

請求書（Invoice）関連機能

• 請求書リスト取得（list_stripe_invoices）
• 請求書ID指定による詳細情報取得（get_stripe_invoice_by_id）
• 顧客、ステータス、金額、サブスクリプションIDなどによる請求書検索（search_stripe_invoices）

利用例（スクリーンショット）

メールドメインベースでの調査分析

請求書の検索

サブスクリプション分析

Claude Desktopの分析（アナリティクス）機能を使えば、グラフなども作れます。

このMCPサーバーで解決できる業務課題

1. 複数アカウント管理の効率化:

   • 異なるStripeアカウントのデータを切り替えずに一度に検索・閲覧可能
   • アカウントをまたいだデータの比較や分析が容易に

2. 顧客サポート業務の効率化:

   • 顧客からの問い合わせに対して、名前やメールアドレスから素早く顧客情報を検索
   • サブスクリプション状況や請求書履歴を迅速に確認

3. 経理・財務管理の支援:

   • 請求書ステータスや金額による検索で未払い請求書の確認が容易に
   • 複数アカウントの請求状況を一元的に把握

4. AI連携による業務自動化:

   • 「先月の未払い請求書をすべて表示して」などの自然言語での操作
   • データ分析や傾向把握をAIに依頼可能

使い方

1. セットアップ

必要条件

• Node.js (v18以上)
• npm (v8以上)
• Stripe APIキー（複数アカウント分）

インストール手順

1. リポジトリをクローン:

git clone https://github.com/yourusername/advanced-stripe-mcp-server.git
cd advanced-stripe-mcp-server

2. 依存パッケージのインストール:

npm install

3. サーバーのビルド:

npm run build

2. 設定

Claude DesktopでMCPサーバーを使用するには、以下の設定ファイルを編集します:

• macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windowsの場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "advanced-stripe-mcp-server": {
      "command": "/path/to/advanced-stripe-mcp-server/build/index.js",
      "env": {
        "STRIPE_AMIMOTO_ACCOUNT_APIKEY": "Amimotoの制限つきAPIキー",
        "STRIPE_SHIFTER_ACCOUNT_APIKEY": "Shifterの制限つきAPIキー",
        "STRIPE_FINANSCOPE_ACCOUNT_APIKEY": "FinanScopeの制限つきAPIキー"
      }
    }
  }
}

2.1. コマンドのパスを取得する方法

commandのパスは、npm run buildを実行した場所（ディレクトリ）で、以下のコマンドを実行します。

echo "\"$(pwd)/build/index.js\""

これでcommandに記述すべきパスが表示されます。
例: "/Users/dc-okamotohidetaka/development/mcp-servers/advanced-stripe-mcp-server/build/index.js"

macOSの場合、echo "\"$(pwd)/build/index.js\"" | pbcopyでコピーまでできます。

2.2. Stripe APIキーの生成方法

セキュリティリスク、インシデント発生リスク削減のため、「シークレットキー」の利用は禁止しています。
sk_から始まるAPIキーを設定すると、エラーが出ますのでご了承ください。

制限つきAPIキーは、ユーザーごとに発行してください。AWSと一緒です。
作り方は、Stripe のドキュメントを参考にしましょう。
権限は、「読み込み」の権限を全部につけておけばOKです。不安な方は @hidetaka まで。

3. 使用例

Claude Desktopにて、以下のような自然言語クエリが可能になります:

• 「顧客の田中さんの最近の請求書を検索して」
• 「先月の未払いの請求書をすべて表示して」
• 「[email protected]に関連するサブスクリプションの状態を教えて」
• 「1st_accountとall_accountの両方で、最近キャンセルされたサブスクリプションを比較して」

3.1. データ取得に関する注意

Stripe APIの仕様および生成AIのコンテキストウィンドウの制限により、1アカウントあたり最大100件までのデータしか取得できません。この制限については将来的に改善を検討しています。

「全件取ってきて」というと、「全アカウントのデータを完全に取得するには、表示されたnext_pageパラメータを使用して追加の請求書を取得する必要があります。」のようなメッセージが出てきます。その場合は、「続けて」のように指示してください。

4. デバッグ

MCPサーバーのデバッグには、MCP Inspectorを使用できます:

npm run inspector

これにより、ブラウザでデバッグツールにアクセスするためのURLが表示されます。

開発者向け情報

ディレクトリ構造

• src/index.ts: メインサーバーファイル（ツール定義など）
• src/libs/: Stripe操作の基本クラスや共通関数
• src/operations/: 各種Stripe操作（顧客、サブスクリプション、請求書など）

追加機能の開発

新しいStripe API機能を追加する場合は、以下の手順に従ってください:

1. src/operations/に新しい操作を定義
2. src/index.tsに新しいツールとして登録
3. テストを作成して機能を検証

環境変数

• STRIPE_*_ACCOUNT_APIKEY: 各Stripeアカウントのシークレットキー