Razorpay MCP Server

¿Qué es el servidor Razorpay MCP?

El servidor Razorpay MCP es un servidor ligero que expone las capacidades de pagos y pedidos de Razorpay como herramientas MCP ejecutables, facilitando la interacción programática de agentes basados en LLM y otras aplicaciones habilitadas para MCP con la API de Razorpay. Este servidor puede ejecutarse localmente o en contenedores y se integra directamente con entornos como Claude Desktop y Visual Studio Code.

Cómo Configurar

Antes de ejecutar el servidor, debes proporcionar tus credenciales de API de Razorpay a través de variables de entorno o banderas de línea de comandos:

• RAZORPAY_KEY_ID: Tu ID de clave de API de Razorpay
• RAZORPAY_KEY_SECRET: Tu secreto de clave de API de Razorpay
• Opcional: LOG_FILE (ruta al archivo de registro), TOOLSETS (lista de conjuntos de herramientas separada por comas), READ_ONLY (configurado a verdadero para modo de solo lectura)

La configuración del servidor puede proporcionarse mediante:

• Establecer variables de entorno al lanzar el servidor
• Pasando banderas como --key, --secret, --log-file, --toolsets, --read-only al binario

En Claude Desktop o VS Code, las credenciales y la configuración del servidor se establecen en sus respectivos archivos de configuración como se muestra en sus secciones a continuación.

Cómo Usar

Ejecutando el Servidor

Docker (Recomendado):

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

Después de la construcción, proporciona tus claves de Razorpay como variables de entorno al ejecutar el contenedor.

Desde la Fuente:

git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server
go build -o razorpay-mcp-server ./cmd/razorpay-mcp-server

Integrando con Claude Desktop

Agrega a claude_desktop_config.json:

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

Integrando con VS Code

Agrega a la configuración de tu VS Code (JSON):

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

Asegúrate de que tus claves de API estén correctamente configuradas. Consulta la documentación oficial para obtener los pasos de integración actualizados.

Características Clave

• Proporciona integración fluida entre la API de Razorpay y cualquier aplicación o agente compatible con MCP.
• Expone herramientas preconstruidas para los principales flujos de trabajo de pagos y pedidos (como la creación y recuperación de pagos).
• Soporta Docker y binarios nativos de Go para un fácil despliegue en diversos entornos.
• Diseñado para seguridad, las credenciales se proporcionan en tiempo de ejecución (nunca se codifican).
• Permite la personalización del registro y la habilitación selectiva de conjuntos de herramientas.
• Modo de solo lectura disponible para experimentación segura.

Casos de Uso

• Automatización de Flujos de Trabajo: Automatiza pagos o gestión de pedidos en flujos de trabajo comerciales a través de herramientas de IA compatibles con MCP.
• Aplicaciones Agénticas: Permite a los agentes de IA crear y gestionar directamente pagos o enlaces de Razorpay en respuesta a comandos de usuario.
• Operaciones de Pago: Recupera detalles de pagos o estados de pedidos de Razorpay a través de interfaces potentes con LLM.

Preguntas Frecuentes

Q1: ¿Necesito una cuenta de Razorpay para usar el servidor MCP?
Sí, debes tener credenciales de API de Razorpay válidas (RAZORPAY_KEY_ID y RAZORPAY_KEY_SECRET) para autenticarte e interactuar con los servicios de Razorpay.

Q2: ¿El servidor debe estar expuesto públicamente para usarse con Claude Desktop o VS Code?
No, el servidor se ejecuta localmente. Claude Desktop o VS Code se conectan a tu servidor MCP que se ejecuta localmente (o en contenedores).

Q3: ¿Qué permisos se requieren para las claves de API?
Las claves necesitan permisos que coincidan con las operaciones/herramientas que deseas utilizar (por ejemplo, crear o recuperar pagos/enlaces/pedidos).

Q4: ¿Está segura mi información sensible al usar el servidor MCP de Razorpay?
Las credenciales se proporcionan en tiempo de ejecución y nunca se codifican. Tú controlas el acceso al servidor local, y la información sensible no se comparte por defecto.

Q5: ¿Qué sucede si habilito el modo de solo lectura?
En modo de solo lectura, las operaciones de escritura como crear pagos, enlaces de pago o pedidos están deshabilitadas; solo funcionarán las herramientas de recuperación.