Flexnote MCP: vom Cursor und Codex auf die lokale Wissensbasis zugreifen

Beim Arbeiten in Cursor oder Codex wollen Sie oft lokale Notizen nachschlagen — frühere Entscheidungen, Literaturauszüge, Board-Layouts. Text in einen anderen Chat kopieren oder die App wechseln trennt Wissensbasis und aktuellen Workflow.

Die Flexnote-Desktop-App enthält jetzt einen MCP-Server (Model Context Protocol). Der Dienst lauscht nur auf 127.0.0.1. Clients, die das Protokoll umsetzen — darunter Cursor, Claude Desktop, Codex — können die aktuelle Bibliothek durchsuchen, lesen und schreiben. Daten bleiben auf Ihrem Gerät und werden nicht in eine Drittanbieter-Notizcloud hochgeladen.

1. Unterschied zwischen MCP und Flexnote AI in der App

MCP ist ein offenes Protokoll, mit dem externe KI-Clients aufrufbare Tools deklarieren. Der Client holt die Tool-Liste, ruft sie per Namen auf und erhält JSON-Text. Das Modell wählt der Client; Flexnote vermittelt weder Abrechnung noch Provider.

Die Flexnote AI in der App läuft in der Sidebar: API-Schlüssel aus den Einstellungen, Antworten mit Zitaten, der Agent kann Boards bearbeiten. MCP öffnet dieselbe Bibliothek für externe Entwicklungstools, sodass Sie Tagebuch, Karten, To-dos und Whiteboards nutzen, ohne den Editor zu verlassen.

2. Umfang

Sie können Karten, Tagebuch, Whiteboards, To-dos, Tags und Collections im aktuellen Workspace abfragen. Schreibtools erfordern, den Nur-Lesen-Modus auszuschalten. Canvas-Operationen brauchen eine Whiteboard-ID . Ist das Board nicht offen, wechselt Flexnote dorthin und wartet, bis die Canvas bereit ist, damit die Client-Anfrage nicht timeoutet.

3. Server aktivieren

MCP ist eine Pro-Funktion. Sie brauchen eine gültige Mitgliedschaft und Sign-in, und die Flexnote-Desktop-App muss laufen. Beenden Sie die App, schließt sich der lokale Port, Clients können nicht verbinden.

1. Flexnote → Einstellungen → MCP server öffnen.
2. Dienst aktivieren. Bindung nur an Loopback. Standardport ist 39125.
3. Client-Konfiguration kopieren: HTTP-JSON für Cursor / Claude Desktop. stdio-Bridge für Clients, die command starten. TOML für Codex CLI.
4. Konfiguration im Client ergänzen. Das Access-Token dient nur der lokalen Authentifizierung. Nicht in öffentliche Repositories committen oder teilen.

Zwei weitere Optionen: Nur-Lesen-Modus gibt nur Abfragetools frei — gut für den ersten Verbindungstest. Tools, die Sie keinem externen Modell geben wollen, können Sie einzeln deaktivieren.

4. Verbindung mit Cursor, Claude Desktop und Codex

Cursor / Claude Desktop

Nutzen Sie die HTTP-Konfiguration aus den Einstellungen. Nötige Felder sind lokale URL und Bearer-Token:

{
  "mcpServers": {
    "flexnote": {
      "url": "http://127.0.0.1:39125/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Codex CLI

Codex CLI nutzt meist eine stdio-Bridge: Node führt ein von Flexnote bereitgestelltes Skript aus und leitet die Standardeingabe an den lokalen HTTP-Endpunkt weiter. Kopieren Sie die TOML-Konfiguration aus den Einstellungen und prüfen Sie den Skriptpfad. Setzen Sie die Umgebungsvariablen FLEXNOTE_MCP_URL und FLEXNOTE_MCP_TOKEN.

5. Beispielanfragen

Nach der Verbindung brauchen Sie keine Tool-Namen. Natürliche Sprache reicht. Mit diesen Sätzen prüfen Sie die Anbindung:

• „Welcher Flexnote-Workspace ist gerade offen? Liste die 5 neuesten Whiteboards und Karten. Ändere keine Daten.“
• „Hänge diese Schlussfolgerung an das heutige Tagebuch. Leg es an, falls keins da ist. Speichere sie nicht als normale Notizkarte.“
• „Lege eine Notiz mit dem Titel MCP trial an. Der Körper beginnt mit einer Markdown-Überschrift 1.“
• „Erzeuge auf dem angegebenen Whiteboard (whiteboardId übergeben) zwei Haftnotizen, verbinde sie und lies das Canvas-Layout.“
• „Liste To-dos und markiere eines als erledigt.“

Nach erfolgreichem Schreiben zeigt Flexnote eine Benachrichtigung im Fenster. Gibt es eine passende Entität, öffnet „Anzeigen“ die Seite, sonst können Sie den Bildschirm aktualisieren. Die Benachrichtigung bleibt, bis Sie sie schließen.

6. Sicherheit

Der Dienst lauscht nur auf localhost . Andere Prozesse auf demselben Gerät mit Access-Token können dieselben Tools aufrufen. Behandeln Sie das Token wie Zugangsdaten. Neu erzeugen in den Einstellungen macht frühere Konfigurationen sofort ungültig.

Sind Schreibtools aktiv, kann ein externes Modell die Bibliothek ändern. Beim ersten Test Nur-Lesen aktivieren oder Anlegen, Löschen und Whiteboard-Tools deaktivieren. MCP gilt nur für den gerade offenen Workspace. Prüfen Sie den Workspace vor dem Schreiben.

7. Grenzen

• Nur-Browser ohne Desktop-App hat keinen lokalen MCP-Port.
• Kein Team-Gateway und kein öffentlicher Netz-Zugang. Nicht zum Teilen der Bibliothek mit anderen.
• Flexnote ist kein Echtzeit-Multiplayer-Whiteboard, und MCP fügt das nicht hinzu. Zum Produktumfang siehe Was ist Flexnote.

8. Einstieg

Aktualisieren Sie die Desktop-App auf einen Build mit MCP, melden Sie sich mit einem Pro-Konto an, aktivieren Sie den Server in den Einstellungen und fügen Sie die Konfiguration in Cursor oder Codex ein. Prüfen Sie die Suche im Nur-Lesen-Modus, bevor Sie Schreiben aktivieren. Clients über die Download-Seite. Details zu Pro unter Preise.

Den bestehenden Workflow des In-App-Wissens-Agents müssen Sie nicht ändern. MCP verbindet dieselbe lokale Bibliothek mit externen Entwicklungstools.