Verbinden Sie OneMira mit Cursor, indem Sie den lokalen OneMira-MCP-Server über stdio starten, genau diesen Befehl in Cursor registrieren, die bereitgestellten Werkzeuge prüfen und eine schreibgeschützte Abfrage anhand einer bekannten lokalen Notiz testen. Fügen Sie kein Remote-Token in die Konfiguration eines lokalen Servers ein, sofern das dokumentierte Werkzeug es nicht tatsächlich benötigt.

Versionshinweis. Die Oberflächen von Cursor und MCP ändern sich. Dieser Leitfaden wurde anhand der offiziellen MCP-/CLI-Dokumentation von Cursor und der am 16. Juli 2026 verfügbaren MCP-Sicherheitshinweise geprüft. Die OneMira-Befehle müssen zur installierten Desktop-Version passen.

Was verbinden Sie miteinander?

MCP trennt die KI-Hostanwendung von einem Server, der Werkzeuge oder Ressourcen bereitstellt. Cursor übernimmt die Host-/Client-Seite. Der OneMira-Server ist ein lokaler Prozess, der einen begrenzten OneMira-Notizspeicher liest und strukturierte Ergebnisse zurückgibt. Das Modell erhält nicht automatisch den gesamten Ordner, sondern das Ergebnis eines vom Host genehmigten und ausgeführten Werkzeugaufrufs.

Die offizielle MCP-Architektur unterstützt lokale Server über stdio. Die Sicherheitshinweise empfehlen stdio für lokale Server, soweit praktikabel, da dies den Zugriff auf den startenden Client begrenzt. Zugleich weisen sie darauf hin, dass ein lokaler Server mit den Betriebssystemrechten des Clients ausgeführt wird.

Was sollten Sie vor dem Hinzufügen von Cursor prüfen?

  1. Installieren Sie die unterstützte OneMira-Desktop-App und schließen Sie die dokumentierte C1-Synchronisierung ab.
  2. Öffnen Sie den lokalen Notizordner und wählen Sie eine unkritische Testnotiz aus.
  3. Führen Sie den Diagnose- oder MCP-Listenbefehl aus, den die installierte OneMira-Version angibt.
  4. Prüfen Sie den Pfad der ausführbaren Datei mit command -v oder anhand eines absoluten Pfads.
  5. Prüfen Sie den Befehl: Er sollte den bekannten lokalen OneMira-Server starten, kein ungeprüftes npx -Paket und keine ungeprüfte Shell-Pipeline.

Für Befehlsnamen ist die aktuelle OneMira-Dokumentation maßgeblich: siehe MCP-Einrichtung und CLI-Referenz. Ein Blogartikel sollte keinen Installationspfad festschreiben, der je nach macOS- und Windows-Version abweicht.

Wie fügen Sie den lokalen Server in Cursor hinzu?

Cursor unterstützt MCP-Server. Seine CLI bietet Befehle zum Auflisten der Server und Prüfen ihrer Werkzeuge. Fügen Sie in den MCP-Einstellungen von Cursor einen lokalen stdio -Server hinzu und geben Sie die genaue ausführbare OneMira-Datei samt Argumenten aus der installierten Dokumentation an. Eine beispielhafte Konfiguration hat diese Struktur: 

{
  "mcpServers": {
    "onemira": {
      "command": "/absolute/path/to/onemira",
      "args": ["mcp", "serve"],
      "env": {
        "ONEMIRA_NOTES_ROOT": "/absolute/path/to/OneMira"
      }
    }
  }
}

Dies zeigt die Struktur und verspricht nicht, dass jede Version genau diese Argumentnamen nutzt. Kopieren Sie den Befehl aus der installierten Dokumentation oder App und begrenzen Sie den Notiz-Stammordner so eng wie möglich. Verwenden Sie weder ~ noch das gesamte Laufwerk.

Nahaufnahme des silberweißen C1 aus niedrigem Winkel: Metallseite, USB-C-Anschluss und transparente Abdeckung auf dunkler Oberfläche.
Metallseite und transparente Abdeckung des C1 auf Tischhöhe betrachtet.

Wie prüfen Sie die Verbindung nachvollziehbar?

Die offizielle CLI-Referenz von Cursor nennt cursor-agent mcp list und cursor-agent mcp list-tools <identifier>. Nutzen Sie diese Befehle, wenn sie in Ihrer installierten Version verfügbar sind: 

cursor-agent mcp list
cursor-agent mcp list-tools onemira

Führen Sie anschließend einen vierteiligen Test durch:

  1. Erkennung: Cursor zeigt den OneMira-Server als verbunden an.
  2. Werkzeugprüfung: Namen und Parameter entsprechen der OneMira-Dokumentation; es erscheinen keine unerwarteten Werkzeuge für Shell, Netzwerk oder das gesamte Dateisystem.
  3. Lesetest mit bekanntem Ergebnis: Suchen Sie nach einer eindeutigen Formulierung in der Testnotiz und prüfen Sie den zurückgegebenen Auszug sowie den Quellpfad.
  4. Test außerhalb des erlaubten Bereichs: Fordern Sie eine Datei außerhalb des konfigurierten Notiz-Stammordners an und prüfen Sie, ob der Server dies ablehnt oder nicht darauf zugreifen kann.

Halten Sie Serverversion, Cursor-Version, Konfigurationspfad, Werkzeugliste und Testergebnis fest. Eine grüne Anzeige „verbunden“ allein beweist weder, dass die richtigen Daten erreichbar sind, noch dass die Zugriffsgrenzen eingehalten werden.

Welche Daten können diese Grenze überschreiten?

Es gibt zwei Schritte. Das lokale MCP-Werkzeug liest eine Notiz und gibt Text an Cursor zurück. Cursor kann diesen Text anschließend gemäß seinen Bedingungen und denen des Modellanbieters an das ausgewählte Modell senden. Ein lokaler MCP-Server begrenzt den Kontextabruf; er garantiert nicht, dass abgerufener Kontext auf dem Computer bleibt.

Geben Sie Informationen schrittweise frei:

  • Suchen Sie zuerst in Metadaten und kurzen Auszügen;
  • rufen Sie eine vollständige Notiz nur ab, wenn sie relevant ist;
  • schließen Sie sensible Ordner standardmäßig aus;
  • bevorzugen Sie schreibgeschützte Werkzeuge, sofern kein Schreibzugriff ausdrücklich nötig ist;
  • prüfen Sie jede von einem Agenten erzeugte Dateiänderung als Diff.

Wie gehen Sie bei Fehlern vor?

Symptom Prüfen Vermeiden
Server startet nicht Absoluter Programmpfad, Berechtigungen, Anführungszeichen, App-Version Durch ein unbekanntes Paket ersetzen
Verbunden, aber keine Werkzeuge Serverprotokolle, Protokollaushandlung, installierte Funktionsversion Weitreichende Dateisystemrechte vergeben
Werkzeug liefert keine Notizen Notiz-Stammordner, Synchronisierungsstatus, bekannte Testformulierung, Groß-/Kleinschreibung des Pfads Den gesamten Benutzerordner als Stammordner wählen
Windows-Pfadfehler JSON-Escaping und Form des absoluten Pfads Einen macOS-Pfad wörtlich übernehmen
Unerwarteter Werkzeugaufruf Abbrechen, Werkzeugbeschreibung und Argumente prüfen Genehmigen, weil der Server „lokal“ ist

Wie entfernen Sie den Zugriff vollständig?

Deaktivieren oder löschen Sie den OneMira-Servereintrag in Cursor, starten Sie den Host neu und prüfen Sie, dass der Eintrag nicht mehr in der MCP-Liste erscheint. Entfernen Sie Umgebungszugangsdaten, die eigens für diesen Server hinzugefügt wurden. Die Notizen bleiben normale lokale Dateien; das Entfernen des MCP-Zugriffs löscht sie nicht.

Mehr zum übergreifenden Kontextkonzept lesen Sie in Vom Gespräch zum Kontext. Zu den Sicherheitsgrenzen von MCP beachten Sie die folgenden offiziellen Quellen.

Quellen und weiterführende Informationen