Hermes Remote MCP Setup

Was macht Hermes Remote MCP Setup?

Wann verwenden

Verwenden Sie diese Fähigkeit, wenn Sie einen entfernten OAuth-MCP-Server in Hermes hinzufügen, autorisieren, Fehler beheben oder überprüfen.

Vorgehen

1. Bewahren Sie die angeforderte Serveridentität und den Endpunkt auf. Verwenden Sie zuerst die genaue vom Benutzer angegebene URL. Wenn eine Nicht-MCP-Antwort zurückkommt, konsultieren Sie die offizielle Dokumentation des Anbieters oder die Endpunktmetadaten, bevor Sie einen alternativen Endpunkt versuchen; ersetzen Sie niemals stillschweigend eine erratene URL.
2. Fügen Sie OAuth-fähige Server mit der nativen CLI hinzu. Verwenden Sie:

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

   Fügen Sie --connect-timeout 120 hinzu, wenn die Autorisierung oder die Tool-Erkennung langsam ist.
3. Führen Sie die interaktive Einrichtung über eine PTY durch. Der anfängliche OAuth-Fluss öffnet möglicherweise einen Browser und pausiert für die Autorisierung. Halten Sie den Prozess am Leben, teilen Sie dem Benutzer mit, die Autorisierung im Browser abzuschließen, und fordern Sie niemals OAuth-Codes im Chat an oder akzeptieren Sie diese.
4. Aktivieren Sie Tools explizit. Wenn Hermes erkannte Tools auflistet, wählen Sie alle nur aus, wenn der Benutzer darum gebeten hat, den Server allgemein zu installieren; andernfalls wählen Sie die angeforderte Teilmenge aus. Bei PTY-Flows kann nach einem normalen Absenden ein rohes y\r erforderlich sein, wenn die Auswahlaufforderung noch geöffnet bleibt.
5. Überprüfen Sie vor der Erfolgsmeldung. Führen Sie aus:

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

   Melden Sie den Endpunkt, die Authentifizierungsmethode, den Verbindungsstatus und die genaue Anzahl erkannter/aktivierter Tools.
6. Geben Sie den Aktivierungsumfang an. Die native MCP-Erkennung ist auf Start/Sitzung bezogen. Teilen Sie dem Benutzer mit, /reload-mcp auszuführen oder eine neue Sitzung zu starten, bevor er neu hinzugefügte Tools in einem bereits geöffneten Gespräch verwendet.

Fallstricke

• Speichern Sie einen Server nicht nach einer fehlgeschlagenen Endpunkt-Prüfung, es sei denn, der Benutzer wünscht explizit eine aufgeschobene, unverifizierte Konfiguration; eine 403 HTML-Seite oder eine SSE-Content-Type-Inkonsistenz sind Hinweise darauf, dass die URL nicht der verwendbare MCP-Endpunkt ist.
• Behaupten Sie nicht, dass die OAuth-Einrichtung erfolgreich war, nur weil Hermes die Konfiguration geschrieben hat; ein erfolgreicher authentifizierter hermes mcp test ist erforderlich.
• Bewahren Sie Anmeldeinformationen, Autorisierungscodes, Bearer-Tokens und vollständige OAuth-URLs nicht im Speicher, in Fähigkeiten oder im Chat auf; es handelt sich um Geheimnisse oder kurzlebige Sitzungsdaten.
• Behandeln Sie Weiterleitungen von Anbieterendpunkten als ein Erkennungsproblem, nicht als Grund, die URL des Benutzers stillschweigend zu normalisieren; bewahren Sie die ursprüngliche URL im Bericht auf und nennen Sie den verifizierten alternativen Endpunkt.