Razorpay Mcp

razorpay-mcp

Claude などの AI アシスタントを Razorpay アカウントに直接接続する MCP（Model Context Protocol）サーバーです。設定すると、コードを書かずに自然言語で AI に決済情報の取得、収益傾向の分析、失敗した取引の確認、サブスクリプションの監視、リアルタイムのビジネスダッシュボードの表示を依頼できます。

クイックスタート

# Clone
git clone https://github.com/indiamcp/razorpay-mcp

# Install
cd razorpay-mcp
npm install

# Configure
cp .env.example .env
# Add your Razorpay API keys to .env

# Build
npm run build

# Run
npm start

Claude Desktop のセットアップ

claude_desktop_config.json に以下を追加します（macOS では通常 ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json にあります）。

{
  "mcpServers": {
    "razorpay": {
      "command": "node",
      "args": ["/path/to/razorpay-mcp/dist/index.js"],
      "env": {
        "RAZORPAY_KEY_ID": "rzp_test_xxxxxxxxxxxx",
        "RAZORPAY_KEY_SECRET": "your_secret_here"
      }
    }
  }
}

または、npx を使用します（公開後）。

{
  "mcpServers": {
    "razorpay": {
      "command": "npx",
      "args": ["-y", "@indiamcp/razorpay-mcp"],
      "env": {
        "RAZORPAY_KEY_ID": "rzp_test_xxxxxxxxxxxx",
        "RAZORPAY_KEY_SECRET": "your_secret_here"
      }
    }
  }
}

利用可能なツール

ツール	説明	主なパラメーター
get_payment	ID を指定して特定の決済情報を取得	payment_id
list_payments	フィルターを指定して決済情報を一覧表示	from、to、count、status
get_payment_analytics	収益、成功率、決済方法の内訳	from、to
get_order	ID を指定して特定の注文情報を取得	order_id
list_orders	フィルターを指定して注文情報を一覧表示	from、to、count、status、receipt
get_customer	ID を指定して特定の顧客情報を取得	customer_id
list_customers	顧客情報を一覧表示	count、skip
get_subscription	ID を指定して特定のサブスクリプション情報を取得	subscription_id
list_subscriptions	フィルターを指定してサブスクリプションを一覧表示	from、to、count、status
get_subscription_analytics	有効なサブスクリプション数、解約率、次回更新予定	from、to
get_refund	特定の返金情報を取得	payment_id、refund_id
list_refunds	決済の返金情報を一覧表示	payment_id、count
get_dashboard_summary	ビジネスの健全性を確認 — 今日、今週、今月の収益	(なし)
get_failed_payment_analysis	決済方法および銀行別の失敗理由	from、to

プロンプトの例

接続したら、Claude に次のように尋ねてみてください。

• 「過去 7 日間に失敗した決済と、その理由をすべて表示して」
• 「今月の総収益はいくら？」
• 「有効なサブスクリプションをすべて一覧表示して」
• 「顧客がよく使う決済方法は？」
• 「今週登録した顧客を表示して」
• 「今月のサブスクリプション解約率は？」
• 「決済 pay_xxxxx を探して」
• 「保留中の返金はいくつある？」
• 「今日のビジネスダッシュボードの概要を表示して」
• 「過去 30 日間の決済失敗を分析して」

セキュリティに関する注意

• 環境変数のみを使用 — API キーは環境変数から読み取られ、ハードコードもログへの記録もされません
• v1 では読み取り専用 — このサーバーはデータの取得のみを行います。決済の作成、返金の実行、レコードの変更はできません
• データを保存しません — 決済データがこのサーバーによって永続化またはキャッシュされることはありません
• 開発時にはテストキーを使用 — Razorpay のテストキー（rzp_test_*）は安全で、実際の請求は発生しません

開発

# Run in dev mode (no build needed)
npm run dev

# Type check
npm run lint

# Run tests
npm test

---

IndiaMCP の一部

このサーバーは、インドの API スタック向けオープンソース MCP サーバー群 IndiaMCP の一部です。

github.com/indiamcp