Skip to main content

​
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:
El config es un objeto JSON codificado en base64url con la url y los headers del servidor:
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:
Luego arranca Hermes:
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:
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.