Configuración de MCP Remoto en Hermes

¿Qué hace Configuración de MCP Remoto en Hermes?

Cuándo Usarlo

Usa esta habilidad al agregar, autorizar, solucionar problemas o verificar un servidor MCP OAuth remoto en Hermes.

Procedimiento

1. Conserva la identidad y el punto final del servidor solicitado. Usa primero la URL exacta proporcionada por el usuario. Si devuelve una respuesta que no es MCP, consulta la documentación oficial del proveedor o los metadatos del punto final antes de probar un punto final alternativo; nunca sustituyas en silencio una URL supuesta.
2. Agrega servidores compatibles con OAuth mediante la CLI nativa. Usa:

   hermes mcp add <nombre> --url <endpoint> --auth oauth
   

   Agrega --connect-timeout 120 cuando la autorización o el descubrimiento de herramientas sea lento.
3. Ejecuta la configuración interactiva a través de un PTY. El flujo OAuth inicial puede abrir un navegador y pausarse para autorización. Mantén el proceso vivo, dile al usuario que complete la autorización en el navegador y nunca solicites ni aceptes códigos OAuth en el chat.
4. Habilita las herramientas explícitamente. Cuando Hermes liste las herramientas descubiertas, selecciona todas solo si el usuario solicitó instalar el servidor de forma general; de lo contrario, selecciona el subconjunto solicitado. En flujos PTY, puede ser necesario un y\r en bruto después de un envío normal si el aviso de selección permanece abierto.
5. Verifica antes de informar éxito. Ejecuta:

   hermes mcp list
   hermes mcp test <nombre>
   hermes config get mcp_servers.<nombre>
   

   Informa el punto final, el método de autenticación, el estado de la conexión y el número exacto de herramientas descubiertas/habilitadas.
6. Indica el alcance de activación. El descubrimiento nativo de MCP tiene alcance de inicio/sesión. Dile al usuario que ejecute /reload-mcp o inicie una nueva sesión antes de usar las herramientas recién agregadas en una conversación ya abierta.

Errores Comunes

• No guardes un servidor después de una sonda de punto final fallida a menos que el usuario quiera explícitamente una configuración diferida y no verificada; una página HTML 403 o una discrepancia en el tipo de contenido SSE es evidencia de que la URL no es el punto final MCP utilizable.
• No afirmes que la configuración OAuth se ha completado solo porque Hermes escribió la configuración; requiere una hermes mcp test autenticada exitosa.
• Mantén las credenciales, los códigos de autorización, los tokens de portador y las URLs OAuth completas fuera de la memoria, las habilidades y el chat; son secretos o datos de sesión de corta duración.
• Trata las redirecciones de punto final del proveedor como un problema de descubrimiento, no como una razón para normalizar la URL del usuario en silencio; conserva la URL original en el informe y nombra el punto final alternativo verificado.