knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN

Anbindung

Claude Code

Ein Befehl und ein Browser-Login, danach stehen in jedem Claude-Code-Chat die elf knowmind-Werkzeuge zur Verfügung (Recall, Store, Link, Unlink, Stats und sechs weitere). Kein API-Token und keine Zusatz-Installation nötig.

Zielgruppe
Entwicklerinnen und Entwickler, die mit Claude Code arbeiten und einen persistenten Wissensspeicher über Sessions hinweg brauchen. Funktioniert ab dem kostenlosen Privat-Tarif.

Voraussetzungen

  • Claude Code installiert und aktuell (Prüfung: claude --version)
  • Ein knowmind-Konto (kostenloser Privat-Tarif genügt)

Schritte

  1. 1

    Anbinden mit einem Befehl

    Führen Sie im Terminal aus:

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

    Beim ersten Zugriff öffnet Claude Code den Browser. Sie melden sich bei knowmind an (Anmelde-Link per Mail) und bestätigen den Zugriff. knowmind richtet den Arbeitsbereich automatisch ein; der Zugang ist danach in Claude Code hinterlegt. Sie müssen keinen Token anlegen und nichts zusätzlich installieren.

    Ergebnis: claude mcp list zeigt knowmind als Connected.

  2. 2

    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.

  3. 3

    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.

Alternative: HTTP-Transport mit eigenem API-Token

Für unbeaufsichtigte Einrichtungen (CI, Server ohne Browser) statt des Browser-Logins ein API-Token verwenden — der API-Zugang ist in jedem Tarif enthalten, auch im kostenlosen Privat-Tarif. Im Dashboard unter API-Tokens einen Token mit Scope read und write erstellen, dann:

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

Prüfung des Ergebnisses

Die Anbindung läuft, wenn alle drei 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.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
Browser-Login öffnet sich nicht / mcp list zeigt FailedVeraltete Claude-Code-Version ohne OAuth, oder die Adresse wurde unvollständig eingetragen.Claude Code aktualisieren und die Adresse exakt als https://knowmind.de/api/mcp/v1 eintragen. Wenn Ihr Setup keinen Browser hat (CI/Server), den Token-Weg unten nutzen.
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