knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN

Anbindung

Cursor

Diese Anleitung bindet knowmind als MCP-Server in die Cursor-IDE ein. Cursor verwendet das gleiche MCP-Format wie Claude Desktop — die Konfiguration ist in wenigen Minuten erledigt.

Zielgruppe
Entwicklerinnen und Entwickler, die Cursor als IDE einsetzen und einen persistenten Wissensspeicher über Projekte und Sessions hinweg brauchen.

Voraussetzungen

  • Cursor installiert (cursor.com)
  • knowmind-Konto in einem beliebigen Tarif
  • Für die CLI-Variante: knowmind-CLI installiert und angemeldet
  • Für die HTTP-Variante: API-Token aus dem knowmind-Dashboard

Schritte

  1. 1

    Cursor-Konfiguration öffnen

    In Cursor unter Settings → MCP oder direkt die Konfigurationsdatei bearbeiten:

    text
    macOS / Linux:  ~/.cursor/mcp.json
Windows:        %USERPROFILE%\.cursor\mcp.json

    Ergebnis: Die Konfigurationsdatei ist offen oder der MCP-Bereich in den Einstellungen ist sichtbar.

  2. 2

    Variante A: knowmind-CLI eintragen (empfohlen)

    Vorausgesetzt, die CLI ist installiert und über knowmind login angemeldet:

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

    Ergebnis: Cursor startet die CLI bei Bedarf im stdio-MCP-Modus. Der Token bleibt in der CLI-Konfigurationsdatei.

  3. 3

    Variante B: HTTP-Transport mit Bearer-Token

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

    Cursor neu starten

    Cursor liest die MCP-Konfiguration nur beim Start. Nach dem Neustart erscheinen die knowmind-Werkzeuge in der MCP-Übersicht.

    Ergebnis: Unter Settings → MCP wird knowmind als Verbunden angezeigt. In jedem neuen Chat in Cursor stehen die zehn Werkzeuge zur Verfügung.

  5. 5

    Funktionstest

    In einem Cursor-Chat eine Frage stellen, die auf Inhalte aus Ihrem Wissensspeicher abzielt. Cursor erkennt in der Regel automatisch den Tool-Bedarf und ruft knowmind.recall auf.

    Ergebnis: Antwort von Cursor enthält Inhalte aus Ihrem knowmind-Korpus, sichtbar im Tool-Aufruf-Bereich.

Prüfung des Ergebnisses

Die Anbindung läuft, wenn alle drei Punkte zutreffen:

  • Unter Settings → MCP steht knowmind als Verbunden.
  • In neuen Chats sind die knowmind-Werkzeuge sichtbar.
  • Eine Beispielfrage liefert Antworten aus dem knowmind-Korpus, nachvollziehbar im Tool-Aufruf-Bereich.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
MCP-Bereich in Cursor nicht sichtbarVeraltete Cursor-Version ohne MCP-Unterstützung.Cursor auf die aktuelle Version aktualisieren (mindestens 0.42).
knowmind wird als Failed angezeigtJSON-Syntaxfehler oder knowmind-CLI nicht im PATH.Datei in einem Editor mit JSON-Linting prüfen. CLI-Pfad mit which knowmind beziehungsweise where knowmind verifizieren.
Tools werden nicht in jedem Chat angebotenTool-Berechtigung pro Chat manuell auswählbar.Im Cursor-Chat oben rechts auf das Werkzeug-Symbol klicken und knowmind aktivieren.

Weiterführend