Dvina heeft een eigen MCP-server. Verbind een MCP-client, zoals Claude Code, ChatGPT of Cursor, en die app kan namens jou je Dvina doorzoeken, je documenten en geheugen lezen en notities, taken en herinneringen toevoegen.
Voordat je begint
Je hebt het adres van de server nodig:
https://api.dvina.ai/mcp
Als je bedrijf Dvina op eigen servers draait, gebruik je het eigen Dvina API-adres van je bedrijf met /mcp aan het einde. Vraag je beheerder om het adres.
De server gebruikt Streamable HTTP. Vraagt een client om een transportprotocol, kies dan HTTP.
Een client verbinden
Claude Code
Voer in je terminal het volgende uit:
claude mcp add --transport http dvina https://api.dvina.ai/mcpStart Claude Code, voer
/mcpuit, kies dvina en log in bij Dvina.
ChatGPT
- Open in ChatGPT de plek waar je een MCP-server kunt toevoegen.
- Voer
https://api.dvina.ai/mcpin als serveradres en kies OAuth als je wordt gevraagd hoe je wilt inloggen. - Log in bij Dvina wanneer ChatGPT daarom vraagt.
Cursor
- Open in Cursor de plek waar je een MCP-server kunt toevoegen.
- Voeg een server toe met de naam
dvinaen het adreshttps://api.dvina.ai/mcp. - Log in bij Dvina wanneer Cursor daarom vraagt.
Je hebt geen client-ID of clientgeheim nodig. De client registreert zichzelf bij Dvina wanneer deze voor het eerst verbinding maakt.
Inloggen
Bij de MCP-server van Dvina log je via OAuth in je browser in:
- Log in bij Dvina zoals je gewend bent.
- Als je lid bent van meer dan één werkruimte, kies je er een onder Werkruimte selecteren en kies je vervolgens Doorgaan. De client werkt alleen in die werkruimte.
- Controleer onder Toegang autoriseren de naam van de app en kies vervolgens Toegang toestaan. Kies Weigeren als je de app niet herkent.
De client blijft verbonden, zodat je niet elke keer hoeft in te loggen.
Wat een client kan doen
De client ziet de tools van Dvina en gebruikt ze wanneer dat nodig is voor je verzoek:
| Onderdeel | Wat de client kan doen |
|---|---|
| Zoeken | Tegelijk zoeken in je chats, documenten, geheugen en wereld. |
| Geheugen | Je geheugenbestanden weergeven en lezen, een nieuw bestand toevoegen of een bestand wijzigen. |
| Wereld | Je onderwerpen weergeven, tonen wat Dvina weet over een onderwerp of iets anders, en je Feed weergeven. |
| Documenten | Je bibliotheek weergeven, lezen en doorzoeken, notities en mappen maken, bestanden uploaden en een document vervangen, verplaatsen, hernoemen of naar de prullenmand verplaatsen. |
| Canvas | Je canvassen weergeven en lezen, een canvas maken of een pagina herschrijven. |
| Taken en doelen | Je taken weergeven en lezen wat ze hebben gedaan, een taak starten of een taak die naar een doel toewerkt, een taak extra werk geven of een taak stoppen. |
| Geplande berichten | Geplande berichten weergeven, een eenmalig of herhalend bericht of een herinnering plannen, of een gepland bericht annuleren. |
| Agents en vaardigheden | Je agents en vaardigheden weergeven en lezen, een agent maken, een vaardigheid toevoegen of een van beide wijzigen. |
| Projecten | Je projecten weergeven en de map en recente taken van een project tonen. |
| Delen | Bekijken wie toegang heeft tot een item en wat anderen met je hebben gedeeld, of iemand toegang geven of diens toegang intrekken. |
| Instellingen | Je voorkeuren tonen of het geheugen in- of uitschakelen. |
De client kan niets definitief verwijderen, openbare links openen, apps koppelen of ontkoppelen, of beheer- of factureringsinstellingen wijzigen.
Wijzigingen goedkeuren
Voor wat de client doet, gelden dezelfde regels als overal in Dvina:
- Lezen gebeurt zonder om toestemming te vragen.
- Iets nieuws toevoegen, zoals een notitie, een geheugenbestand of een taak, gebeurt zonder om toestemming te vragen. Dit verandert nooit wat er al is.
- Iets wijzigen of verwijderen, zoals een document naar de prullenmand verplaatsen, een canvaspagina herschrijven, een taak stoppen of een item delen, vraagt eerst om je toestemming. De client toont Dvina's eigen samenvatting van de wijziging. Je keurt die goed of wijst die af. Als je de wijziging afwijst, verandert er niets.
Opmerking
Als een client je niet om bevestiging kan vragen, voert Dvina de wijziging vanuit die client niet uit. Voer de wijziging dan uit in de Dvina-app of gebruik een client die wel om bevestiging kan vragen.
Je toegang en de regels van je bedrijf
De client handelt namens jou en kan alleen zien en doen wat jij in Dvina kunt zien en doen:
- De client werkt alleen zolang je lid bent van de werkruimte, en alleen binnen de rechten van je rol.
- Als je beheerder een functie uitschakelt, zoals het uploaden van bestanden, kan de client die ook niet gebruiken.
- Wat de client toevoegt of wijzigt, wordt getoetst aan de regels voor gegevensbescherming van je bedrijf, net als in de app.
- Wat de client toevoegt of wijzigt, wordt in je auditlog vastgelegd als een actie van de assistent namens jou, met vermelding van de client waaruit die kwam.
- Wat de client doet, telt mee voor je verbruik en valt binnen je gebruikelijke limieten.
Verbinden met een API-sleutel in plaats van OAuth
Met het Enterprise-abonnement kan een client verbinding maken met een persoonlijk toegangstoken in plaats van in te loggen. Gebruik dit voor een client die niet met OAuth kan inloggen, of voor een script.
- Open Instellingen en kies API-toegang.
- Kies onder Persoonlijke toegangstokens de optie Token maken.
- Voer een Naam in, kies de Toegang en wanneer het token Verloopt, en kies vervolgens Token maken.
- Kopieer het token onder Kopieer je token. Dit is de enige keer dat het wordt getoond.
Kies de toegang die de client nodig heeft:
- Alleen lezen: de client ziet alleen de tools die gegevens lezen. De client kan zoeken en lezen in je Dvina, maar niets toevoegen of wijzigen.
- Lezen en schrijven: de client ziet alle tools. Wijzigingen vragen nog steeds om je goedkeuring, net als bij OAuth.
Stuur het token mee in de Authorization-header, na Bearer. In Claude Code bijvoorbeeld:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
Voeg in een andere client dezelfde header toe op de plek waar je headers voor een MCP-server kunt instellen.
Het token handelt namens jou, in de werkruimte waarin je het hebt gemaakt, met je huidige rol daar. Om het te vervangen, open je het onder Persoonlijke toegangstokens en kies je Vernieuwen…: een nieuw token vervangt het oude, en het oude werkt meteen niet meer. Om het in te trekken, kies je Intrekken…: alles wat het token gebruikt, werkt meteen niet meer.
Zie API-toegang voor meer informatie over tokens.