# Folosește Dvina din alte aplicații prin MCP

> Conectează un client MCP precum Claude Code, ChatGPT sau Cursor la Dvina, autentifică-te și permite-i să citească și să adauge conținut în Dvina cu aprobarea ta.

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:

```text
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

::: tabs

=== Claude Code

1. În terminal, rulează:

    ```sh
    claude mcp add --transport http dvina https://api.dvina.ai/mcp
    ```

2. Pornește Claude Code, rulează `/mcp`, alege **dvina** și autentifică-te în Dvina.

=== ChatGPT

1. Deschide secțiunea din ChatGPT în care poți adăuga un server MCP.
2. Introdu `https://api.dvina.ai/mcp` ca adresă a serverului și alege OAuth dacă ți se cere metoda de autentificare.
3. Autentifică-te în Dvina când ChatGPT îți cere acest lucru.

=== Cursor

1. Deschide secțiunea din Cursor în care poți adăuga un server MCP.
2. Adaugă un server numit `dvina` cu adresa `https://api.dvina.ai/mcp`.
3. 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:

1. Autentifică-te în Dvina ca de obicei.
2. 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.
3. Î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.

> [!NOTE]
> 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](/docs/teams/audit-log) 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.

1. Deschide Configurări și alege **Acces API**.
2. În **Tokenuri de acces personal**, alege **Creează un token**.
3. Introdu un **Nume**, alege **Accesul** și când **Expiră**, apoi alege **Creează un token**.
4. Î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:

```sh
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](/docs/dvina-mcp/api-access).

## Articole conexe

- [Aplicații personalizate și servere MCP](/docs/connectors/custom-apps)
- [Acces API](/docs/dvina-mcp/api-access)
- [Folosește comanda dvina](/docs/dvina-mcp/cli)
- [Prezentare generală a echipelor](/docs/teams/overview)