Dvina ka serverin e vet MCP. Lidhni një klient MCP, si Claude Code, ChatGPT ose Cursor, dhe ai aplikacion mund të kërkojë në Dvina tuaj, të lexojë dokumentet dhe kujtesën tuaj, si dhe të shtojë shënime, detyra dhe kujtesa në emrin tuaj.
Para se të filloni
Ju duhet adresa e serverit:
https://api.dvina.ai/mcp
Nëse kompania juaj e përdor Dvina në serverët e vet, përdorni adresën e API-së së Dvina të kompanisë suaj, me /mcp në fund. Kërkojani administratorit tuaj.
Serveri përdor Streamable HTTP. Nëse klienti ju kërkon të zgjidhni një protokoll transporti, zgjidhni HTTP.
Lidhni një klient
Claude Code
Në terminal, ekzekutoni:
claude mcp add --transport http dvina https://api.dvina.ai/mcpNisni Claude Code, ekzekutoni
/mcp, zgjidhni dvina dhe hyni në Dvina.
ChatGPT
- Hapni seksionin ku ChatGPT ju lejon të shtoni një server MCP.
- Vendosni
https://api.dvina.ai/mcpsi adresën e serverit dhe zgjidhni OAuth nëse ju kërkohet mënyra e hyrjes. - Hyni në Dvina kur t'jua kërkojë ChatGPT.
Cursor
- Hapni seksionin ku Cursor ju lejon të shtoni një server MCP.
- Shtoni një server me emrin
dvinadhe adresënhttps://api.dvina.ai/mcp. - Hyni në Dvina kur t'jua kërkojë Cursor.
Nuk ju duhet një ID apo sekret klienti. Klienti regjistrohet vetë në Dvina herën e parë që lidhet.
Hyni në llogari
Serveri MCP i Dvina ju mundëson hyrjen me OAuth në shfletuesin tuaj:
- Hyni në Dvina si zakonisht.
- Nëse jeni pjesë e më shumë se një hapësire pune, zgjidhni njërën te Zgjidhni hapësirën e punës, pastaj zgjidhni Vazhdoni. Klienti punon vetëm në atë hapësirë pune.
- Te Autorizoni qasjen, kontrolloni emrin e aplikacionit, pastaj zgjidhni Lejoni qasjen. Zgjidhni Refuzoni nëse nuk e njihni.
Klienti mbetet i lidhur, ndaj nuk keni nevojë të hyni në llogari çdo herë.
Çfarë mund të bëjë një klient
Klienti sheh mjetet e Dvina dhe i përdor kur kërkesa juaj e kërkon:
| Fusha | Çfarë mund të bëjë klienti |
|---|---|
| Kërkimi | Të kërkojë njëkohësisht në bisedat, dokumentet, kujtesën dhe botën tënde. |
| Kujtesa | Të listojë dhe të lexojë skedarët e kujtesës sate, të shtojë një të ri ose të ndryshojë një ekzistues. |
| Bota | Të listojë temat e tua, të tregojë çfarë di Dvina për një temë ose për çdo gjë tjetër dhe të listojë Prurjet e tua. |
| Dokumentet | Të listojë, të lexojë dhe të kërkojë në Bibliotekën tënde, të krijojë shënime dhe dosje, të ngarkojë skedarë dhe të zëvendësojë, të zhvendosë ose të riemërtojë një dokument, ose ta çojë në kosh. |
| Kanavaca | Të listojë dhe të lexojë kanavacat e tua, të krijojë një kanavacë ose të rishkruajë një faqe. |
| Detyrat dhe synimet | Të listojë detyrat e tua dhe të lexojë çfarë kanë bërë, të nisë një detyrë ose një detyrë që punon drejt një synimi, t'i dërgojë një detyre më shumë punë ose ta ndalojë. |
| Mesazhet e planifikuara | T'i listojë, të planifikojë një mesazh ose kujtesë, një herë ose në mënyrë të përsëritur, ose ta anulojë. |
| Agjentët dhe aftësitë | Të listojë dhe të lexojë agjentët dhe aftësitë e tua, të krijojë një agjent, të shtojë një aftësi ose të ndryshojë cilindo prej tyre. |
| Projektet | Të listojë projektet e tua dhe të tregojë dosjen dhe detyrat e fundit të një projekti. |
| Ndarja | Të shohë kush ka qasje te një element dhe çfarë kanë ndarë të tjerët me ty, ose t'i japë apo t'i heqë dikujt qasjen. |
| Cilësimet | Të tregojë preferencat e tua ose të aktivizojë apo të çaktivizojë kujtesën. |
Klienti nuk mund të fshijë asgjë përgjithmonë, të hapë lidhje publike, të lidhë ose të shkëputë aplikacione, apo të ndryshojë cilësimet e administrimit ose të faturimit.
Mirato ndryshimet
Veprimet e klientit ndjekin të njëjtat rregulla si kudo në Dvina:
- Leximi kryhet pa të pyetur.
- Shtimi i diçkaje të re, si një shënim, një skedar kujtese ose një detyrë, kryhet pa të pyetur. Ai nuk ndryshon kurrë atë që ekziston tashmë.
- Ndryshimi ose heqja e diçkaje, si çuarja e një dokumenti në kosh, rishkrimi i një faqeje kanavace, ndalimi i një detyre ose ndarja e një elementi, kërkon fillimisht miratimin tënd. Klienti shfaq përmbledhjen e ndryshimit të përgatitur nga vetë Dvina dhe ti e miraton ose e refuzon. Kur e refuzon, asgjë nuk ndryshon.
Shënim
Nëse një klient nuk mund të të kërkojë konfirmim, Dvina nuk e kryen ndryshimin e kërkuar prej tij. Në vend të kësaj, bëje ndryshimin në aplikacionin Dvina ose përdor një klient që mund të të kërkojë konfirmim.
Qasja jote dhe rregullat e kompanisë sate
Klienti vepron në emrin tënd dhe ka qasje vetëm tek ajo që ti mund të shohësh dhe të bësh në Dvina:
- Ai funksionon vetëm për sa kohë je ende anëtar i hapësirës së punës dhe vetëm brenda asaj që lejon roli yt.
- Nëse administratori yt çaktivizon një veçori, si ngarkimin e skedarëve, as klienti nuk mund ta përdorë.
- Çdo gjë që klienti shton ose ndryshon kalon nëpër rregullat e mbrojtjes së të dhënave të kompanisë sate, njësoj si në aplikacion.
- Çdo gjë që ai shton ose ndryshon regjistrohet në regjistrin tënd të auditimit si veprim i asistentit në emrin tënd, së bashku me klientin nga i cili erdhi.
- Veprimet e tij llogariten në përdorimin tënd, brenda kufijve të tu të zakonshëm.
Lidhu me një çelës API në vend të OAuth
Në planin Enterprise, një klient mund të lidhet me një token personal qasjeje në vend që të identifikohet. Përdore këtë për një klient që nuk mund të identifikohet me OAuth ose për një skript.
- Hap Cilësimet dhe zgjidh Qasja në API.
- Te Tokenët personalë të qasjes, zgjidh Krijo token.
- Shkruaj një Emër, zgjidh Qasjen dhe kur Skadon, pastaj zgjidh Krijo token.
- Te Kopjo tokenin tënd, kopjo tokenin. Kjo është e vetmja herë që ai shfaqet.
Zgjidh qasjen që i nevojitet klientit:
- Vetëm lexim: klienti sheh vetëm mjetet që lexojnë. Ai mund të kërkojë dhe të lexojë në Dvina tënde, por nuk mund të shtojë ose të ndryshojë asgjë.
- Lexim dhe shkrim: klienti sheh çdo mjet dhe ndryshimet kërkojnë ende miratimin tënd, njësoj si me OAuth.
Dërgo tokenin në fushën Authorization të kreut, pas Bearer. Në Claude Code, për shembull:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
Në një klient tjetër, shto të njëjtën fushë të kreut aty ku mund të caktosh fushat e kreut për një server MCP.
Tokeni vepron në emrin tënd, në hapësirën e punës ku e krijove, me rolin që ke aktualisht aty. Për ta zëvendësuar, hape te Tokenët personalë të qasjes dhe zgjidh Zëvendëso…: një token i ri e zëvendëson dhe i vjetri ndalon së funksionuari menjëherë. Për ta ndaluar, zgjidh Revoko…: çdo gjë që e përdor ndalon së funksionuari menjëherë.
Për më shumë rreth tokenëve, shih Qasja në API.