Dvina MCP

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.

Prikaži kao Markdown

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:

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

Claude Code

  1. U terminalu pokrenite:

    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.

Napomena

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 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:

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.