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

# Conectar Hermes

> Apunta Hermes Agent (Nous Research) a Payzor por MCP y deja que consulte saldo, pague y transfiera — con instalación de un clic.

# Conectar Hermes

Hermes Agent (Nous Research) es un agente de IA auto-alojado que puede actuar como **cliente MCP**. Payzor expone un servidor MCP remoto por HTTP, así que puedes darle a Hermes una wallet de Payzor en un par de pasos — o con **un clic** si usas la app de escritorio de Hermes.

## 1. Qué necesitas

* Una **API key de agente** de Payzor (`pz_sk_...`). Identifica la wallet desde la que gastará el agente.
* La **URL base** de Payzor. El endpoint público es `https://api.payzor.com`; usa `http://localhost:3040` solo para desarrollo local.

## 2. Instalación de un clic ("Add to Hermes")

Hermes soporta un deep link que abre la app de escritorio con el servidor pre-cargado — el mismo patrón que usa Cursor:

```
hermes://mcp/install?name=payzor&config=<BASE64URL>
```

El `config` es un objeto JSON codificado en base64url con la `url` y los `headers` del servidor:

```json theme={null}
{
  "url": "https://api.payzor.com/mcp",
  "headers": { "Authorization": "Bearer pz_sk_..." }
}
```

Hermes muestra un diálogo de confirmación con el nombre del servidor y el config completo; confirma para habilitarlo. Desde la consola de Payzor, selecciona **Hermes** en la página **Conectar MCP** y haz clic en **Añadir a Hermes** — el enlace se genera automáticamente con tu URL base.

## 3. Config manual (`~/.hermes/config.yaml`)

Si prefieres escribir el config a mano (o corres Hermes desde una terminal), añade el servidor a `~/.hermes/config.yaml`:

```yaml theme={null}
mcp_servers:
  payzor:
    url: "https://api.payzor.com/mcp"
    headers:
      Authorization: "Bearer pz_sk_..."
    tools:
      # Opcional: mantén la superficie mínima — solo saldo, por ejemplo.
      include: [payzor_balance, payzor_auth_status]
```

Luego arranca Hermes:

```bash theme={null}
hermes chat
```

Hermes descubre los servidores MCP al arrancar. Para recargar tras cambiar el config, ejecuta `/reload-mcp`.

## 4. Verifica que conectó

Pídele a Hermes que use la wallet de Payzor:

```text theme={null}
¿Cuál es mi saldo de Payzor y en qué puedo gastar?
```

Si responde con tu saldo y política, estás conectado. Si no, revisa:

* La URL es `https://api.payzor.com/mcp` (no `/`).
* El header es `Authorization: Bearer pz_sk_...` — una clave de agente real, no el placeholder.
* El servidor es alcanzable: `curl -X POST https://api.payzor.com/mcp` devuelve una respuesta JSON-RPC.

## 5. Siguientes pasos

El servidor MCP expone las herramientas de wallet de Payzor: `payzor_balance`, `payzor_policy_show`, `payzor_pay`, `payzor_transfer`, `payzor_collect`, `payzor_topup`, `payzor_audit`, `payzor_auth_status`. Ese shell pasa por la misma wallet y motor de política que la consola — las reglas de gasto del agente siguen aplicando a cada pago.