A Dvina saját MCP-szerverrel rendelkezik. Csatlakoztass egy MCP-klienst, például a Claude Code, a ChatGPT vagy a Cursor alkalmazást, és az alkalmazás a nevedben kereshet a Dvina rendszerében, olvashatja a dokumentumaidat és a memóriádat, valamint jegyzeteket, feladatokat és emlékeztetőket adhat hozzá.
Mielőtt elkezded
Szükséged lesz a szerver címére:
https://api.dvina.ai/mcp
Ha a céged saját szerverein futtatja a Dvina rendszerét, használd a céged saját Dvina API-címét, a végén a /mcp útvonallal. A címet kérd a rendszergazdádtól.
A szerver Streamable HTTP-t használ. Ha a kliens az átviteli módot kéri, válaszd a HTTP-t.
Kliens csatlakoztatása
Claude Code
Futtasd a terminálban:
claude mcp add --transport http dvina https://api.dvina.ai/mcpIndítsd el a Claude Code alkalmazást, futtasd a
/mcpparancsot, válaszd a dvina lehetőséget, majd jelentkezz be a Dvina rendszerébe.
ChatGPT
- Nyisd meg a ChatGPT felületén az MCP-szerver hozzáadására szolgáló részt.
- Add meg a
https://api.dvina.ai/mcpcímet a szerver címeként, és válaszd az OAuth lehetőséget, ha az alkalmazás rákérdez a bejelentkezés módjára. - Jelentkezz be a Dvina rendszerébe, amikor a ChatGPT erre kér.
Cursor
- Open the place where Cursor lets you add an MCP server.
- Add a server named
dvinawith the addresshttps://api.dvina.ai/mcp. - Sign in to Dvina when Cursor asks.
Nincs szükséged kliensazonosítóra vagy titkos kulcsra. A kliens az első csatlakozáskor automatikusan regisztrálja magát a Dvina rendszerében.
Bejelentkezés
A Dvina MCP-szervere OAuth használatával, a böngésződben jelentkeztet be:
- Jelentkezz be a Dvina rendszerébe a megszokott módon.
- Ha több munkaterülethez is tartozol, válassz egyet a Munkaterület kiválasztása résznél, majd válaszd a Folytatás lehetőséget. A kliens csak ezen a munkaterületen működik.
- A Hozzáférés engedélyezése résznél ellenőrizd az alkalmazás nevét, majd válaszd a Hozzáférés engedélyezése lehetőséget. Ha nem ismered fel az alkalmazást, válaszd az Elutasítás lehetőséget.
A kliens kapcsolatban marad, így nem kell minden alkalommal bejelentkezned.
Mire képes a kliens?
A kliens látja a Dvina eszközeit, és használja őket, ha a kérésedhez szükség van rájuk:
| Terület | Mire képes a kliens |
|---|---|
| Keresés | Egyszerre kereshet a csevegéseidben, dokumentumaidban, memóriádban és világodban. |
| Memória | Listázhatja és elolvashatja a memóriafájljaidat, új fájlt adhat hozzá, vagy módosíthat egy meglévőt. |
| Világ | Listázhatja a témáidat, megmutathatja, mit tud Dvina egy témáról vagy bármi másról, és listázhatja a hírfolyamodat. |
| Dokumentumok | Listázhatja, olvashatja és keresheti a könyvtárad tartalmát, jegyzeteket és mappákat hozhat létre, fájlokat tölthet fel, valamint lecserélhet, áthelyezhet, átnevezhet vagy a kukába helyezhet egy dokumentumot. |
| Vászon | Listázhatja és elolvashatja a vásznaidat, vásznat hozhat létre, vagy átírhat egy oldalt. |
| Feladatok és célok | Listázhatja a feladataidat, és elolvashatja, mit végeztek el, elindíthat egy feladatot vagy egy cél elérésén dolgozó feladatot, további teendőket adhat egy feladatnak, vagy leállíthatja azt. |
| Ütemezett üzenetek | Listázhatja őket, egyszeri vagy ismétlődő üzenetet vagy emlékeztetőt ütemezhet, illetve törölheti az ütemezésüket. |
| Ügynökök és készségek | Listázhatja és elolvashatja az ügynökeidet és készségeidet, ügynököt hozhat létre, készséget adhat hozzá, vagy módosíthatja bármelyiket. |
| Projektek | Listázhatja a projektjeidet, és megmutathatja egy projekt mappáját és legutóbbi feladatait. |
| Megosztás | Megnézheti, ki fér hozzá egy elemhez, és mit osztottak meg veled mások, illetve hozzáférést adhat valakinek, vagy visszavonhatja azt. |
| Beállítások | Megmutathatja a beállításaidat, illetve be- vagy kikapcsolhatja a memóriát. |
A kliens nem törölhet semmit véglegesen, nem nyithat meg nyilvános hivatkozásokat, nem csatlakoztathat vagy választhat le alkalmazásokat, és nem módosíthatja az adminisztrációs vagy számlázási beállításokat.
Módosítások jóváhagyása
A kliens műveleteire ugyanazok a szabályok vonatkoznak, mint Dvina minden más részében:
- Az olvasáshoz nem kér megerősítést.
- Új elem, például jegyzet, memóriafájl vagy feladat hozzáadásához nem kér megerősítést. Ez soha nem módosítja a már meglévő tartalmat.
- Módosítás vagy eltávolítás előtt – például dokumentum kukába helyezése, vászonoldal átírása, feladat leállítása vagy elem megosztása esetén – előbb megerősítést kér tőled. A kliens megmutatja Dvina saját összefoglalóját a módosításról, te pedig jóváhagyhatod vagy elutasíthatod. Ha elutasítod, semmi sem változik.
Megjegyzés
Ha egy kliens nem tud megerősítést kérni tőled, Dvina nem hajtja végre az abból érkező módosítást. Végezd el a módosítást a Dvina alkalmazásban, vagy használj olyan klienst, amely tud megerősítést kérni.
A hozzáférésed és a vállalatod szabályai
A kliens a nevedben működik, és csak azt láthatja és teheti meg, amit te is a Dvina rendszerében:
- Csak addig működik, amíg a munkaterület tagja vagy, és csak a szerepköröd által engedélyezett műveleteket végezheti el.
- Ha az adminisztrátorod kikapcsol egy funkciót, például a fájlfeltöltést, azt a kliens sem használhatja.
- A kliens által hozzáadott vagy módosított tartalomra ugyanúgy érvényesek a vállalatod adatvédelmi szabályai, mint az alkalmazásban.
- A hozzáadásokat és módosításokat az auditnapló az asszisztens által a nevedben végzett műveletekként rögzíti, feltüntetve azt a klienst is, amelyből érkeztek.
- A kliens műveletei beleszámítanak a használatodba, a szokásos korlátaidon belül.
Csatlakozás API-kulccsal OAuth helyett
Az Enterprise csomagban a kliens bejelentkezés helyett személyes hozzáférési tokennel is csatlakozhat. Ezt olyan klienshez használd, amely nem tud OAuth-tal bejelentkezni, vagy egy szkripthez.
- Nyisd meg a Beállításokat, és válaszd az API-hozzáférés lehetőséget.
- A Személyes hozzáférési tokenek résznél válaszd a Token létrehozása lehetőséget.
- Adj meg egy Nevet, válaszd ki a Hozzáférést és a Lejárat időpontját, majd válaszd a Token létrehozása lehetőséget.
- A Token másolása résznél másold ki a tokent. Csak ekkor jelenik meg.
Válaszd ki a kliens számára szükséges hozzáférést:
- Csak olvasás: a kliens csak az olvasásra szolgáló eszközöket látja. Kereshet a Dvina-tartalmaidban, és elolvashatja őket, de nem adhat hozzá és nem módosíthat semmit.
- Olvasás és írás: a kliens minden eszközt lát, de a módosításokhoz továbbra is a jóváhagyásodat kéri, ugyanúgy, mint OAuth esetén.
Küldd el a tokent az Authorization fejlécben, a Bearer után. Például a Claude Code esetén:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
Más kliensben ugyanazt a fejlécet add meg ott, ahol az MCP-szerver fejléceit beállíthatod.
A token a nevedben működik azon a munkaterületen, ahol létrehoztad, az ottani aktuális szerepköröd jogosultságaival. A lecseréléséhez nyisd meg a Személyes hozzáférési tokenek alatt, és válaszd a Csere… lehetőséget: egy új token lép a helyébe, a régi pedig azonnal megszűnik működni. A letiltásához válaszd a Visszavonás… lehetőséget: minden, ami ezt a tokent használja, azonnal megszűnik működni.
A tokenekről további információt az API-hozzáférés oldalon találsz.