Notez per MCP mit Claude, Cursor und Windsurf verbinden

AI

Dein KI-Assistent weiß eine Menge über dein aktuelles Problem und gar nichts über die acht Monate Notizen, in denen du eine Variante davon schon einmal gelöst hast.

Der Notez-MCP-Server schließt diese Lücke. Das Model Context Protocol ist ein offener Standard, über den Assistenten externe Tools und Daten nutzen, und Notez bringt einen MCP-Server mit, der deinen Workspace darüber bereitstellt.

Einrichtung

1. Schlüssel generieren. Geh in Notez zu Einstellungen → Integrationen, such Notez-MCP-Server und klick auf MCP-Schlüssel generieren. Kopiere den Endpoint und das Bearer-Token – das Token wird nur einmal angezeigt.

2. Im Client eintragen. Die Seite Integrationen liefert einen fertigen Befehl für Claude Code, in dem Endpoint und Token schon eingesetzt sind, dazu JSON-Konfigurationen für Claude Code, Cursor und Windsurf mit dem richtigen Dateipfad für jeden Client. Claude (Web, Desktop und Mobil), ChatGPT und VS Code brauchen keinen Schlüssel: Sie verbinden sich per Anmeldung über die Karte KI-App verbinden auf derselben Seite.

Kopiere von dieser Seite, statt abzutippen – der Authorization-Header muss exakt stimmen, sonst scheitert jeder Aufruf.

3. Starte deinen Client neu und frag ihn etwas zu deinen Notizen.

Die Tools

Ein Schlüssel gibt einem Assistenten 31 Tools: 13 zum Lesen und 18 zum Schreiben. Die Tabelle zeigt die, zu denen er zuerst greift; alle stehen in MCP-Server einrichten.

Tool

Was es macht

get_current_workspace

Für welchen Workspace dieser Schlüssel gilt

list_notes

Suchen und auflisten, mit Filtern und Paginierung

get_note

Eine Notiz, als Zusammenfassung oder vollständig

get_note_children

Die direkten Unternotizen einer Notiz

get_note_ancestors

Die Breadcrumb-Kette bis zur obersten Ebene

list_tags

Alle Tags mit der Zahl ihrer Notizen

search_similar_notes

Semantische Suche nach Bedeutung, bis zu 5 Ergebnisse

get_board

Ein Kanban-Board mit seinen Karten, nach Spalten gruppiert

create_note

Eine Notiz anlegen, Markdown wird unterstützt

edit_note_content

Einen Teil einer Notiz ändern, der Rest bleibt unangetastet

move_note_to_board_column

Karten zwischen den Spalten eines Boards verschieben

delete_note / restore_note

Eine Notiz in den Papierkorb verschieben oder zurückholen

list_notes unterstützt Teilstring-Suche, Tag-Filter, Board-Spalten, Werte eigener Eigenschaften, Erstellungs- und Änderungsdatum, Notiztyp, nur Favoriten, nur oberste Ebene, Papierkorb, Sortierung und Paginierung. So findet sich ein Assistent auch in einem großen Workspace zurecht, ohne alles in den Kontext zu laden.

Zwei Grenzen, die du vorher kennen solltest

Struktur löscht er nicht. Ein Schlüssel liest und schreibt: Ein Assistent legt Notizen an, bearbeitet, benennt um, taggt und verschiebt sie, löscht sie in den Papierkorb und stellt sie wieder her. Kein Tool löscht ein Tag, eine Eigenschaft, eine Option oder eine Board-Spalte, das bleibt deine Sache. Der KI-Chat in der App nutzt dieselben Tools, bis auf die zwei für Datei-Uploads.

Schlüssel sind an einen Workspace gebunden. Ein Schlüssel aus deinem Workspace „Arbeit“ gibt nur Zugriff auf „Arbeit“. Für einen zweiten Workspace wechselst du dorthin und generierst einen eigenen Schlüssel. Jeden Schlüssel erneuerst du auf derselben Seite.

Wofür das im Alltag gut ist

Eine Sitzung mit einem schriftlichen Protokoll abschließen. Der wertvollste Moment beim Debuggen ist der, in dem es endlich läuft, und genau dann hast du am wenigsten Lust, etwas aufzuschreiben. „Leg eine Notiz mit dem Titel Postgres-Pool erschöpft an, mit dem, was wir gerade herausgefunden haben, und tagge sie mit infra.“ Erledigt, bevor du das Terminal schließt.

Früheren Kontext zurückholen. „Durchsuch meine Notizen nach allem zu Rate Limiting, bevor wir das hier entwerfen.“ Dein Assistent liest, zu welchem Schluss dein früheres Ich gekommen ist, statt es neu herzuleiten, womöglich mit anderem Ergebnis.

Meeting-Vorbereitung. „Finde alle meine Notizen mit dem Tag acme aus den letzten zwei Monaten und fass die offenen Punkte zusammen.“

Über die Grenze hinweg arbeiten. Notizen, die über MCP entstanden sind, tragen ein MCP-Badge. So siehst du immer, was dein Assistent geschrieben hat und was du.

Zum Thema Vertrauen

Ein MCP-Schlüssel gibt Lese- und Schreibzugriff auf einen ganzen Workspace. Behandle ihn wie alle anderen Zugangsdaten: Er wird einmal angezeigt, liegt in der Konfigurationsdatei deines Clients und muss erneuert werden, wenn er nach außen gelangt. Erneuern ist ein Klick auf der Seite Integrationen und macht den alten Schlüssel sofort ungültig.

Die eigentliche Sicherheitsgarantie ist die Bindung an den Workspace. Wenn du private und berufliche Notizen in getrennten Workspaces führst, wie ich es empfehle, kommt ein Schlüssel in einem Arbeitsprojekt tatsächlich an nichts Privates heran. Das erzwingt der Server bei jedem Tool-Aufruf, nicht eine Anweisung im Prompt.

Weiterlesen