Verbindungen

Hier hängen deine Agenten an eXocortex: Anwendungen, die sich in deinem Namen anmelden, Token für alles andere, und die fertigen Befehle zum Einrichten.

Verbundene Anwendungen

Programme, denen du auf der Zustimmungsseite Zugriff gegeben hast, zum Beispiel ChatGPT. Sie melden sich in deinem Namen an, ohne ein Token von dir. Trennen wirkt sofort: laufende Sitzungen enden, und ein erneuter Zugriff braucht deine Zustimmung von vorn.

Token

API-Token erlauben externen Programmen wie dem MCP-Server, in deinem Namen auf eXocortex zuzugreifen. Gib jedem Token nur die Rechte, die es wirklich braucht: Wenn es abhandenkommt, kann jemand genau das damit tun.

Neues Token

Seiten und Datenbanken lesen, nichts ändern.

Einrichten

Such dir dein Programm und kopier die Zeile. Mehr ist es nicht.

Wo DEIN_TOKEN steht, gehört ein Token aus dem Abschnitt darüber hin. Legst du gleich hier eins an, setzt eXocortex es von selbst ein.

Claude Code mit Gedächtnis

Das Plugin bringt die Werkzeuge und das Gedächtnis mit: Erinnerungen beim Start, eine verdichtete Notiz am Ende jeder Sitzung.

/plugin marketplace add HannaPanda/exocortex
/plugin install exocortex@exocortex

Beide Zeilen in einer laufenden Claude-Code-Sitzung eingeben, nicht im Terminal.
Beim Aktivieren fragt Claude Code nach Adresse und Token. Leg dir vorher eins im Abschnitt darüber an, es wird nur einmal angezeigt.
Danach /exocortex:einrichten aufrufen: das prüft Werkzeuge und Gedächtnis und sagt, was noch fehlt.

Claude Code

Fügt eXocortex als MCP-Server über HTTP hinzu. Eine Zeile im Terminal.

claude mcp add --transport http exocortex https://exocortex.app/api/mcp --header "Authorization: Bearer DEIN_TOKEN"

Ohne weitere Angabe gilt der Server nur im aktuellen Projekt. Mit --scope user am Ende steht er in allen Projekten zur Verfügung.
Prüfen mit: claude mcp list

ChatGPT

Als Connector anlegen und OAuth wählen. ChatGPT kann kein Token entgegennehmen, es meldet sich stattdessen bei dir an.

https://exocortex.app/api/mcp

Für Deep Research die eigene URL nehmen: https://exocortex.app/api/mcp/research. Sie kennt nur "search" und "fetch" und kann nichts verändern.
Nach dem Anlegen landest du auf der Zustimmungsseite. Erst dein „Verbinden“ dort gibt ChatGPT Zugriff, und der Abschnitt „Verbundene Anwendungen“ oben nimmt ihn wieder weg.
Ein Token brauchst du hier nicht. Wenn ein Connector nach einem fragt, ist es nicht dieser hier.

Hermes

Startet den MCP-Server als Prozess. Gehört in ~/.hermes/config.yaml.

mcp_servers:
  exocortex:
    command: node
    args: ['/var/www/exocortex/apps/mcp/dist/main.js']
    env:
      EXOCORTEX_API_URL: 'https://exocortex.app'
      EXOCORTEX_API_TOKEN: 'DEIN_TOKEN'

Läuft Hermes auf demselben Rechner wie eXocortex, ist http://127.0.0.1:3211 die bessere API-URL: der Weg geht dann direkt an die API, ohne nginx.
Der Pfad in args zeigt auf die gebaute Datei von apps/mcp auf diesem Rechner.

Anderer Client über HTTP

Jeder Client, der Streamable HTTP spricht, braucht nur URL und Token.

URL:    https://exocortex.app/api/mcp
Header: Authorization: Bearer DEIN_TOKEN

Zum Ausprobieren, ob Token und URL stimmen:
curl -sS https://exocortex.app/api/mcp -H 'authorization: Bearer DEIN_TOKEN' -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Welche Rechte für wen

ChatGPT: nur lesen. Es soll nachschlagen, nicht umschreiben.
Coding-Agenten wie Claude Code: lesen und schreiben. Sie legen Seiten an und pflegen sie.
Voller Zugriff: an niemanden. Kein Werkzeug im MCP-Katalog braucht ihn, und er ist das einzige Recht, mit dem sich ein Token weitere Token ausstellen kann.