meinKontextDocs
Navigation & Suche

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.

  1. 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.
  2. In Fleet die MCP-Integration der Instanz öffnen und drei Felder setzen: einen Servernamen (nur Buchstaben, Ziffern, _, -), den Endpoint https://meinkontext.de/mcp und den api-key als Bearer-Token.
  3. 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; remember und forget brauchen eine OAuth-Verbindung.
  • Fleet verwaltet nur Einträge mit url, enabled und headers — sonst nichts. Ein weiterer Schlüssel — oder ein command: 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: instructions und 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.
yaml
# ~/.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.