Das lokale stdio Gateway lässt externe Agenten Dateien, Objekte, Beziehungen und Tabellen abfragen und Änderungen mit stabilen IDs und Revisionen zur Prüfung einreichen.
Lokalen Arbeitsbereich verbinden
Öffne oder aktualisiere den Arbeitsbereich zuerst im Desktop und kopiere die Startkonfiguration aus dem MCP-Panel. Node.js ab 24.12 ist erforderlich. Anwendungsdaten müssen außerhalb des Arbeitsbereichs liegen und dasselbe Verzeichnis wie der Desktop verwenden, damit Vorschläge und Aktivität geteilt werden. Aus dem Open-Source-Checkout:
npm run mcp:build
node apps/mcp/dist/tano-mcp.cjs --workspace /path/to/notes --data-dir /path/to/tano-app-data --access review
| Zugriff | Operationen |
|---|---|
read |
Abfragen und Lesen |
review als Standard |
Lesen und ausstehende Vorschläge |
write |
Zusätzlich ältere direkte Markdown-Erstellung und bedingte Aktualisierung |
Wiederhole --directory und --object-type, um unabhängige Verzeichnis- und Typgrenzen festzulegen. Regeln und Modellausgaben erweitern sie nicht. Ressourcenübergreifende Vorschläge brauchen auch bei write eine Prüfung.
Aktuelle Inhalte abfragen
| Werkzeug | Ergebnis |
|---|---|
tano_gateway_capabilities |
Identität und Rechte |
tano_query_files / tano_read_file |
IDs, Pfade, Eigenschaften, Hashes und Inhalt |
tano_query_objects |
Typisierte Objekte und Revisionen |
tano_query_table |
Datensätze, Ansichten und berechnete Werte |
tano_query_relations |
Beziehungen berechtigter Endpunkte |
tano_read_workspace_rules |
Bekannte Regeln |
Prüfe Fehler und Vollständigkeit, bevor du aus leeren Ergebnissen Schlüsse ziehst. Lies nach ID, behalte den Hash und aktualisiere nach externem Verschieben. Ein Pfad allein beweist keine Identität.
Änderungen einreichen und prüfen
tano_propose_changes unterstützt Markdown, Objekt-JSON und .table.json. Sende operationId und Änderungen mit path, content, reason, expectedHash; bestehende Dateien brauchen zusätzlich fileId. Für neue Dateien ist der Hash null. Wiederhole dieselbe Operations-ID nur mit identischer Eingabe.
Öffne externe Vorschläge im Assistentenverlauf und prüfe jede Differenz vor Annahme oder Ablehnung. tano_get_operation liefert Einzelzustände und Schreibbelege. Einreichen bedeutet nicht Speichern; Teilerfolg ist möglich, keine unteilbare Dateisystemtransaktion.
tano_read_document_identity, tano_propose_document und tano_get_proposal bleiben verfügbar. Markdown kann in die Einzelprüfung; Tabellen und Objekte bleiben im Assistenten.
Direktes Schreiben und Aktivität
tano_list_documents und tano_read_document sind ältere Lesezugriffe. tano_create_document und tano_write_document verlangen --access write. Aktualisieren vergleicht expectedHash mit aktuellem SHA-256; Erstellen überschreibt keine bestehenden Pfade.
Lies nach Ablehnung erneut und führe zusammen; ersetze nicht nur den Hash veralteter Inhalte. tano_list_activity und tano_read_activity zeigen lokale Operationen und Unterschiede. Bezeichnungen authentifizieren keinen Client.
Das Gateway ist lokal über stdio, kein Netzwerk-Kollaborationsserver und kein Terminalausführer. Verborgene Anwendungsdaten und externe symbolische Links sind ausgeschlossen. Siehe Agenten, Dateien und Quellcode-Anleitung.