knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN

Anbindung

Claude Desktop

Diese Anleitung bindet knowmind als MCP-Server in die Claude-Desktop-App ein. Danach stehen in jedem Chat in Claude Desktop die zehn knowmind-Werkzeuge zur Verfügung. Setup-Aufwand etwa fünf Minuten.

Zielgruppe
Privat- und Business-Nutzer, die mit der Claude-Desktop-App arbeiten (Mac oder Windows). Vorkenntnisse in JSON sind hilfreich, aber nicht zwingend.

Voraussetzungen

  • Claude Desktop installiert (Anthropic-Konto erforderlich)
  • knowmind-Konto in einem beliebigen Tarif
  • Eine der beiden Anbindungs-Varianten vorbereitet: (a) installierte knowmind-CLI mit hinterlegtem Token oder (b) ein API-Token im Format kmt_…
Hinweis

Empfehlung: CLI-Variante

Die Variante mit installierter knowmind-CLI ist sicherer, weil das API-Token in der CLI-Konfigurationsdatei mit eingeschränkten Dateirechten bleibt und nicht in die Claude-Desktop-Konfiguration übertragen wird. Beide Varianten sind beschrieben — wir empfehlen Variante A.

Schritte

  1. 1

    Konfigurationsdatei finden

    Claude Desktop liest die MCP-Konfiguration aus einer JSON-Datei. Der Pfad unterscheidet sich nach Betriebssystem:

    text
    macOS:    ~/Library/Application Support/Claude/claude_desktop_config.json
Windows:  %APPDATA%\Claude\claude_desktop_config.json
Linux:    ~/.config/Claude/claude_desktop_config.json

    Wenn die Datei noch nicht existiert, legen Sie sie an. Wenn sie existiert, prüfen Sie, ob bereits ein mcpServers-Block vorhanden ist — ergänzen Sie diesen, statt ihn zu überschreiben.

    Ergebnis: Sie haben die Datei in einem Editor geöffnet.

  2. 2

    Variante A: knowmind-CLI eintragen (empfohlen)

    Voraussetzung: knowmind login --token kmt_… wurde einmal ausgeführt. Wenn nicht, folgen Sie zuerst der Anleitung Kommandozeile.

    json
    {
  "mcpServers": {
    "knowmind": {
      "command": "knowmind",
      "args": ["mcp"]
    }
  }
}

    Claude Desktop startet bei Bedarf knowmind mcp, das sich aus der CLI-Konfiguration mit dem hinterlegten Token anmeldet und Anfragen weiterreicht.

    Ergebnis: Die Konfigurationsdatei enthält den knowmind-Eintrag, das API-Token bleibt in der CLI-Konfiguration.

  3. 3

    Variante B: HTTP-Transport mit Bearer-Token

    Diese Variante kommt ohne CLI aus, hinterlegt das Token aber in der Claude-Desktop-Konfigurationsdatei.

    json
    {
  "mcpServers": {
    "knowmind": {
      "type": "http",
      "url": "https://knowmind.de/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer kmt_…"
      }
    }
  }
}
  4. 4

    Claude Desktop neu starten

    Claude Desktop liest die Konfiguration nur beim Start ein. Beenden Sie die App vollständig (rechte Maustaste auf das Symbol in der Menüleiste oder Taskleiste) und starten Sie sie neu.

    Ergebnis: Im Tool-Drawer von Claude Desktop erscheinen die zehn knowmind-Werkzeuge. Der Drawer öffnet sich über das Werkzeug-Symbol am unteren Rand des Chat-Fensters.

  5. 5

    Funktionstest im Chat

    Stellen Sie eine Frage, die auf einen bekannten Inhalt aus Ihrem Wissensspeicher abzielt: „Was wissen wir über Projekt Helios?" oder „Wer ist Ansprechpartnerin für die Einarbeitung?".

    Ergebnis: Claude Desktop ruft knowmind.recall auf (sichtbar im Tool-Aufruf-Bereich) und antwortet auf Basis Ihres knowmind-Inhalts.

Prüfung des Ergebnisses

Die Anbindung ist korrekt eingerichtet, wenn alle drei Bedingungen zutreffen:

  • Im Tool-Drawer von Claude Desktop sind die knowmind-Werkzeuge sichtbar (Recall, Stats, Health, Store-Memory, Upload-Document, Update-Fact, Link, Unlink, List-Relations, Recall-at-Time).
  • Auf eine Frage nach Inhalten aus Ihrem Arbeitsbereich antwortet Claude unter Nennung der Quelle.
  • Im knowmind-Dashboard unter „Audit-Log" erscheinen die Recall-Aufrufe (nur wenn Ihr Tarif Audit-Log freischaltet, ab Privat aufwärts).

Fehlerbehebung

FehlermeldungUrsacheAuflösung
Tools nicht im Drawer sichtbarClaude Desktop nicht vollständig beendet — nur Fenster geschlossen.Über das Menüleisten- oder Taskleisten-Symbol „Quit" beziehungsweise „Beenden" auswählen, dann erneut starten.
JSON-Syntaxfehler in claude_desktop_config.jsonFalsch gesetztes Komma oder fehlende Klammer.Datei in einem Editor mit JSON-Linting öffnen (zum Beispiel VS Code) und die Fehlermeldung beheben. Vorlage steht oben in Schritt 2 oder 3.
ECONNREFUSED beim Tool-Aufrufknowmind.de aktuell nicht erreichbar oder lokales Netzwerk blockiert ausgehende HTTPS-Verbindungen.Im Browser https://knowmind.de/api/health öffnen. Erscheint dort eine Erfolgsmeldung, prüfen Sie Firewall- oder Proxy-Einstellungen Ihrer Workstation.
401 unauthorized bei Variante BToken-Wert fehlerhaft kopiert oder zwischen den Anführungszeichen Whitespace.Token im Dashboard widerrufen, einen neuen erstellen und das vollständige kmt_…-Token ohne Leerzeichen kopieren.

Weiterführend