Stripe Mcp Server

Stripe MCP サーバー

Claude（または任意の MCP クライアント）を Stripe アカウントに接続する Model Context Protocol（MCP）サーバーです。顧客、売上、請求書、サブスクリプション、異議申し立てを確認したり、自然言語で返金を実行したりできます。

要件

• Node.js 18+
• シークレット API キーを持つ Stripe アカウント

インストール

git clone https://github.com/your-username/stripe-mcp-server.git
cd stripe-mcp-server
npm install
cp .env.example .env
# Edit .env and set STRIPE_SECRET_KEY

手動での実行

STRIPE_SECRET_KEY=sk_live_... node index.js

Claude Desktop の設定

次の内容を claude_desktop_config.json に追加します（macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "stripe": {
      "command": "node",
      "args": ["/absolute/path/to/stripe-mcp-server/index.js"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_live_..."
      }
    }
  }
}

編集後、Claude Desktop を再起動します。

ツール

ツール	説明	パラメーター
list_customers	Stripe の最近の顧客を一覧表示します	limit（1～100、デフォルトは 10）
get_revenue	指定した期間の成功した請求による総売上を取得します	from（YYYY-MM-DD）、to（YYYY-MM-DD）
list_invoices	ステータス別に請求書を一覧表示します（open = 未払い）	status（draft | open | paid | uncollectible | void）
list_failed_payments	失敗理由とともに最近の失敗した請求を一覧表示します	limit（1～100、デフォルトは 10）
get_subscription	顧客のすべてのサブスクリプションを取得します	customer_id（例：cus_...）
create_refund	全額または一部の返金を実行します	charge_id（例：ch_...）、amount（セント単位、省略可）
list_disputes	証拠提出期限とともに異議申し立て／チャージバックを一覧表示します	limit（1～100、デフォルトは 10）

プロンプトの例

• 「直近の顧客を 20 件一覧表示して」
• 「2025 年 5 月の売上はいくら？」
• 「未払いの請求書をすべて表示して」
• 「最近、どの支払いが失敗した？」
• 「顧客 cus_ABC123 のサブスクリプションを取得して」
• 「請求 ch_XYZ を 10 ドル返金して」
• 「未解決の異議申し立てはある？」

セキュリティ

• .env ファイルをコミットしたり、シークレットキーをハードコードしたりしないでください。
• ユースケースに必要な権限だけを持つ制限付きキーを使用してください。
• 開発には sk_test_... キーを使用してください。

ライセンス

MIT