Stripe MCP

stripe-mcp

Stripe の顧客、支払い、サブスクリプション、請求書、返金を照会するための、読み取り専用の MCP サーバーです。

MCP（Model Context Protocol）に対応したあらゆる AI やクライアントで使用できます。Cursor、Claude Desktop、Claude Code、Windsurf、その他の MCP ホストに対応しています。

特長

• 読み取り専用設計 — 請求、返金、更新、削除を行うツールはありません
• テストキーのみ — sk_live_ / rk_live_ での起動を拒否します
• 単一ファイル — index.js のみで、ビルド手順は不要です
• あらゆる MCP クライアントで動作 — Cursor、Claude、Windsurf などに対応しています

Cursor プラグイン

このリポジトリはエージェントプラグインであり、Cursor プラグインでもあります。cursor.directory が検出するのは、リポジトリのルートにコミットされたコンポーネントのみです。必要なファイルは次のとおりです。

ファイル	用途
mcp.json	MCP サーバーのエントリー（npx -y @devtechtricks/stripe-mcp）
plugin.json	Open Plugins のマニフェスト
.cursor-plugin/plugin.json	Cursor の掲載メタデータと STRIPE_SECRET_KEY 変数

これらのファイルを公開 GitHub リポジトリのデフォルトブランチに追加したら、cursor.directory/plugins/new で https://github.com/robinafaruqia/stripe-mcp を送信してください。インストール時に、STRIPE_SECRET_KEY に Stripe のテストキー（sk_test_... または rk_test_...）を設定します。

MCP の設定

Cursor — ワンクリックでインストール

インストール後、Stripe Dashboard から取得した Stripe のテスト用シークレット（sk_test_... または rk_test_...）で YOUR_STRIPE_TEST_KEY を置き換えます。読み取りスコープのみを持つ制限付きキーを推奨します。

npx を使用する（推奨）

MCP クライアントの設定に追加します（例：Cursor の場合は ~/.cursor/mcp.json または Settings → MCP、Claude の場合は claude_desktop_config.json など）。

{
  "mcpServers": {
    "stripe-mcp": {
      "command": "npx",
      "args": ["-y", "@devtechtricks/stripe-mcp"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

Claude Code：

claude mcp add stripe-mcp --env STRIPE_SECRET_KEY=sk_test_... -- npx -y @devtechtricks/stripe-mcp

ソースから実行する（開発用）

git clone https://github.com/robinafaruqia/stripe-mcp.git
cd stripe-mcp
npm install
cp .env.example .env   # then put your sk_test_ / rk_test_ key in .env

次に、MCP の設定に追加します。

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

STRIPE_SECRET_KEY がまだ設定されていない場合、index.js はパッケージディレクトリから .env を読み込みます。npm のインストールには .env は含まれません。MCP クライアントから env にキーを渡してください。

利用可能なツール

ツール	説明
list_customers	最近の顧客を一覧表示します。任意のパラメーター：limit、email。
get_customer	ID で顧客を取得します。必須パラメーター：customer_id。
list_payments	最近の支払いインテントを一覧表示します。任意のパラメーター：limit、customer_id。
get_payment	ID で支払いインテントを取得します。必須パラメーター：payment_intent_id。
list_subscriptions	サブスクリプションを一覧表示します。任意のパラメーター：limit、customer_id、status。
get_subscription	ID でサブスクリプションを取得します。必須パラメーター：subscription_id。
list_invoices	請求書を一覧表示します。任意のパラメーター：limit、customer_id、status。
list_refunds	返金を一覧表示します。任意のパラメーター：limit、payment_intent_id。

例

1. list_customers({ limit: 5 })
2. get_customer({ customer_id: "cus_ABC123" })
3. list_subscriptions({ customer_id: "cus_ABC123" })
4. list_payments({ limit: 10 })

ライセンス

MIT