Razorpay MCP Server (Official)

Razorpay MCP サーバー（公式）

Razorpay MCP サーバーは、Razorpay API とシームレスに連携する Model Context Protocol（MCP） サーバーです。開発者や AI ツールに高度な決済処理機能を提供します。

クイックスタート

お好みのセットアップ方法を選択してください。

• リモート MCP サーバー（推奨） - Razorpay がホストするため、セットアップは不要です
• ローカル MCP サーバー - 独自のインフラストラクチャで実行します

利用可能なツール

現在、Razorpay MCP サーバーでは以下のツールを提供しています。

ツール	説明	API	リモートサーバー対応
capture_payment	支払いステータスを承認済みからキャプチャ済みに変更します。	Payment	✅
fetch_payment	ID を指定して支払いの詳細を取得します	Payment	✅
fetch_payment_card_details	支払いに使用されたカードの詳細を取得します	Payment	✅
fetch_all_payments	フィルタリングとページネーションを使用してすべての支払いを取得します	Payment	✅
update_payment	支払いの notes フィールドを更新します	Payment	✅
initiate_payment	保存済みの支払い方法を使用し、注文と顧客の詳細を指定して支払いを開始します	Payment	✅
resend_otp	前の OTP が届かなかった場合、または期限切れの場合に再送します	Payment	✅
submit_otp	支払い認証を完了するため、OTP を検証して送信します	Payment	✅
create_payment_link	新しい標準の支払いリンクを作成します	Payment Link	✅
create_payment_link_upi	新しい UPI 支払いリンクを作成します	Payment Link	✅
fetch_all_payment_links	すべての支払いリンクを取得します	Payment Link	✅
fetch_payment_link	支払いリンクの詳細を取得します	Payment Link	✅
send_payment_link	SMS またはメールで支払いリンクを送信します。	Payment Link	✅
update_payment_link	新しい標準の支払いリンクを更新します	Payment Link	✅
create_order	注文を作成します	Order	✅
fetch_order	ID を指定して注文を取得します	Order	✅
fetch_all_orders	すべての注文を取得します	Order	✅
update_order	注文を更新します	Order	✅
fetch_order_payments	注文に対するすべての支払いを取得します	Order	✅
create_refund	返金を作成します	Refund	❌
fetch_refund	ID を指定して返金の詳細を取得します	Refund	✅
fetch_all_refunds	すべての返金を取得します	Refund	✅
update_refund	ID を指定して返金の notes を更新します	Refund	✅
fetch_multiple_refunds_for_payment	支払いに対する複数の返金を取得します	Refund	✅
fetch_specific_refund_for_payment	支払いに対する特定の返金を取得します	Refund	✅
create_qr_code	QR コードを作成します	QR Code	✅
fetch_qr_code	ID を指定して QR コードを取得します	QR Code	✅
fetch_all_qr_codes	すべての QR コードを取得します	QR Code	✅
fetch_qr_codes_by_customer_id	顧客 ID を指定して QR コードを取得します	QR Code	✅
fetch_qr_codes_by_payment_id	支払い ID を指定して QR コードを取得します	QR Code	✅
fetch_payments_for_qr_code	QR コードに対する支払いを取得します	QR Code	✅
close_qr_code	QR コードを閉じます	QR Code	❌
fetch_all_settlements	すべての精算を取得します	Settlement	✅
fetch_settlement_with_id	精算の詳細を取得します	Settlement	✅
fetch_settlement_recon_details	精算照合レポートを取得します	Settlement	✅
create_instant_settlement	即時精算を作成します	Settlement	❌
fetch_all_instant_settlements	すべての即時精算を取得します	Settlement	✅
fetch_instant_settlement_with_id	ID を指定して即時精算を取得します	Settlement	✅
fetch_all_payouts	口座番号を指定してすべての出金詳細を取得します	Payout	✅
fetch_payout_by_id	出金 ID を指定して出金の詳細を取得します	Payout	✅
fetch_tokens	顧客 ID または連絡先番号で、保存済みのすべての支払い方法を取得します	Token	✅
revoke_token	顧客の保存済み支払い方法（トークン）を無効にします	Token	✅
create_registration_link	サブスクリプション登録用の登録リンク（認証リンク）を作成します	Registration Link	❌
detect_stack	チェックアウト統合に使用するプロジェクトの言語／フレームワークを検出します	N/A (MCP Integration Helper)	✅
integrate_razorpay_checkout	対応フレームワーク向けに、Razorpay Standard Checkout のエンドツーエンド統合コードを生成します	N/A (MCP Integration Helper)	✅

ユースケース

• ワークフローの自動化：Razorpay MCP Server を使用して、日々のワークフローを自動化します。
• エージェント型アプリケーション：この Razorpay MCP サーバーを使用して、Razorpay の決済エコシステムと連携する AI 搭載ツールを構築します。

リモート MCP サーバー（推奨）

リモート MCP サーバーは Razorpay によってホストされており、ローカルでのセットアップなしに Razorpay API をすぐに利用できます。ほとんどのユーザーに推奨される方法です。

リモート MCP サーバーのメリット

• セットアップ不要：Docker や Go をインストールしたり、ローカルインフラストラクチャを管理したりする必要はありません
• 常に最新：最新の機能やセキュリティパッチが自動的に適用されます
• 高可用性：稼働率 99.9％ の堅牢な Razorpay インフラストラクチャを基盤としています
• レイテンシの低減：ルーティングとキャッシュを最適化し、API 応答を高速化します
• セキュリティの強化：トークンの自動ローテーションに対応した、安全なトークンベースの認証を使用します
• メンテナンス不要：アップデート、パッチ、サーバーのメンテナンスを心配する必要はありません

前提条件

MCP サーバーの使用には npx が必要です。 システムに Node.js をインストールしてください。Node.js には、npm（Node Package Manager）と npx（Node Package Execute）がデフォルトで含まれています。

macOS

# Install Node.js (which includes npm and npx) using Homebrew
brew install node

# Alternatively, download from https://nodejs.org/

Windows

# Install Node.js (which includes npm and npx) using Chocolatey
choco install nodejs

# Alternatively, download from https://nodejs.org/

インストールの確認

npx --version

Cursor での使用方法

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

{
  "mcpServers": {
    "rzp-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Basic <Base64(key:secret)>"
      }
    }
  }
}

key と secret を Razorpay API KEY と API SECRET に置き換えてください。

Claude Desktop での使用方法

claude_desktop_config.json に次の内容を追加します。

{
  "mcpServers": {
    "rzp-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/mcp",
        "--header",
        "Authorization: Basic <Merchant Token>"
      ]
    }
  }
}

<Merchant Token> を Razorpay のマーチャントトークンに置き換えてください。トークンの生成手順については、「認証」セクションを確認してください。

• Claude Desktop での MCP サーバーの設定方法：リンク
• Claude Desktop のインストール方法：リンク

VS Code での使用方法

次の内容を VS Code の設定（JSON）に追加します。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "merchant_token",
        "description": "Razorpay Merchant Token",
        "password": true
      }
    ],
    "servers": {
      "razorpay-remote": {
        "command": "npx",
        "args": [
          "mcp-remote",
          "https://mcp.razorpay.com/mcp",
          "--header",
          "Authorization: Basic ${input:merchant_token}"
        ]
      }
    }
  }
}

VS Code の MCP サーバーについて詳しくは、エージェントモードのドキュメントをご覧ください。

認証

リモート MCP サーバーは、マーチャントトークンベースの認証を使用します。マーチャントトークンを生成するには、次の手順に従ってください。

1. Razorpay ダッシュボードに移動し、「Settings」>「API Keys」を開きます

2. API Key と API Secret を確認します。

   • API Key はダッシュボードに表示されます
   • API Secret は、初回作成時にのみ生成されます。重要： すでに API Secret をお持ちの場合は、新しいシークレットを生成しないでください

3. ターミナルで次のコマンドを実行し、マーチャントトークンを生成します。

   echo <RAZORPAY_API_KEY>:<RAZORPAY_API_SECRET> | base64
   

   <RAZORPAY_API_KEY> と <RAZORPAY_API_SECRET> を実際の認証情報に置き換えてください

4. Base64 エンコードされた出力をコピーします。これがリモート MCP サーバー用のマーチャントトークンです

注： ローカル MCP サーバーをデプロイする場合、マーチャントトークンを生成せずに API Key と Secret を直接使用できます。

ローカル MCP サーバー

MCP サーバーを独自のインフラストラクチャで実行したい場合や、リモートサーバーで制限されているものを含むすべてのツールにアクセスする必要がある場合は、サーバーをローカルにデプロイできます。

前提条件

• Docker
• Golang（Go）
• Git

Razorpay MCP サーバーを実行するには、次のいずれかの方法を使用します。

公開 Docker イメージを使用する（推奨）

公開されている Razorpay イメージをそのまま使用できます。自分でビルドする必要はありません。以下の設定をコピーして貼り付け、Docker がインストール済みであることを確認してください。

注： 最新版ではなく特定のバージョンを使用するには、以下の設定で razorpay/mcp を razorpay/mcp:v1.0.0（または使用するバージョンタグ）に置き換えてください。利用可能なタグは Docker Hub で確認できます。

Claude Desktop での使用方法

これは公開されている razorpay イメージを使用します。

claude_desktop_config.json に以下を追加します。

{
    "mcpServers": {
        "razorpay-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "RAZORPAY_KEY_ID",
                "-e",
                "RAZORPAY_KEY_SECRET",
                "razorpay/mcp"
            ],
            "env": {
                "RAZORPAY_KEY_ID": "your_razorpay_key_id",
                "RAZORPAY_KEY_SECRET": "your_razorpay_key_secret"
            }
        }
    }
}

your_razorpay_key_id と your_razorpay_key_secret をご自身のキーに置き換えてください。

• Claude Desktop で MCP サーバーを設定する方法については、こちらをご覧ください：リンク
• Claude Desktop のインストール方法：リンク

VS Code での使用方法

VS Code の設定（JSON）に以下を追加します。

{
    "mcpServers": {
        "razorpay-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "RAZORPAY_KEY_ID",
                "-e",
                "RAZORPAY_KEY_SECRET",
                "razorpay/mcp"
            ],
            "env": {
                "RAZORPAY_KEY_ID": "your_razorpay_key_id",
                "RAZORPAY_KEY_SECRET": "your_razorpay_key_secret"
            }
        }
    }
}

your_razorpay_key_id と your_razorpay_key_secret をご自身のキーに置き換えてください。

• Claude Desktop で MCP サーバーを設定する方法については、こちらをご覧ください：リンク
• Claude Desktop のインストール方法：リンク

VS Code での使用方法

VS Code の設定（JSON）に以下を追加します。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "razorpay_key_id",
        "description": "Razorpay Key ID",
        "password": false
      },
      {
        "type": "promptString",
        "id": "razorpay_key_secret",
        "description": "Razorpay Key Secret",
        "password": true
      }
    ],
    "servers": {
      "razorpay": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "RAZORPAY_KEY_ID",
          "-e",
          "RAZORPAY_KEY_SECRET",
          "razorpay/mcp"
        ],
        "env": {
          "RAZORPAY_KEY_ID": "${input:razorpay_key_id}",
          "RAZORPAY_KEY_SECRET": "${input:razorpay_key_secret}"
        }
      }
    }
  }
}

VS Code の MCP サーバーについて詳しくは、エージェントモードのドキュメントをご覧ください。

Docker からビルドする（代替方法）

Github リポジトリをクローンし、docker を使用して Razorpay MCP Server のイメージをビルドする必要があります。システムに docker がインストールされ、実行されていることを確認してください。

# Run the server
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server
docker build -t razorpay-mcp-server:latest .

razorpay-mcp-server:latest の docker イメージがビルドされたら、上記の設定で公開イメージ（razorpay/mcp）を置き換えて使用できます。

ソースからビルドする

次の手順に従って、docker を使用せずにソースから直接ビルドできます。

# Clone the repository
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server

# Build the binary
go build -o razorpay-mcp-server ./cmd/razorpay-mcp-server

ビルドが完了したら、command オプションにバイナリ実行可能ファイルへのパスを指定する必要があります。VS Code の設定例を以下に示します。

{
  "razorpay": {
    "command": "/path/to/razorpay-mcp-server",
    "args": ["stdio","--log-file=/path/to/rzp-mcp.log"],
    "env": {
      "RAZORPAY_KEY_ID": "<YOUR_ID>",
      "RAZORPAY_KEY_SECRET" : "<YOUR_SECRET>"
    }
  }
}

設定

サーバーには次の設定が必要です。

• RAZORPAY_KEY_ID：Razorpay API キー ID
• RAZORPAY_KEY_SECRET：Razorpay API キーシークレット
• LOG_FILE（任意）：サーバーログのログファイルへのパス
• TOOLSETS（任意）：有効にするツールセットのカンマ区切りリスト（デフォルト："all"）
• READ_ONLY（任意）：サーバーを読み取り専用モードで実行します（デフォルト：false）

コマンドラインフラグ

サーバーでは次のコマンドラインフラグを使用できます。

• --key または -k：Razorpay API キー ID
• --secret または -s：Razorpay API キーシークレット
• --log-file または -l：ログファイルへのパス
• --toolsets または -t：有効にするツールセットのカンマ区切りリスト
• --read-only：サーバーを読み取り専用モードで実行します

サーバーのデバッグ

標準の Go デバッグツールを使用して、サーバーの問題をトラブルシューティングできます。ログファイルは --log-file フラグで指定できます（デフォルトは ./logs）。

ライセンス

このプロジェクトは、MIT オープンソースライセンスの条件に基づいてライセンスされています。ライセンスの全文については、LICENSE をご覧ください。