Configuration MCP Distant Hermes

Que fait Configuration MCP Distant Hermes ?

Quand l'utiliser

Utilisez cette compétence pour ajouter, autoriser, dépanner ou vérifier un serveur MCP distant avec OAuth dans Hermes.

Procédure

1. Préservez l'identité et le point de terminaison du serveur demandé. Utilisez d'abord l'URL exacte fournie par l'utilisateur. Si elle renvoie une réponse non MCP, consultez la documentation officielle du fournisseur ou les métadonnées du point de terminaison avant d'essayer une autre URL ; ne substituez jamais silencieusement une URL devinée.
2. Ajoutez les serveurs compatibles OAuth avec la CLI native. Utilisez :

   hermes mcp add <nom> --url <point_terminaison> --auth oauth
   

   Ajoutez --connect-timeout 120 lorsque l'autorisation ou la découverte d'outils est lente.
3. Lancez la configuration interactive via un PTY. Le flux OAuth initial peut ouvrir un navigateur et attendre l'autorisation. Maintenez le processus actif, dites à l'utilisateur de terminer l'autorisation dans le navigateur, et ne demandez ni n'acceptez jamais de codes OAuth dans le chat.
4. Activez les outils explicitement. Lorsque Hermes liste les outils découverts, sélectionnez tout uniquement si l'utilisateur a demandé une installation générale du serveur ; sinon sélectionnez le sous-ensemble demandé. Dans les flux PTY, un y\r brut peut être nécessaire après une soumission normale si l'invite de sélection reste ouverte.
5. Vérifiez avant de signaler le succès. Exécutez :

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

   Signalez le point de terminaison, la méthode d'authentification, l'état de la connexion et le nombre exact d'outils découverts/activés.
6. Indiquez la portée d'activation. La découverte MCP native est limitée au démarrage/à la session. Dites à l'utilisateur d'exécuter /reload-mcp ou de démarrer une nouvelle session avant d'utiliser les outils nouvellement ajoutés dans une conversation déjà ouverte.

Pièges

• Ne sauvegardez pas un serveur après un échec de sondage du point de terminaison, sauf si l'utilisateur souhaite explicitement une configuration différée et non vérifiée ; une page HTML 403 ou une incompatibilité de type de contenu SSE prouvent que l'URL n'est pas le point de terminaison MCP utilisable.
• Ne prétendez pas que la configuration OAuth a réussi simplement parce qu'Hermes a écrit la configuration ; exigez un hermes mcp test authentifié réussi.
• Gardez les identifiants, les codes d'autorisation, les jetons porteurs et les URL OAuth complètes hors de la mémoire, des compétences et du chat ; ce sont des secrets ou des données de session éphémères.
• Traitez les redirections de point de terminaison du fournisseur comme un problème de découverte, pas comme une raison pour normaliser silencieusement l'URL de l'utilisateur ; conservez l'URL d'origine dans le rapport et nommez le point de terminaison alternatif vérifié.