Skip to main content

​
¿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:
CampoValor
URLhttps://mcp.onepay.la
Header nameAuthorization
Header valueBearer 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:
HerramientaDescripción
get_balanceSaldo disponible en la billetera
list_chargesListar cargos (cobros Bre-B, PSE, tarjeta) con filtros de estado, fecha y búsqueda
show_chargeDetalle completo de un cargo por ID
list_paymentsListar cobros (payment requests) con filtros
show_paymentDetalle de un cobro por ID
list_cashoutsListar desembolsos con filtros de estado y fecha
show_cashoutDetalle de un desembolso por ID
list_customersListar clientes con búsqueda por nombre, email o documento
show_customerDetalle 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.