MCP del Payments Gateway

El servidor MCP del Payments Gateway expone las APIs del Gateway de Inyo como herramientas listas para IA. Maneja la autenticación OAuth automáticamente, almacenando en caché y refrescando los tokens según sea necesario.

Paquete: @inyo-global/gateway-mcp

Instalación

Elija su cliente para comenzar:

Cursor

Instalar en Cursor

o configure manualmente

Agregue a su configuración MCP de Cursor en ~/.cursor/mcp.json:

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

O vaya a Settings → MCP Servers en Cursor y agregue la configuración allí.

VS Code

Instalar en VS Code

o configure manualmente

Agregue a .vscode/mcp.json en la raíz de su proyecto:

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Windsurf

Agregue a su configuración MCP de Windsurf en ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Desktop

Agregue a su configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Reinicie Claude Desktop después de guardar la configuración.

Claude Code (CLI)

Ejecute el siguiente comando para agregar el servidor MCP:

claude mcp add inyo-gateway \
  -e GATEWAY_BASE_URL=your-gateway-url \
  -e GATEWAY_CLIENT_ID=your-client-id \
  -e GATEWAY_CLIENT_SECRET=your-client-secret \
  -- npx -y @inyo-global/gateway-mcp@latest

O agregue a .mcp.json en la raíz de su proyecto (o a ~/.claude/mcp.json de forma global):

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Variables de entorno

Variable	Descripción
`GATEWAY_BASE_URL`	URL del endpoint de la API del Gateway
`GATEWAY_CLIENT_ID`	Identificador de cliente OAuth
`GATEWAY_CLIENT_SECRET`	Secreto de cliente OAuth

Contacte a su representante de cuenta de Inyo para obtener sus credenciales. Para pruebas en sandbox, use la URL y las credenciales de su entorno sandbox.

Herramientas disponibles

Operaciones de pago

Herramienta	Descripción
`create-payment`	Crear un nuevo pago (PULL, PUSH, PULLPUSH o CHECK)
`capture-payment`	Capturar un pago previamente autorizado
`void-payment`	Anular (void) un pago antes de la liquidación
`refund-payment`	Reembolsar un pago liquidado

Verificación de cuentas

Herramienta	Descripción
`check-card-account`	Verificar los detalles de una cuenta de tarjeta (verificación ANI)
`check-bank-account`	Verificar los detalles de una cuenta bancaria

Operaciones de lectura

Herramienta	Descripción
`authenticate`	Activar manualmente la autenticación OAuth
`get-payment`	Consultar los detalles de un pago por ID

Servicios adicionales

Herramienta	Descripción
`create-fx`	Generar una cotización de cambio de divisas
`create-plaid-link`	Crear un token de Plaid Link para vincular cuentas bancarias
`get-plaid-link`	Consultar los detalles de una sesión de Plaid Link

Tipos de pago

La herramienta create-payment soporta múltiples tipos de pago:

Tipo	Descripción
PULL	Retirar fondos de una fuente de pago (cargo a tarjeta, débito ACH)
PUSH	Enviar fondos a un destinatario (OCT, payout)
PULLPUSH	Retirar y enviar en una sola operación
CHECK	Verificación de cuenta sin realizar cargos

Métodos de pago soportados

Tarjetas — Visa, Mastercard, crédito y débito
Cuentas bancarias — Débito directo ACH
PIX — Pagos instantáneos brasileños
Billeteras digitales — Donde estén soportadas

Autenticación

El servidor MCP maneja la gestión de tokens OAuth automáticamente:

En la primera llamada a una herramienta, el servidor se autentica usando sus credenciales de cliente
El token de acceso se almacena en caché en memoria
Los tokens se refrescan automáticamente 60 segundos antes de su expiración
No se requiere gestión manual de tokens

Ejemplo de uso

Una vez configurado, puede interactuar con el Gateway mediante lenguaje natural en su asistente de IA:

"Crea un pago con tarjeta de $50 usando el token tk_abc123"
"Consulta el estado del pago pay_xyz789"
"Reembolsa el pago pay_xyz789 por $25"
"Anula la autorización del pago pay_abc456"
"Verifica esta cuenta de tarjeta: 4111111111111111"

El asistente de IA traduce su solicitud en la llamada a la herramienta apropiada, la ejecuta contra la API del Gateway y devuelve la respuesta estructurada.