# Koristite Dvina iz drugih aplikacija putem MCP-a

> Povežite MCP klijent kao što je Claude Code, ChatGPT ili Cursor s Dvina, prijavite se i dopustite mu da uz vaše odobrenje čita i dodaje sadržaj u Dvina.

Dvina ima vlastiti MCP poslužitelj. Povežite MCP klijent, kao što je Claude Code, ChatGPT ili Cursor, i ta aplikacija može u vaše ime pretraživati vaš sadržaj u Dvina, čitati vaše dokumente i memoriju te dodavati bilješke, zadatke i podsjetnike.

## Prije nego što počnete

Potrebna vam je adresa poslužitelja:

```text
https://api.dvina.ai/mcp
```

Ako vaša tvrtka pokreće Dvina na vlastitim poslužiteljima, upotrijebite adresu Dvina API-ja svoje tvrtke s `/mcp` na kraju. Zatražite je od administratora.

Poslužitelj koristi Streamable HTTP. Ako klijent traži da odaberete način prijenosa, odaberite HTTP.

## Povežite klijent

::: tabs

=== Claude Code

1. U terminalu pokrenite:

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

2. Pokrenite Claude Code, pokrenite `/mcp`, odaberite **dvina** i prijavite se u Dvina.

=== ChatGPT

1. Otvorite dio aplikacije ChatGPT u kojem možete dodati MCP poslužitelj.
2. Unesite `https://api.dvina.ai/mcp` kao adresu poslužitelja i odaberite OAuth ako se traži način prijave.
3. Prijavite se u Dvina kada ChatGPT to zatraži.

=== Cursor

1. Otvorite dio aplikacije Cursor u kojem možete dodati MCP poslužitelj.
2. Dodajte poslužitelj naziva `dvina` s adresom `https://api.dvina.ai/mcp`.
3. Prijavite se u Dvina kada Cursor to zatraži.

:::

Ne trebate ID klijenta ni tajnu klijenta. Klijent se sam registrira u Dvina pri prvom povezivanju.

## Prijavite se

Dvina MCP poslužitelj prijavljuje vas putem OAutha u vašem pregledniku:

1. Prijavite se u Dvina kao i inače.
2. Ako pripadate više radnih prostora, odaberite jedan pod **Odaberite radni prostor**, a zatim odaberite **Nastavi**. Klijent radi samo u tom radnom prostoru.
3. Pod **Odobrite pristup** provjerite naziv aplikacije, a zatim odaberite **Dopusti pristup**. Odaberite **Odbij** ako je ne prepoznajete.

Klijent ostaje povezan pa se ne morate prijavljivati svaki put.

## Što klijent može raditi

Klijent vidi alate koje Dvina nudi i koristi ih kada su potrebni za vaš zahtjev:

| Područje               | Što klijent može učiniti                                                                                                                      |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pretraživanje**      | Istodobno pretraživati vaše razgovore, dokumente, memoriju i svijet.                                                                          |
| **Memorija**           | Prikazati popis vaših memorijskih datoteka, čitati ih, dodati novu ili izmijeniti postojeću.                                                   |
| **Svijet**             | Prikazati popis vaših tema, pokazati što Dvina zna o nekoj temi ili bilo čemu drugom te prikazati popis stavki u vašem Feedu.                    |
| **Dokumenti**          | Prikazati popis stavki u vašoj Biblioteci, čitati ih i pretraživati, stvarati bilješke i mape, prenositi datoteke te zamijeniti, premjestiti ili preimenovati dokument ili ga premjestiti u smeće. |
| **Platno**             | Prikazati popis vaših platna, čitati ih, stvoriti platno ili prepisati stranicu.                                                               |
| **Zadaci i ciljevi**   | Prikazati popis vaših zadataka i pročitati što su učinili, pokrenuti zadatak ili zadatak koji radi na ostvarenju cilja, dati zadatku još posla ili ga zaustaviti. |
| **Zakazane poruke**    | Prikazati njihov popis, zakazati jednokratnu ili ponavljajuću poruku ili podsjetnik ili ih otkazati.                                           |
| **Agenti i vještine**  | Prikazati popis vaših agenata i vještina, čitati ih, stvoriti agenta, dodati vještinu ili izmijeniti agenta ili vještinu.                        |
| **Projekti**           | Prikazati popis vaših projekata te mapu projekta i nedavne zadatke.                                                                           |
| **Dijeljenje**         | Provjeriti tko ima pristup stavci i što su drugi podijelili s vama te nekome dati ili oduzeti pristup.                                         |
| **Postavke**           | Prikazati vaše preferencije ili uključiti ili isključiti memoriju.                                                                           |

Klijent ne može ništa trajno izbrisati, otvarati javne poveznice, povezivati ili odspajati aplikacije ni mijenjati administratorske postavke ili postavke naplate.

## Odobrite promjene

Za radnje klijenta vrijede ista pravila kao i svugdje u aplikaciji Dvina:

- Čitanje se izvršava bez traženja potvrde.
- Dodavanje nečeg novog, poput bilješke, memorijske datoteke ili zadatka, izvršava se bez traženja potvrde. Time se nikad ne mijenja postojeći sadržaj.
- Za izmjenu ili uklanjanje nečega, poput premještanja dokumenta u smeće, prepisivanja stranice platna, zaustavljanja zadatka ili dijeljenja stavke, prvo se traži vaša potvrda. Klijent prikazuje sažetak promjene koji je izradila Dvina, a vi je odobravate ili odbijate. Ako je odbijete, ništa se ne mijenja.

> [!NOTE]
> Ako klijent ne može zatražiti vašu potvrdu, Dvina neće izvršiti promjenu koju on zatraži. Umjesto toga, izvršite promjenu u aplikaciji Dvina ili upotrijebite klijent koji može zatražiti potvrdu.

## Vaš pristup i pravila vaše tvrtke

Klijent djeluje u vaše ime, s istim pristupom i mogućnostima koje imate u aplikaciji Dvina:

- Radi samo dok ste član radnog prostora i samo u okviru ovlasti vaše uloge.
- Ako administrator isključi neku značajku, poput prijenosa datoteka, ni klijent je ne može koristiti.
- Na ono što klijent dodaje ili mijenja primjenjuju se pravila zaštite podataka vaše tvrtke, kao i u aplikaciji.
- Ono što dodaje ili mijenja bilježi se u vašem [zapisniku revizije](/docs/teams/audit-log) kao radnja asistenta u vaše ime, uz podatak o klijentu iz kojeg je došla.
- Njegove radnje uračunavaju se u vašu potrošnju, unutar vaših uobičajenih ograničenja.

## Povežite se API ključem umjesto putem OAutha

U paketu Enterprise klijent se može povezati osobnim pristupnim tokenom umjesto prijavom. Upotrijebite ga za klijent koji ne podržava prijavu putem OAutha ili za skriptu.

1. Otvorite Postavke i odaberite **API pristup**.
2. U odjeljku **Osobni pristupni tokeni** odaberite **Stvori token**.
3. Unesite **Naziv**, odaberite **Pristup** i kada token **Istječe**, a zatim odaberite **Stvori token**.
4. U odjeljku **Kopirajte svoj token** kopirajte token. Prikazuje se samo tada.

Odaberite pristup koji klijent treba:

- **Samo čitanje:** klijent vidi samo alate za čitanje. Može pretraživati i čitati vaš sadržaj u aplikaciji Dvina, ali ne može ništa dodavati ni mijenjati.
- **Čitanje i pisanje:** klijent vidi sve alate, a za promjene se i dalje traži vaše odobrenje, kao i pri povezivanju putem OAutha.

Pošaljite token u zaglavlju `Authorization`, nakon `Bearer`. Na primjer, u alatu Claude Code:

```sh
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
```

U drugom klijentu dodajte isto zaglavlje na mjestu gdje možete postaviti zaglavlja za MCP poslužitelj.

Token djeluje u vaše ime, u radnom prostoru u kojem ste ga stvorili, s ovlastima vaše trenutačne uloge u tom prostoru. Da biste ga zamijenili, otvorite ga u odjeljku **Osobni pristupni tokeni** i odaberite **Zamijeni…**: novi token zamjenjuje stari, a stari odmah prestaje raditi. Da biste ga opozvali, odaberite **Opozovi…**: sve što ga koristi odmah prestaje raditi.

Više o tokenima potražite u odjeljku [API pristup](/docs/dvina-mcp/api-access).

## Povezano

- [Prilagođene aplikacije i MCP poslužitelji](/docs/connectors/custom-apps)
- [API pristup](/docs/dvina-mcp/api-access)
- [Upotreba naredbe dvina](/docs/dvina-mcp/cli)
- [Pregled timova](/docs/teams/overview)