Dvina hat einen eigenen MCP-Server. Verbinde einen MCP-Client wie Claude Code, ChatGPT oder Cursor. Die App kann dann in deinem Namen dein Dvina durchsuchen, deine Dokumente und Erinnerungen lesen sowie Notizen, Aufgaben und Erinnerungen hinzufügen.
Bevor du beginnst
Du brauchst die Serveradresse:
https://api.dvina.ai/mcp
Wenn dein Unternehmen Dvina auf eigenen Servern betreibt, verwende die Dvina-API-Adresse deines Unternehmens mit /mcp am Ende. Frage deinen Admin nach der Adresse.
Der Server verwendet Streamable HTTP. Wenn ein Client nach dem Transportprotokoll fragt, wähle HTTP.
Einen Client verbinden
Claude Code
Führe in deinem Terminal Folgendes aus:
claude mcp add --transport http dvina https://api.dvina.ai/mcpStarte Claude Code, führe
/mcpaus, wähle dvina und melde dich bei Dvina an.
ChatGPT
- Öffne in ChatGPT den Bereich, in dem du einen MCP-Server hinzufügen kannst.
- Gib
https://api.dvina.ai/mcpals Serveradresse ein und wähle OAuth, falls du nach der Anmeldemethode gefragt wirst. - Melde dich bei Dvina an, wenn ChatGPT dich dazu auffordert.
Cursor
- Open the place where Cursor lets you add an MCP server.
- Add a server named
dvinawith the addresshttps://api.dvina.ai/mcp. - Sign in to Dvina when Cursor asks.
Du brauchst weder eine Client-ID noch ein Client-Secret. Der Client registriert sich bei der ersten Verbindung selbst bei Dvina.
Anmelden
Die Anmeldung beim MCP-Server von Dvina erfolgt über OAuth in deinem Browser:
- Melde dich wie gewohnt bei Dvina an.
- Wenn du mehreren Workspaces angehörst, wähle unter Workspace auswählen einen aus und wähle dann Weiter. Der Client arbeitet nur in diesem Workspace.
- Prüfe unter Zugriff autorisieren den Namen der App und wähle dann Zugriff erlauben. Wähle Ablehnen, wenn du die App nicht kennst.
Der Client bleibt verbunden, sodass du dich nicht jedes Mal anmelden musst.
Was ein Client tun kann
Der Client sieht die Tools von Dvina und verwendet sie, wenn deine Anfrage sie erfordert:
| Bereich | Was der Client tun kann |
|---|---|
| Suche | Deine Chats, Dokumente, dein Gedächtnis und deine Welt gleichzeitig durchsuchen. |
| Gedächtnis | Deine Gedächtnisdateien auflisten und lesen, eine neue hinzufügen oder eine bestehende ändern. |
| Welt | Deine Themen auflisten, anzeigen, was Dvina über ein Thema oder etwas anderes weiß, und deinen Feed auflisten. |
| Dokumente | Deine Bibliothek auflisten, lesen und durchsuchen, Notizen und Ordner erstellen, Dateien hochladen und ein Dokument ersetzen, verschieben, umbenennen oder in den Papierkorb verschieben. |
| Canvas | Deine Canvases auflisten und lesen, ein Canvas erstellen oder eine Seite neu schreiben. |
| Aufgaben und Ziele | Deine Aufgaben auflisten und lesen, was sie erledigt haben, eine Aufgabe oder eine auf ein Ziel ausgerichtete Aufgabe starten, einer Aufgabe weitere Arbeit zuweisen oder sie stoppen. |
| Geplante Nachrichten | Geplante Nachrichten auflisten, eine Nachricht oder Erinnerung einmalig oder wiederkehrend planen oder eine geplante Nachricht abbrechen. |
| Agenten und Skills | Deine Agenten und Skills auflisten und lesen, einen Agenten erstellen, einen Skill hinzufügen oder beides ändern. |
| Projekte | Deine Projekte auflisten und den Ordner sowie die letzten Aufgaben eines Projekts anzeigen. |
| Freigaben | Anzeigen, wer Zugriff auf ein Element hat und was andere mit dir geteilt haben, oder jemandem Zugriff gewähren oder entziehen. |
| Einstellungen | Deine Einstellungen anzeigen oder das Gedächtnis ein- oder ausschalten. |
Der Client kann nichts endgültig löschen, keine öffentlichen Links öffnen, keine Apps verbinden oder trennen und keine Admin- oder Abrechnungseinstellungen ändern.
Änderungen genehmigen
Für die Aktionen des Clients gelten dieselben Regeln wie überall in Dvina:
- Lesen erfolgt ohne Rückfrage.
- Neue Inhalte wie eine Notiz, eine Gedächtnisdatei oder eine Aufgabe werden ohne Rückfrage hinzugefügt. Dabei wird nichts Bestehendes geändert.
- Bevor etwas geändert oder entfernt wird, wirst du gefragt – etwa wenn ein Dokument in den Papierkorb verschoben, eine Canvas-Seite neu geschrieben, eine Aufgabe gestoppt oder ein Element geteilt werden soll. Der Client zeigt dir die von Dvina erstellte Zusammenfassung der Änderung. Du kannst sie genehmigen oder ablehnen. Wenn du ablehnst, ändert sich nichts.
Hinweis
Wenn ein Client dich nicht um Bestätigung bitten kann, führt Dvina die Änderung über diesen Client nicht aus. Nimm die Änderung stattdessen in der Dvina-App vor oder nutze einen Client, der nachfragen kann.
Dein Zugriff und die Regeln deines Unternehmens
Der Client handelt in deinem Namen und kann nur sehen und tun, was du in Dvina sehen und tun kannst:
- Er funktioniert nur, solange du Mitglied des Arbeitsbereichs bist, und nur im Rahmen der Berechtigungen deiner Rolle.
- Wenn dein Admin eine Funktion wie Datei-Uploads deaktiviert, kann auch der Client sie nicht nutzen.
- Was der Client hinzufügt oder ändert, unterliegt wie in der App den Datenschutzregeln deines Unternehmens.
- Was er hinzufügt oder ändert, wird in deinem Audit-Protokoll als Aktion des Assistenten in deinem Namen erfasst, zusammen mit dem Client, von dem die Aktion ausging.
- Seine Aktionen werden innerhalb deiner üblichen Limits auf deine Nutzung angerechnet.
Mit einem API-Schlüssel statt mit OAuth verbinden
Im Enterprise-Tarif kann sich ein Client mit einem persönlichen Zugriffstoken verbinden, statt sich anzumelden. Nutze diese Möglichkeit für einen Client, der sich nicht mit OAuth anmelden kann, oder für ein Skript.
- Öffne die Einstellungen und wähle API-Zugriff.
- Wähle unter Persönliche Zugriffstokens die Option Token erstellen.
- Gib einen Namen ein, wähle den Zugriff und das Ablaufdatum und wähle dann Token erstellen.
- Kopiere den Token unter Token kopieren. Er wird nur dieses eine Mal angezeigt.
Wähle den Zugriff, den der Client benötigt:
- Nur lesen: Der Client sieht nur die Tools zum Lesen. Er kann dein Dvina durchsuchen und lesen, aber nichts hinzufügen oder ändern.
- Lesen und schreiben: Der Client sieht alle Tools. Änderungen erfordern weiterhin deine Genehmigung, genau wie bei OAuth.
Sende den Token im Authorization-Header nach Bearer. In Claude Code zum Beispiel:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
Füge in einem anderen Client denselben Header dort hinzu, wo du Header für einen MCP-Server festlegen kannst.
Der Token handelt in deinem Namen, in dem Arbeitsbereich, in dem du ihn erstellt hast, und mit deiner dort aktuell geltenden Rolle. Um ihn zu ersetzen, öffne ihn unter Persönliche Zugriffstokens und wähle Rotieren…: Ein neuer Token ersetzt ihn, und der alte funktioniert sofort nicht mehr. Um ihn zu deaktivieren, wähle Widerrufen…: Alles, was ihn verwendet, funktioniert sofort nicht mehr.
Mehr über Tokens erfährst du unter API-Zugriff.