Dvina are propriul server MCP. Conectează un client MCP, precum Claude Code, ChatGPT sau Cursor, iar aplicația respectivă va putea să caute în Dvina, să îți citească documentele și memoria și să adauge notițe, sarcini și mementouri în numele tău.
Înainte să începi
Ai nevoie de adresa serverului:
https://api.dvina.ai/mcp
Dacă firma ta rulează Dvina pe propriile servere, folosește adresa API Dvina a firmei, cu /mcp la final. Cere-i administratorului această adresă.
Serverul folosește Streamable HTTP. Dacă un client îți cere să alegi un protocol de transport, alege HTTP.
Conectează un client
Claude Code
În terminal, rulează:
claude mcp add --transport http dvina https://api.dvina.ai/mcpPornește Claude Code, rulează
/mcp, alege dvina și autentifică-te în Dvina.
ChatGPT
- Deschide secțiunea din ChatGPT în care poți adăuga un server MCP.
- Introdu
https://api.dvina.ai/mcpca adresă a serverului și alege OAuth dacă ți se cere metoda de autentificare. - Autentifică-te în Dvina când ChatGPT îți cere acest lucru.
Cursor
- Deschide secțiunea din Cursor în care poți adăuga un server MCP.
- Adaugă un server numit
dvinacu adresahttps://api.dvina.ai/mcp. - Autentifică-te în Dvina când Cursor îți cere acest lucru.
Nu ai nevoie de un ID de client sau de un secret. Clientul se înregistrează singur în Dvina la prima conectare.
Autentifică-te
Serverul MCP Dvina te autentifică prin OAuth, în browser:
- Autentifică-te în Dvina ca de obicei.
- Dacă faci parte din mai multe spații de lucru, alege unul în Selectează spațiul de lucru, apoi alege Continuă. Clientul funcționează doar în acel spațiu de lucru.
- În Autorizează accesul, verifică numele aplicației, apoi alege Permite accesul. Alege Refuză dacă nu o recunoști.
Clientul rămâne conectat, așa că nu trebuie să te autentifici de fiecare dată.
Ce poate face un client
Clientul vede instrumentele Dvina și le folosește când solicitarea ta o cere:
| Zonă | Ce poate face clientul |
|---|---|
| Căutare | Caută simultan în conversațiile, documentele, memoria și lumea ta. |
| Memorie | Listează și citește fișierele de memorie, adaugă un fișier nou sau modifică unul existent. |
| Lume | Listează subiectele tale, arată ce știe Dvina despre un subiect sau orice altceva și listează fluxul tău. |
| Documente | Listează, citește și caută în biblioteca ta, creează note și dosare, încarcă fișiere și înlocuiește, mută sau redenumește un document ori îl mută în coșul de gunoi. |
| Canvas | Listează și citește canvasurile tale, creează un canvas sau rescrie o pagină. |
| Sarcini și obiective | Listează sarcinile tale și citește ce au făcut, pornește o sarcină sau o sarcină care contribuie la un obiectiv, îi dă unei sarcini mai multe lucruri de făcut sau o oprește. |
| Mesaje programate | Le listează, programează un mesaj sau un memento, o singură dată sau cu repetare, ori anulează unul. |
| Agenți și abilități | Listează și citește agenții și abilitățile tale, creează un agent, adaugă o abilitate sau modifică un agent ori o abilitate. |
| Proiecte | Listează proiectele tale și afișează dosarul și sarcinile recente ale unui proiect. |
| Partajare | Arată cine are acces la un element și ce au partajat alții cu tine sau acordă ori retrage accesul cuiva. |
| Configurări | Afișează preferințele tale sau activează ori dezactivează memoria. |
Clientul nu poate șterge definitiv nimic, deschide linkuri publice, conecta sau deconecta aplicații ori modifica configurările de administrare sau facturare.
Aprobă modificările
Acțiunile clientului urmează aceleași reguli ca peste tot în Dvina:
- Citirea se face fără să ți se ceară aprobarea.
- Adăugarea unui element nou, cum ar fi o notă, un fișier de memorie sau o sarcină, se face fără să ți se ceară aprobarea. Nu modifică niciodată ceea ce există deja.
- Modificarea sau eliminarea unui element, cum ar fi mutarea unui document în coșul de gunoi, rescrierea unei pagini de canvas, oprirea unei sarcini sau partajarea unui element, necesită mai întâi aprobarea ta. Clientul afișează rezumatul modificării furnizat de Dvina, iar tu o aprobi sau o refuzi. Dacă o refuzi, nu se schimbă nimic.
Notă
Dacă un client nu îți poate cere confirmarea, Dvina nu efectuează modificarea solicitată de acesta. Fă modificarea în aplicația Dvina sau folosește un client care îți poate cere confirmarea.
Accesul tău și regulile companiei tale
Clientul acționează în numele tău și are acces la ceea ce poți vedea și face tu în Dvina:
- Funcționează doar cât timp ești membru al spațiului de lucru și doar în limitele permise de rolul tău.
- Dacă administratorul tău dezactivează o funcție, cum ar fi încărcarea fișierelor, nici clientul nu o poate folosi.
- Tot ce adaugă sau modifică clientul este supus regulilor de protecție a datelor ale companiei tale, la fel ca în aplicație.
- Tot ce adaugă sau modifică este înregistrat în jurnalul tău de audit ca acțiune a asistentului în numele tău, cu indicarea clientului din care provine.
- Acțiunile sale sunt incluse în utilizarea ta, în limitele tale obișnuite.
Conectează-te cu o cheie API în loc de OAuth
În planul Enterprise, un client se poate conecta cu un token de acces personal în loc să se autentifice. Folosește această opțiune pentru un client care nu se poate autentifica prin OAuth sau pentru un script.
- Deschide Configurări și alege Acces API.
- În Tokenuri de acces personal, alege Creează un token.
- Introdu un Nume, alege Accesul și când Expiră, apoi alege Creează un token.
- În Copiază tokenul, copiază tokenul. Aceasta este singura dată când este afișat.
Alege accesul de care are nevoie clientul:
- Doar citire: clientul vede doar instrumentele de citire. Poate căuta și citi conținutul tău din Dvina, dar nu poate adăuga sau modifica nimic.
- Citire și scriere: clientul vede toate instrumentele, iar modificările necesită în continuare aprobarea ta, la fel ca în cazul OAuth.
Trimite tokenul în antetul Authorization, după Bearer. În Claude Code, de exemplu:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
În alt client, adaugă același antet acolo unde poți configura antetele pentru un server MCP.
Tokenul acționează în numele tău, în spațiul de lucru în care l-ai creat, cu rolul pe care îl ai în prezent acolo. Pentru a-l înlocui, deschide-l din Tokenuri de acces personal și alege Rotește…: un token nou îl înlocuiește, iar cel vechi nu mai funcționează imediat. Pentru a-l dezactiva, alege Revocă…: orice îl folosește nu mai funcționează imediat.
Pentru mai multe informații despre tokenuri, consultă Acces API.