Zum Inhalt
DokumentationAnleitungAnbindungReferenzFehlerbehebung
DEEN

Anbindung

Cursor

Ein Befehl im Terminal, Cursor neu starten — danach findet der Editor Ihr Projektwissen beim Antworten. Der Befehl schreibt den Eintrag selbst, Sie öffnen keine Datei.

Zielgruppe
Alle, die mit Cursor arbeiten. Der kostenlose knowmind-Tarif Privat genügt.

Voraussetzungen

  • Cursor installiert
  • Node.js 20 oder neuer (Prüfung: node --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

    Zugangsschlüssel erzeugen

    Im Cockpit unter Schlüssel einen Schlüssel anlegen. Er beginnt mit kmt_ und wird nur einmal angezeigt — gleich kopieren. Wer beim Willkommensschirm Cursor gewählt hat, hat ihn schon im Befehl stehen.

    Ergebnis: Ein Schlüssel im Format kmt_… liegt in der Zwischenablage.

  3. 3

    Eintrag schreiben

    Terminal öffnen, gern direkt in Cursor, Befehl einfügen, kmt_IHR_SCHLUESSEL ersetzen, Eingabetaste:

    bash
    npx -y knowmind install cursor --token kmt_IHR_SCHLUESSEL

    Der Befehl ergänzt ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json) und lässt bestehende Einträge stehen. Mit --print zeigt er den Eintrag nur an, mit --project schreibt er ihn in den Projektordner statt in Ihr Benutzerverzeichnis.

    Ergebnis: Die Ausgabe endet mit dem Hinweis, Cursor neu zu starten.

  4. 4

    Cursor neu starten und freigeben

    Cursor vollständig beenden und neu öffnen — die Einstellungen werden beim Start gelesen. In den Cursor-Einstellungen steht knowmind danach bei den MCP-Servern; dort schalten Sie ihn ein, falls neue Server bei Ihnen erst bestätigt werden müssen.

    Ergebnis: Cursor führt knowmind als verbundenen Server mit seinen Werkzeugen.

  5. 5

    Erster Abruf

    Im Cursor-Chat 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: „Merk dir in knowmind: Migrationen laufen nur über das Skript, nie von Hand.“

    Ergebnis: Cursor ruft knowmind_recall_memories auf, der Aufruf ist im Werkzeug-Bereich sichtbar, und die nächste Frage trifft sofort.

Prüfung des Ergebnisses

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

  • Cursor führt knowmind bei den MCP-Servern als verbunden.
  • Im Chat sind die knowmind-Werkzeuge wählbar.
  • Der Abruf steht in der Zeitleiste des Cockpits, und unter Schlüssel steht ein Zeitpunkt der letzten Nutzung.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
npx: Befehl nicht gefundenNode.js fehlt auf diesem Rechner.Von nodejs.org installieren, Terminal neu öffnen, Befehl erneut ausführen.
knowmind erscheint nach dem Befehl nichtCursor lief während der Einrichtung weiter.Cursor vollständig beenden und neu öffnen.
Aufrufe melden 401Der Schlüssel ist unvollständig kopiert oder zurückgezogen.Unter Schlüssel einen neuen erzeugen und den Befehl wiederholen — er ersetzt den alten Eintrag.
Werkzeuge nicht in jedem Chat sichtbarDie Werkzeug-Freigabe ist je Chat wählbar.Im Chat das Werkzeug-Symbol öffnen und knowmind einschalten.
Einrichtung von Hand, und was unter Windows im Eintrag steht

Wer ~/.cursor/mcp.json selbst pflegt, trägt ein:

json
{
  "mcpServers": {
    "knowmind": {
      "command": "npx",
      "args": ["-y", "knowmind", "mcp"],
      "env": {
        "KNOWMIND_TOKEN": "kmt_IHR_SCHLUESSEL",
        "KNOWMIND_API_URL": "https://knowmind.de"
      }
    }
  }
}

Unter Windows schreibt der Befehl einen kleinen Umweg über pythonw.exe in den Eintrag. Das hat einen sichtbaren Grund: npx öffnet bei jedem Start ein Konsolenfenster, pythonw.exe nicht. Ist kein Python vorhanden, steht im Eintrag npx, und alles funktioniert genauso — nur blitzt beim Start kurz ein Fenster auf.

Ohne Terminal geht es auch: In den Cursor-Einstellungen bei den MCP-Servern einen neuen Server anlegen und dort die Adresse https://knowmind.de/api/mcp/v1 mit der Kopfzeile Authorization: Bearer kmt_… eintragen.

Was wir geprüft haben
Geprüft am 19. Oktober 2026: Der Befehl läuft und schreibt ~/.cursor/mcp.json mit dem Schlüssel in der Umgebung; Konto, Arbeitsbereich und Abruf über denselben Weg laufen ebenfalls. Die Oberfläche von Cursor selbst haben wir dabei nicht gegengeprüft, die Benennung der Einstellungen kann je Version abweichen.

Weiterführend