MCP-Tools
Die Werkzeuge, mit denen ein verbundener Agent dein Vault liest und fortschreibt.
Verbinde deinen Agenten unter Agenten verbinden in der App – per Anmeldung (Claude, ChatGPT) oder Zugangsschlüssel (Claude Code, Cursor).
Lesen
Braucht das Recht lesen.
| Tool | Zweck |
|---|---|
vault_overview | Einstiegspunkt: Struktur, Räume und die Regeln aus 9_System/ |
search_notes | Volltextsuche mit Textausschnitten, auch für deutsche Wortformen |
read_note | Eine Notiz per Pfad oder Titel, mit Versionsnummer |
list_notes | Inhalt eines Ordners |
get_backlinks | Welche Notizen auf diese Notiz verlinken |
Antworten enthalten immer Pfad, Titel, Version und Raum, damit der Agent gezielt weiterarbeiten kann.
Schreiben
Braucht das Recht lesen und schreiben. Jede Änderung braucht eine kurze Zusammenfassung (change_summary), die im Verlauf erscheint.
| Tool | Zweck |
|---|---|
create_note | Neue Notiz mit Pfad und Inhalt |
append_to_note | Text am Ende oder unter einer Überschrift anhängen |
update_section | Den Inhalt unter einer Überschrift ersetzen |
replace_note | Ganze Notiz ersetzen – nur mit passender expected_version |
append_to_note und update_section sind der Normalfall: Sie ändern nur, was sie sollen, und funktionieren auch, wenn du gleichzeitig tippst.
Abschnitte adressieren
Ein Abschnitt reicht von seiner Überschrift bis zur nächsten gleich- oder höherrangigen. Du adressierst ihn über den Text der Überschrift:
| Angabe | Trifft |
|---|---|
Zeitleiste | die Überschrift „Zeitleiste“, egal welche Ebene |
## Zeitleiste | nur eine Überschrift der Ebene 2 |
Projekte > Ziele | „Ziele“ unterhalb von „Projekte“ |
Gibt es eine Überschrift mehrfach, bekommt der Agent eine Fehlermeldung mit allen Kandidaten als Pfad, statt dass geraten wird.
Konflikte
Hat sich eine Notiz seit dem Lesen geändert, schlägt replace_note fehl und nennt erwartete und aktuelle Version. Der Agent liest die Notiz neu und wendet seine Änderung erneut an.
Was es nicht gibt
- Löschen: nur in der App, nie per MCP.
- Massenänderungen: Schreibt eine Verbindung auffällig viel pro Minute, wird sie gebremst.