Dvina MCP

Den dvina-Befehl verwenden

Erfahre, was der dvina-Befehl macht, wenn Dvina Code für dich ausführt, welche Befehle verfügbar sind und welche deine Zustimmung erfordern.

Als Markdown anzeigen

Wenn Dvina Code oder Befehle für dich ausführt, steht dafür ein eigener Befehl zur Verfügung: dvina. Damit kann ein Skript oder eine Folge von Schritten dein Dvina durchsuchen, Dokumente, Erinnerungen und Aufgaben lesen und hinzufügen sowie prüfen, wer Zugriff auf ein Element hat – alles in deinem Namen.

Du musst nichts installieren und dich nirgends anmelden. Dvina verwendet den Befehl, wenn deine Anfrage es erfordert. Du kannst auch ausdrücklich darum bitten, etwa: „Verwende dvina, um meine Aufgaben aufzulisten und eine Zusammenfassung als Notiz zu schreiben.“

So funktioniert es

  • dvina arbeitet in deinem eigenen Dvina, in deinem Namen, mit den Berechtigungen deiner Rolle und innerhalb deiner üblichen Limits.
  • Der Zugriff besteht nur, solange Dvina deine Anfrage bearbeitet. Sobald die Antwort abgeschlossen ist, kann der Befehl nicht mehr auf dein Dvina zugreifen.
  • Eine Datei oder ein Ordner wird nur gelesen, wenn ein Befehl sie oder ihn ausdrücklich nennt, etwa eine Datei zum Hochladen.

Befehle

Befehle sind in Gruppen gegliedert: dvina <group> <command>, gefolgt von den Argumenten und Optionen des Befehls.

Gruppe Befehle
search dvina search <query>: durchsucht deine Chats, Dokumente, Erinnerungen und Welt gleichzeitig.
memory ls, show, add, edit: deine Erinnerungsdateien auflisten, lesen, hinzufügen oder ändern.
world topics, topic, recall, feed: deine Themen, was Dvina über etwas weiß, und dein Feed.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: Dokumente und Ordner deiner Bibliothek.
canvas ls, show, create, write-page: Canvas-Seiten auflisten, lesen, erstellen oder neu schreiben.
tasks ls, show, start, continue, stop: deine Hintergrundaufgaben.
goals show, start: Aufgaben, die auf ein Ziel hinarbeiten.
schedule ls, add, cancel: geplante Nachrichten und Erinnerungen, einmalig oder wiederkehrend.
agents ls, show, create, update: deine Agenten.
skills ls, show, add, edit: deine Skills.
projects ls, show: deine Projekte.
settings get, set: deine Einstellungen, etwa das Ein- oder Ausschalten der Erinnerungsfunktion.
share state, with-me, add, rm: wer Zugriff auf ein Element hat, was andere mit dir geteilt haben, und Zugriff gewähren oder entziehen.

dvina kann nichts endgültig löschen, keine öffentlichen Links öffnen, keine Apps verbinden oder trennen und keine Verwaltungs- oder Abrechnungseinstellungen ändern.

Hilfe und Ausgabe

  • dvina --help listet die Gruppen auf, dvina <group> --help die Befehle einer Gruppe und dvina <group> <command> --help die Argumente und Optionen eines Befehls.
  • Die Ausgabe ist kurzer Text. Füge --json für JSON hinzu oder --fields mit einer kommagetrennten Liste, etwa --fields id,title, um nur bestimmte Felder auszugeben.
  • Eine lange Liste endet mit next: --cursor <c>. Führe den Befehl erneut mit diesem --cursor aus, um die nächste Seite abzurufen.
  • Um einen Wert aus einer Datei zu lesen, ergänze die zugehörige Option um -file, etwa --content-file notes.md. dvina docs upload <file> lädt eine Datei hoch, und dvina skills add <folder> fügt einen Skill-Ordner mit seiner SKILL.md hinzu.

Exit-Codes

Code Bedeutung
0 Erledigt.
1 Ein anderer Fehler ist aufgetreten.
2 Der Befehl ist falsch. Prüfe seine --help-Ausgabe.
3 Nicht gefunden.
4 Abgelehnt: Deine Zugriffsrechte, die Regeln deines Unternehmens oder der Datenschutz lassen es nicht zu.
5 Deine Zustimmung ist erforderlich.
6 Du hast dein Nutzungslimit erreicht.

Änderungen genehmigen

  • Befehle, die Daten lesen, werden ohne Rückfrage ausgeführt.
  • Befehle, die etwas Neues hinzufügen, etwa docs create, memory add oder tasks start, werden ohne Rückfrage ausgeführt. Sie ändern niemals bereits vorhandene Inhalte.
  • Befehle, die etwas ändern oder entfernen, fragen dich zuerst: Verschieben, Umbenennen, in den Papierkorb verschieben, eine Notiz oder Erinnerungsdatei ersetzen, eine Canvas-Seite neu schreiben, einen Agenten oder Skill ändern, eine Aufgabe stoppen, eine geplante Nachricht stornieren und Teilen. Dvina zeigt im Chat eine Genehmigungskarte mit einer eigenen Zusammenfassung der Änderung und fragt jedes Mal nach. Wenn du ablehnst, ändert sich nichts.

Was dvina hinzufügt oder ändert, wird nach den Datenschutzregeln deines Unternehmens geprüft und in deinem Audit-Log erfasst, genau wie die anderen Aktionen von Dvina.