Conectar Claude o Cursor a OnePay

¿Qué es el servidor MCP de OnePay?

El Model Context Protocol (MCP) es un estándar abierto que permite conectar asistentes de IA a herramientas externas. OnePay expone un servidor MCP en https://mcp.onepay.la que les da acceso a tu información de pagos en tiempo real. Una vez conectado, puedes hacerle preguntas a Claude como:

“¿Cuál es mi saldo disponible?”
“Muéstrame los cobros pendientes de esta semana”
“¿Qué pasó con el pago INV-2026-001?”
“Lista los últimos 5 desembolsos fallidos”

Todo usando tu llave de API existente — sin configurar nada adicional.

Prerrequisitos

Cuenta de OnePay con llaves de API (ver cómo obtenerlas)
Claude Desktop, Claude.ai, Cursor u otro cliente MCP compatible

Conectar Claude Desktop

1. Abre (o crea) el archivo de configuración:

~/Library/Application Support/Claude/claude_desktop_config.json

2. Agrega el servidor OnePay:

{
  "mcpServers": {
    "onepay": {
      "transport": "http",
      "url": "https://mcp.onepay.la",
      "headers": {
        "Authorization": "Bearer sk_live_TU_LLAVE_AQUI"
      }
    }
  }
}

3. Reinicia Claude Desktop. Verás el ícono de herramientas (🔧) en el chat — significa que OnePay está conectado.

Usa tu llave sk_live_ para datos reales, o sk_test_ para el ambiente de pruebas. La misma llave que usas en la API REST funciona aquí.

Conectar Claude.ai (web)

1. Ve a Settings → Integrations → Add MCP Server 2. Ingresa los datos:

Campo	Valor
URL	`https://mcp.onepay.la`
Header name	`Authorization`
Header value	`Bearer sk_live_TU_LLAVE`

3. Guarda y abre un chat nuevo.

Conectar Cursor

Agrega esto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "onepay": {
      "transport": "http",
      "url": "https://mcp.onepay.la",
      "headers": {
        "Authorization": "Bearer sk_live_TU_LLAVE_AQUI"
      }
    }
  }
}

Herramientas disponibles

El servidor expone 9 herramientas de solo lectura:

Herramienta	Descripción
`get_balance`	Saldo disponible en la billetera
`list_charges`	Listar cargos (cobros Bre-B, PSE, tarjeta) con filtros de estado, fecha y búsqueda
`show_charge`	Detalle completo de un cargo por ID
`list_payments`	Listar cobros (payment requests) con filtros
`show_payment`	Detalle de un cobro por ID
`list_cashouts`	Listar desembolsos con filtros de estado y fecha
`show_cashout`	Detalle de un desembolso por ID
`list_customers`	Listar clientes con búsqueda por nombre, email o documento
`show_customer`	Detalle de un cliente por ID

Todas las herramientas respetan el modo del ambiente automáticamente: las llaves sk_test_ consultan datos de prueba y las sk_live_ consultan producción.

Ejemplos de conversación

Una vez conectado, puedes preguntar en lenguaje natural: Ver saldo:

“¿Cuánto tengo disponible en mi billetera de OnePay?”

Revisar cobros:

“Lista los 10 cobros más recientes que están pendientes”

“¿Hay algún cobro fallido esta semana?”

Investigar un pago:

“Busca el cobro con referencia FACT-2026-0412”

“¿Qué pasó con el cobro del cliente Juan García de ayer?”

Revisar desembolsos:

“Muéstrame los desembolsos que están procesando hoy”

“¿Cuántos desembolsos fallaron esta semana?”

Verificar la conexión

Puedes probar directamente desde terminal:

curl -s -X POST https://mcp.onepay.la \
  -H "Authorization: Bearer sk_test_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
  | jq '.result.tools[].name'

Si la conexión es exitosa, verás los nombres de las 9 herramientas.

Seguridad

El servidor solo acepta llaves privadas (sk_). Las llaves públicas (pk_) son rechazadas.
Todas las consultas están limitadas a los datos de tu empresa — no puedes acceder a datos de otras cuentas.
El servidor es de solo lectura: no puede crear, modificar ni eliminar datos.
Cada llamada queda registrada en tu historial de solicitudes de API en el panel de OnePay.

Inicio rápido

Cobrar (Recaudo)

Pagar (Dispersiones)

Webhooks

IA (MCP)

Verificación

Configuración

Artículos

¿Qué es el servidor MCP de OnePay?

Prerrequisitos

Conectar Claude Desktop

Conectar Claude.ai (web)

Conectar Cursor

Herramientas disponibles

Ejemplos de conversación

Verificar la conexión

Seguridad

​¿Qué es el servidor MCP de OnePay?

​Prerrequisitos

​Conectar Claude Desktop

​Conectar Claude.ai (web)

​Conectar Cursor

​Herramientas disponibles

​Ejemplos de conversación

​Verificar la conexión

​Seguridad

¿Qué es el servidor MCP de OnePay?

Prerrequisitos

Conectar Claude Desktop

Conectar Claude.ai (web)

Conectar Cursor

Herramientas disponibles

Ejemplos de conversación

Verificar la conexión

Seguridad