MCP-Tools
Alle MCP-Tools, mit denen ein verbundener Agent dein Vault durchsucht, liest und fortschreibt – Parameter, Verhalten und Beispiele.
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.
Löschen
Braucht das Recht löschen. Das ist ab Werk aus. Du schaltest es pro Verbindung unter Agenten verbinden ein, und nur zusammen mit Schreiben.
| Tool | Zweck |
|---|---|
delete_note | Notiz in den Papierkorb legen – nur mit passender expected_version |
Die Notiz landet im Papierkorb, und du holst sie dort mit einem Klick zurück.
Was es nicht gibt
- Endgültig löschen: Per MCP verschwindet nichts für immer, alles landet im Papierkorb.
- Massenänderungen: Schreibt eine Verbindung auffällig viel pro Minute, wird sie gebremst.