Zum Inhalt
DokumentationAnleitungAnbindungReferenzFehlerbehebung
DEEN

Anbindung

Claude Code

Ein Befehl im Terminal, die Freigabe über /mcp — danach hat jede Claude-Code-Sitzung Zugriff auf Ihr Gedächtnis, auch wenn der vorige Kontext längst weg ist.

Zielgruppe
Entwicklerinnen und Entwickler, die mit Claude Code arbeiten und Wissen über Sitzungen hinweg behalten wollen. Der kostenlose knowmind-Tarif Privat genügt.

Voraussetzungen

  • Claude Code installiert und aktuell (Prüfung: claude --version)
  • Eine E-Mail-Adresse für das knowmind-Konto

Schritte

  1. 1

    knowmind-Konto anlegen

    Auf knowmind.de die E-Mail-Adresse eintragen. Sie erhalten einen Anmelde-Link per Mail und melden sich damit an. Ein Passwort gibt es nicht.

    Danach legen Sie Ihren Arbeitsbereich an: Name, Kurzname und Tarif. Der Tarif Privat kostet 0 € und genügt für diese Anleitung; welche Tarife es gibt, steht auf der Preisseite.

    Ergebnis: Der Willkommensschirm steht offen, mit den Wegen „Erst einmal schreiben“ und „Mit meinem KI-Werkzeug verbinden“. Drei Startkarten liegen im Arbeitsbereich bereit.

  2. 2

    Server eintragen

    Im Terminal ausführen:

    bash
    claude mcp add --transport http knowmind https://knowmind.de/api/mcp/v1

    Der Befehl schreibt den Eintrag selbst, einen Zugangsschlüssel braucht er nicht.

    Ergebnis: claude mcp list führt knowmind und meldet Needs authentication — der richtige Zustand vor der Freigabe.

  3. 3

    Zugriff freigeben

    Claude Code starten, /mcp aufrufen, knowmind wählen und die Anmeldung bestätigen. Claude Code öffnet dafür den Browser; Sie melden sich mit Ihrem Anmelde-Link an und bestätigen die Rechte. Im Terminal tut claude mcp login knowmind dasselbe.

    Ergebnis: Nach der Bestätigung führt /mcp knowmind mit seinen Werkzeugen, und der Hinweis Needs authentication verschwindet.

  4. 4

    Erster Abruf und erstes Speichern

    Eine Sitzung starten und nach etwas fragen, das in Ihrem Gedächtnis liegen soll. Im frischen Arbeitsbereich kommen die drei Startkarten zurück, gekennzeichnet als Startpunkt ohne belastbaren Treffer. Legen Sie zuerst etwas ab:

    bash
    $ claude
> Merk dir in knowmind: Die Zugangsdaten für die Testumgebung liegen im Tresor, nicht im Repo.
> Was weiß knowmind über die Testumgebung?

    Für kurze Notizen wählt Claude knowmind_store_memory, für längere Texte knowmind_upload_document, zum Nachschlagen knowmind_recall_memories.

    Ergebnis: Claude bestätigt die Ablage und findet den Inhalt im nächsten Abruf sofort.

Damit Claude von selbst nachschlägt

Verbunden heißt noch nicht, dass die KI das Gedächtnis von sich aus benutzt. Dieser Befehl legt im Projektordner zwei Regeln ab: vor der Antwort nachschlagen, Neues zurückschreiben.

bash
npx -y knowmind init

Ein zweiter Lauf ersetzt die Regeln, statt sie zu wiederholen. Mit --dry-run sehen Sie jeden Schritt vorher. Dazu passt die einzeilige Statusanzeige knowmind status --line in der Statusleiste; Einzelheiten stehen unter Kommandozeile.

Hinweis

Ohne Browser: Anmeldung über die Kopfzeile

Auf einem Server oder in einer Pipeline gibt es keine Browser-Freigabe. Dort tragen Sie einen Zugangsschlüssel aus dem Cockpit (Schlüssel) als Kopfzeile ein; claude mcp list meldet dann sofort Connected, ohne /mcp.

bash
claude mcp add --transport http knowmind https://knowmind.de/api/mcp/v1 \
  --header "Authorization: Bearer kmt_IHR_SCHLUESSEL"

Der Schlüssel steht dann in der Claude-Code-Konfiguration. Diese Datei gehört nicht in die Versionsverwaltung und nicht in eine Cloud-Sicherung; bei Zweifeln den Schlüssel im Cockpit zurückziehen.

Prüfung des Ergebnisses

Die Anbindung trägt, wenn diese drei Punkte zutreffen:

  • claude mcp list meldet knowmind als Connected.
  • /mcp führt die knowmind-Werkzeuge auf.
  • Eine fachliche Frage führt zu einem Aufruf von knowmind_recall_memories, der in der Zeitleiste des Cockpits steht.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
Needs authentication bleibt stehenDie Freigabe über /mcp ist noch nicht erfolgt.In Claude Code /mcp aufrufen, knowmind wählen und die Anmeldung im Browser bestätigen. Auf einem Rechner ohne Browser den Weg über die Kopfzeile nehmen.
Failed to connectDie Adresse ist unvollständig eingetragen.Adresse genau prüfen: https://knowmind.de/api/mcp/v1. Den Eintrag mit claude mcp remove knowmind entfernen und neu eintragen; claude mcp get knowmind zeigt, was hinterlegt ist.
Aufrufe laufen in einen ZeitüberschrittErste Anfrage nach längerer Pause oder eine Störung auf dem Weg.Frage wiederholen. Hält es an, zeigt npx -y knowmind health, ob der Dienst erreichbar ist.
Claude nutzt das Gedächtnis nicht von selbstIm Projekt liegt keine Regel dafür.npx -y knowmind init im Projektordner ausführen oder im Chat ausdrücklich auffordern: „Such in knowmind nach …“.
Was wir geprüft haben
Geprüft am 19. Oktober 2026: Der Befehl trägt knowmind ein, ohne Freigabe meldet claude mcp list Needs authentication, mit Schlüssel in der Kopfzeile sofort Connected. Konto, Arbeitsbereich und erster Abruf laufen ebenfalls. Die Freigabe über /mcp haben wir dabei nicht gegengeprüft; serverseitig ist der Weg vollständig gegangen.

Weiterführend