Saltar al contenido principal

​
Conectar Hermes

Hermes Agent (Nous Research) es un agente de IA auto-alojado que puede actuar como cliente MCP. Qopper expone un servidor MCP remoto por HTTP, así que puedes darle a Hermes una wallet de Qopper 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 Qopper (qp_sk_...). Identifica la wallet desde la que gastará el agente.
  • La URL base de Qopper. El endpoint público es https://api.qopper.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 Qopper, 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 Qopper:
Si responde con tu saldo y política, estás conectado. Si no, revisa:
  • La URL es https://api.qopper.com/mcp (no /).
  • El header es Authorization: Bearer qp_sk_... — una clave de agente real, no el placeholder.
  • El servidor es alcanzable: curl -X POST https://api.qopper.com/mcp devuelve una respuesta JSON-RPC.

​
5. Siguientes pasos

El servidor MCP expone las herramientas de wallet de Qopper: qopper_balance, qopper_policy_show, qopper_pay, qopper_transfer, qopper_collect, qopper_topup, qopper_audit, qopper_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.