Erste Schritte
App verbinden
Einrichtung für deinen Client, mit konkreten Schritten und Befehlen.
Client-Einrichtung
Wähle deine App und folge den Einrichtungsschritten. Die Anleitung erklärt die verfügbaren Anmeldewege und Einschränkungen.
Optionales Org-API-Key-Profil. Für persönlichen Zugriff auf einem Headless-Host nutze die Device-Login-Anleitung.
- Einen Org-API-Key mit dem
create_api_key-Tool aus einer verbundenen User-Session erzeugen (Claude Code, Desktop) — der Hermes-Host sieht deinen persönlichen Login nie. - In Fleet die MCP-Integration der Instanz öffnen und drei Felder setzen: einen Servernamen (nur Buchstaben, Ziffern,
_,-), den Endpointhttps://meinkontext.de/mcpund den api-key als Bearer-Token. - Speichern. Fleet schreibt den Server nach
~/.hermes/config.yaml, legt den Token in~/.hermes/.env(nie ins YAML) und startet das Gateway neu — der Agent hat die Tools ab der nächsten Session.
- Org-scoped Service-Principal — für Objekte read-only (der Server versteckt Authoring-Tools wie
write_article; Direkt-Calls antworten mit einem erklärenden Fehler), ebenso für Erinnerungen: er liest (recall,search), schreibt aber nicht;rememberundforgetbrauchen eine OAuth-Verbindung. - Fleet verwaltet nur Einträge mit
url,enabledundheaders— sonst nichts. Ein weiterer Schlüssel — oder eincommand:für einen lokalen stdio-Server — macht den Eintrag für den geprüften Fleet-Adapter unverwaltet; pflege diese individuelle Konfiguration selbst. - Der Endpoint muss HTTPS sein, außer es ist eine Loopback-Adresse auf dem VPS selbst — Fleet weist einfaches HTTP zu einem entfernten Host ab.
- Die Feldnamen stammen aus Fleets Hermes-Adapter, nicht aus einem Screenshot der Oberfläche — die Beschriftungen können abweichen.
- Nach einer Tool-Surface-Änderung am Server das Gateway neu starten:
instructionsund Tool-Liste werden beim Connect gelesen, eine laufende Session behält die alten.
Ohne Fleet: die zwei Dateien von Hand
- Dieselbe Form, die Fleet schreibt — ein so angelegter Eintrag bleibt Fleet-verwaltbar, solange er genau diese Schlüssel behält. Danach das Gateway neu starten.
# ~/.hermes/config.yaml
mcp_servers:
meinkontext:
url: https://meinkontext.de/mcp
enabled: true
headers:
Authorization: "Bearer ${MEINKONTEXT_TOKEN}"
# ~/.hermes/.env — chmod 600; the token NEVER belongs in the YAML
# MEINKONTEXT_TOKEN=<org API key>-
${MEINKONTEXT_TOKEN}bleibt literal im YAML; Hermes löst es aus seiner Umgebung auf. Die.env-Datei enthält weiterhin den Schlüssel: Schütze sie und alle Backups, die sie einschließen.