metisBrain
AnmeldenJetzt testen
← Übersicht
KI & Verbindungen

Claude Code verbinden

Wie verbinde ich metisBrain mit Claude Code?

MCP-Verbindung per Token, die Slash-Befehle und der Stop-Hook, der jede Session automatisch als Chat speichert.

Lesezeit ~9 Min · 7 Schritte · Stand 13. Juli 2026

Das brauchst du dafür

  • Claude Code, installiert und angemeldet.
  • Dein persönliches Token aus dem Dashboard unter Schnittstellen (beginnt mit mb_).
  • Für den Stop-Hook zusätzlich: bash, curl und jq auf deinem Rechner.

Zwei Dinge, die du einrichten kannst

Claude Code und metisBrain lassen sich auf zwei voneinander unabhängigen Wegen verbinden. Du kannst beide einrichten, musst aber nicht.

  • Die MCP-Verbindung: Claude Code bekommt die 25 Werkzeuge von metisBrain und die Slash-Befehle funktionieren. Läuft über https://metisbrain.de/api/mcp.
  • Der Stop-Hook: Jede beendete Session wird automatisch als Chat gespeichert. Läuft über einen anderen Endpunkt (/api/chats/ingest) und funktioniert auch ohne MCP.
Beide nutzen dasselbe persönliche Token. Erzeugst du ein neues, musst du es an beiden Stellen ersetzen.

1 · Token holen

Öffne im Dashboard Schnittstellen und dort die Karte „Chats aus Claude Code“. Klicke auf „Token erzeugen“, falls du noch keins hast, oder auf „Anzeigen“, um dein bestehendes Token wieder sichtbar zu machen. Es beginnt mit mb_.

Es gibt genau ein Token pro Konto. „Neu erzeugen“ macht das alte sofort ungültig, auch in Cursor und im VS-Code-Plugin.

2 · MCP-Server eintragen

Claude Code liest MCP-Server aus einer JSON-Konfiguration. metisBrain wird als HTTP-Server mit dem Token im Authorization-Header eingetragen:

MCP-Konfiguration für Claude Code
{
  "mcpServers": {
    "metisBrain": {
      "url": "https://metisbrain.de/api/mcp",
      "headers": { "Authorization": "Bearer mb_DEIN_TOKEN" }
    }
  }
}

Ersetze mb_DEIN_TOKEN durch dein echtes Token. Danach startest du Claude Code neu und prüfst mit einer Frage, die nur mit deinem Wissen zu beantworten ist:

Welche Projekte habe ich in metisBrain?
metisBrain erkennt Claude Code beim Verbinden und führt ihn im Dashboard unter Schnittstellen in der Karte „Verbundene KI-Assistenten“ getrennt von Claude auf.

3 · Die Slash-Befehle nutzen

Die metisBrain-Befehle für Claude Code liegen als Markdown-Dateien in ~/.claude/commands/. Sie sind keine eigene Schnittstelle: Jeder Befehl weist Claude Code an, die passenden metisBrain-MCP-Werkzeuge aufzurufen. Ohne die MCP-Verbindung aus Schritt 2 laufen sie deshalb ins Leere.

  • /metisbrain checkin <Projekt>: fixiert das Projekt, holt frühere Erkenntnisse und beobachtet ab dann aktiv deine Arbeitsweise.
  • /metisbrain checkout <Projekt>: fasst die Sitzung zusammen, sichert neue Erkenntnisse und hebt die Fixierung wieder auf.
  • /anweisung <Name>: lädt eine gespeicherte Anweisung, nach der Claude Code dann strikt arbeitet.
  • /projekt create|work|setFix|list: steuert Projekte.
  • /md create: legt ein Markdown-Dokument in metisBrain an.
Einchecken in ein Projekt
/metisbrain checkin website-relaunch

4 · Stop-Hook einrichten (Chats automatisch speichern)

Der Hook läuft, wenn eine Claude-Code-Session endet. Er liest das Transkript, formt daraus eine Nachrichtenliste und schickt sie an metisBrain. Der Chat erscheint danach im Dashboard unter Chats mit der Quelle Claude Code.

  • Lade in der Karte „Chats aus Claude Code“ das Script herunter und lege es nach ~/.claude/ (Dateiname metisbrain-save-chat.sh).
  • Mach es ausführbar: chmod +x ~/.claude/metisbrain-save-chat.sh
  • Trag den Hook in ~/.claude/settings.json ein und setze dein Token ein.
Stop-Hook in ~/.claude/settings.json
{
  "hooks": {
    "Stop": [
      { "hooks": [ {
        "type": "command",
        "command": "METISBRAIN_URL=https://metisbrain.de METISBRAIN_TOKEN=mb_DEIN_TOKEN ~/.claude/metisbrain-save-chat.sh"
      } ] }
    ]
  }
}
Der Hook schickt an /api/chats/ingest, nicht an den MCP-Endpunkt. Er funktioniert daher auch dann, wenn du den MCP-Server nicht eingetragen hast.

5 · Wie sich der Hook verhält

Das Script ist bewusst zurückhaltend gebaut. Es blockiert deine Arbeit nie: Fehlt etwas oder klemmt die Verbindung, beendet es sich still und die Session läuft normal weiter.

  • Ohne gesetztes Token oder ohne URL tut der Hook nichts.
  • Fehlt jq auf dem Rechner, bricht er ab, ohne etwas zu senden.
  • Gesendet werden nur die Nachrichten von dir und von Claude, nicht die internen Werkzeugaufrufe.
  • Die Session-Kennung wird mitgeschickt. Speichert derselbe Chat erneut, wird der bestehende Eintrag aktualisiert statt ein zweiter angelegt.
Laut Preistabelle ist das automatische Speichern von Chat-Sessions ab Tarif Pro enthalten.

6 · Beides zusammen

Wenn MCP-Verbindung und Hook eingerichtet sind, arbeitest du im Editor wie gewohnt: Claude Code liest und schreibt dein Wissen im Gespräch, und am Ende der Sitzung landet die Unterhaltung von selbst als Chat in metisBrain. Mit /metisbrain checkin und /metisbrain checkout klammerst du eine Arbeitsphase sauber ein.

Wenn es nicht klappt

Claude Code meldet 401 beim Zugriff auf metisBrain.
Das Token ist falsch, unvollständig oder wurde durch ein neu erzeugtes ersetzt. Hol dir im Dashboard das aktuelle Token („Anzeigen“) und trage es erneut ein: in der MCP-Konfiguration und, falls eingerichtet, auch im Stop-Hook.
Es landen keine Chats im Dashboard, obwohl der Hook eingetragen ist.
Prüfe drei Dinge: Steht im Hook-Befehl dein echtes Token statt mb_DEIN_TOKEN? Liegt das Script unter ~/.claude/metisbrain-save-chat.sh und ist es ausführbar (chmod +x)? Ist jq installiert? Fehlt eines davon, beendet sich der Hook absichtlich still.
Beim Beenden der Session erscheint „Permission denied“.
Das Script hat kein Ausführungsrecht. Führe chmod +x ~/.claude/metisbrain-save-chat.sh aus.
Dieselbe Sitzung erscheint mehrfach unter Chats.
Das sollte nicht passieren: Der Hook schickt die Session-Kennung mit, damit derselbe Chat aktualisiert statt dupliziert wird. Mehrere Einträge entstehen, wenn du in getrennten Sessions arbeitest. Speichert die KI zusätzlich über save_chat, achte darauf, dass sie dieselbe externalId verwendet.
Claude Code taucht im Dashboard nicht unter den verbundenen Clients auf.
Der Eintrag entsteht erst, wenn sich Claude Code am MCP-Endpunkt gemeldet hat. Stelle im Chat eine Frage, die ein Werkzeug auslöst, etwa „Liste meine metisBrain-Projekte“. Der Stop-Hook allein erzeugt keinen Eintrag, weil er über einen anderen Endpunkt läuft.

Häufige Fragen

Wie verbinde ich metisBrain mit Claude Code?

Trage metisBrain als MCP-Server mit der URL https://metisbrain.de/api/mcp ein und hinterlege dein persönliches Token als Authorization-Header (Bearer mb_…). Anders als Claude im Browser nutzt Claude Code kein OAuth, sondern das Token. Danach stehen alle 25 Werkzeuge und die Slash-Befehle zur Verfügung.

Warum passiert bei /metisbrain checkin nichts?

Die Slash-Befehle sind Anleitungen, die Claude Code auffordern, die metisBrain-MCP-Werkzeuge aufzurufen. Ohne eingerichteten MCP-Server hat Claude Code diese Werkzeuge nicht und der Befehl bleibt wirkungslos. Trage zuerst den MCP-Server mit deinem Token ein.

Muss ich den Stop-Hook einrichten, um metisBrain in Claude Code zu nutzen?

Nein. Der Hook ist unabhängig von der MCP-Verbindung: Er speichert nur zusätzlich jede beendete Session automatisch als Chat und schickt sie an /api/chats/ingest. Werkzeuge und Slash-Befehle funktionieren auch ohne ihn, und der Hook funktioniert auch ohne MCP.

Was braucht der Stop-Hook auf meinem Rechner?

bash, curl und jq. Fehlt jq, beendet sich das Script still, ohne etwas zu senden, und deine Session läuft ungestört weiter. Das Script gehört nach ~/.claude/metisbrain-save-chat.sh und muss ausführbar sein.

Läuft mein Token in Claude Code irgendwann ab?

Nein. Das persönliche mb_-Token hat keine Ablaufzeit. Es wird nur ungültig, wenn du im Dashboard ein neues erzeugst oder die Verbindung trennst. Nur die OAuth-Autorisierung von Claude und ChatGPT läuft nach 30 Tagen ab.

Passt dazu