knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN

Anbindung

Claude Code

Diese Anleitung bindet knowmind als MCP-Server in die Claude-Code-Kommandozeile ein. Danach stehen in jedem Claude-Code-Chat die zehn knowmind-Werkzeuge zur Verfügung — Recall, Store, Link, Unlink, Stats und sechs weitere.

Zielgruppe
Entwicklerinnen und Entwickler, die mit Claude Code arbeiten und einen persistenten Wissensspeicher über Sessions hinweg brauchen. Geeignet für Solo-Entwicklung und für Team-Setups mit gemeinsamem Arbeitsbereich.

Voraussetzungen

  • Claude Code installiert und einsatzbereit (Prüfung: claude --version)
  • knowmind-Konto im Tarif Business API oder höher (für eigenen API-Token), oder im Tarif Privat / Pro / Business mit installierter knowmind-CLI
  • Für die CLI-Variante: Node.js 20 oder neuer

Schritte

  1. 1

    Variante A: über installierte knowmind-CLI

    Diese Variante ist die schnellste — vorausgesetzt, Sie haben die knowmind-CLI bereits installiert und sich angemeldet. Wenn nicht, führen Sie zuerst die Schritte unter Kommandozeile aus.

    bash
    claude mcp add knowmind knowmind mcp

    Claude Code startet die knowmind-CLI bei Bedarf im stdio-MCP-Modus. Der Token bleibt in ~/.knowmind/config.json und wird nicht in der Claude-Code-Konfiguration gespeichert.

    Ergebnis: claude mcp list zeigt einen Eintrag knowmind: knowmind mcp — Connected.

  2. 2

    Variante B: HTTP-Transport mit eigenem API-Token

    Diese Variante verwendet das offizielle HTTP-Transport-Protokoll mit Bearer-Token. Voraussetzung ist der Tarif Business API oder höher, der eigene API-Tokens freischaltet.

    Im Dashboard unter API-Tokens einen neuen Token mit Scope read und write erstellen. Den Klartext einmalig kopieren — er ist danach nur als Prefix sichtbar.

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

    Funktionstest im Chat

    Starten Sie eine Claude-Code-Session und stellen Sie eine Frage, die auf Inhalte aus Ihrem Wissensspeicher abzielt. Claude erkennt den Recall-Bedarf in den meisten Fällen automatisch. Bei Bedarf können Sie explizit auffordern: „Such in knowmind nach …".

    bash
    $ claude
> Welche offenen Punkte gibt es im Müller-Vertrag?

    Ergebnis: Claude ruft knowmind.recall auf (sichtbar im Tool-Output) und antwortet unter Bezug auf die Treffer aus Ihrem Wissensspeicher.

  4. 4

    Erinnerung aus dem Chat heraus speichern

    Im selben Chat können Sie Claude bitten, einen Inhalt nach knowmind zu schreiben. Claude wählt dafür knowmind.store_memory (für kurze Notizen) oder knowmind.upload_document (für längere Texte mit Chunking).

    bash
    > Speichere als neue Erinnerung: "QM-Schulung Bestätigung Maria, 12. März"

    Ergebnis: Claude bestätigt die Anlage und gibt die Memory-ID zurück. Im knowmind-Dashboard erscheint die Erinnerung sofort.

Prüfung des Ergebnisses

Die Anbindung läuft, wenn alle vier Bedingungen zutreffen:

  • claude mcp list zeigt knowmind als Connected.
  • Im Chat führt eine fachliche Frage zu einem knowmind.recall-Aufruf.
  • Im knowmind-Dashboard unter „Letzte Aktivität" stehen die durchgeführten Aktionen.
  • Mit knowmind stats in einem zweiten Terminal sehen Sie die aktualisierte Erinnerungs-Zählung.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
claude mcp list zeigt knowmind als Failedknowmind-CLI nicht im PATH (Variante A) oder Token im Header falsch (Variante B).Variante A: which knowmind / where knowmind ausführen — wenn leer, CLI neu installieren. Variante B: Token im Dashboard prüfen und neu setzen.
Tool-Aufrufe brechen mit Timeout abErste Anfrage in einer Cold-Start-Situation oder Netzwerk-Latenz.Anfrage erneut stellen. Wenn dauerhaft, mit knowmind health die Service-Erreichbarkeit prüfen.
Memory-Type unknownClaude hat einen falschen memory_type-Wert übergeben.Zulässig sind semantic, episodic, procedural, reference. Claude bei der nächsten Speicher-Aufforderung explizit ansprechen.

Weiterführend