# Koristite Dvina iz drugih aplikacija putem MCP-a

> Povežite MCP klijent poput Claude Code, ChatGPT ili Cursor s aplikacijom Dvina, prijavite se i omogućite mu da uz vaše odobrenje čita i dodaje sadržaj u Dvina.

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

## Prije nego što počnete

Potrebna vam je adresa servera:

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

Ako vaša kompanija koristi Dvina na vlastitim serverima, koristite adresu Dvina API-ja vaše kompanije i dodajte `/mcp` na kraj. Zatražite je od administratora.

Server koristi Streamable HTTP. Ako klijent traži da odaberete transport, 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 server.
2. Unesite `https://api.dvina.ai/mcp` kao adresu servera 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 server.
2. Dodajte server pod nazivom `dvina` s adresom `https://api.dvina.ai/mcp`.
3. Prijavite se u Dvina kada Cursor to zatraži.

:::

Ne trebaju vam ID klijenta ni tajni ključ. Klijent se sam registruje u Dvina pri prvom povezivanju.

## Prijavite se

Dvina MCP server prijavljuje vas putem OAuth-a u vašem pregledniku:

1. Prijavite se u Dvina kao i obično.
2. Ako pripadate više od jednog radnog 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 **Dozvoli pristup**. Odaberite **Odbij** ako je ne prepoznajete.

Klijent ostaje povezan, pa se ne morate prijavljivati svaki put.

## Šta klijent može raditi

Klijent vidi alate aplikacije Dvina i koristi ih kada to vaš zahtjev iziskuje:

| Područje               | Šta klijent može uraditi                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pretraga**           | Pretraživati vaše razgovore, dokumente, memoriju i svijet odjednom.                                                                            |
| **Memorija**           | Prikazati spisak datoteka memorije i čitati ih, dodati novu ili izmijeniti postojeću.                                                           |
| **Svijet**             | Prikazati spisak vaših tema, pokazati šta Dvina zna o nekoj temi ili bilo čemu drugom te prikazati vaš Feed.                                    |
| **Dokumenti**          | Prikazati sadržaj vaše Biblioteke, čitati ga i pretraživati, kreirati bilješke i fascikle, otpremati datoteke te zamijeniti, premjestiti ili preimenovati dokument ili ga premjestiti u smeće. |
| **Platno**             | Prikazati spisak vaših platna i čitati ih, kreirati platno ili prepisati stranicu.                                                              |
| **Zadaci i ciljevi**   | Prikazati spisak vaših zadataka i pročitati šta su uradili, pokrenuti zadatak ili zadatak usmjeren na ostvarenje cilja, poslati zadatku dodatni posao ili ga zaustaviti. |
| **Zakazane poruke**    | Prikazati njihov spisak, zakazati jednokratnu ili ponavljajuću poruku ili podsjetnik ili ih otkazati.                                           |
| **Agenti i vještine**  | Prikazati spisak vaših agenata i vještina i čitati ih, kreirati agenta, dodati vještinu ili izmijeniti agenta ili vještinu.                      |
| **Projekti**           | Prikazati spisak vaših projekata te fasciklu i nedavne zadatke projekta.                                                                       |
| **Dijeljenje**         | Vidjeti ko ima pristup stavci i šta su drugi podijelili s vama ili nekome dodijeliti ili ukinuti pristup.                                      |
| **Postavke**           | Prikazati vaše željene postavke ili uključiti ili isključiti memoriju.                                                                        |

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

## Odobrite izmjene

Za radnje klijenta važe ista pravila kao i svugdje u aplikaciji Dvina:

- Čitanje se obavlja bez traženja odobrenja.
- Dodavanje nečeg novog, poput bilješke, datoteke memorije ili zadatka, obavlja se bez traženja odobrenja. Time se nikad ne mijenja ono što već postoji.
- 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še odobrenje. Klijent prikazuje sažetak izmjene koji daje Dvina, a vi ga odobravate ili odbijate. Ako odbijete, ništa se ne mijenja.

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

## Vaš pristup i pravila vaše kompanije

Klijent djeluje u vaše ime i ima pristup onome što vi možete vidjeti i uraditi u aplikaciji Dvina:

- Radi samo dok ste član radnog prostora i samo u okviru ovlaštenja vaše uloge.
- Ako vaš administrator isključi neku funkciju, poput otpremanja datoteka, ni klijent je ne može koristiti.
- Na ono što klijent doda ili izmijeni primjenjuju se pravila zaštite podataka vaše kompanije, kao i u aplikaciji.
- Ono što doda ili izmijeni bilježi se u vašem [dnevniku revizije](/docs/teams/audit-log) kao radnja asistenta u vaše ime, uz podatak o klijentu iz kojeg je potekla.
- Njegove radnje računaju se u vašu potrošnju, u okviru vaših uobičajenih ograničenja.

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

Na planu Enterprise klijent se može povezati pomoću ličnog pristupnog tokena umjesto prijavom. Koristite ovu opciju za klijent koji se ne može prijaviti putem OAuth ili za skriptu.

1. Otvorite Postavke i odaberite **API pristup**.
2. U odjeljku **Lični pristupni tokeni** odaberite **Kreiraj token**.
3. Unesite **Naziv**, odaberite **Pristup** i kada token **Ističe**, a zatim odaberite **Kreiraj token**.
4. U odjeljku **Kopirajte svoj token** kopirajte token. Prikazuje se samo ovaj put.

Odaberite pristup koji je klijentu potreban:

- **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 izmjene se i dalje traži vaše odobrenje, kao i kod povezivanja putem OAuth.

Pošaljite token u zaglavlju `Authorization`, nakon `Bearer`. Naprimjer, u 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 tamo gdje možete postaviti zaglavlja za MCP server.

Token djeluje u vaše ime, u radnom prostoru u kojem ste ga kreirali, s ovlaštenjima vaše trenutne uloge u tom prostoru. Da biste ga zamijenili, otvorite ga u odjeljku **Lični pristupni tokeni** i odaberite **Zamijeni…**: novi token zamjenjuje postojeći, a stari odmah prestaje raditi. Da biste ga opozvali, odaberite **Opozovi…**: sve što ga koristi odmah prestaje raditi.

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

## Povezano

- [Prilagođene aplikacije i MCP serveri](/docs/connectors/custom-apps)
- [API pristup](/docs/dvina-mcp/api-access)
- [Koristite naredbu dvina](/docs/dvina-mcp/cli)
- [Pregled timova](/docs/teams/overview)