> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar Claude o Cursor a OnePay

> Usa el servidor MCP de OnePay para que asistentes de IA como Claude o Cursor puedan consultar cobros, pagos, desembolsos y saldo de tu cuenta.

## ¿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](/docs/introduction/quick-start))
* 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:

```json theme={null}
{
  "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.

<Note>
  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í.
</Note>

***

## 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`:

```json theme={null}
{
  "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:

```bash theme={null}
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.