# A Dvina használata más alkalmazásokból MCP-vel

> Csatlakoztass egy MCP-klienst, például a Claude Code, a ChatGPT vagy a Cursor alkalmazást a Dvina rendszeréhez, jelentkezz be, és engedélyezd, hogy a jóváhagyásoddal adatokat olvasson és adjon hozzá.

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:

```text
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

::: tabs

=== Claude Code

1. Futtasd a terminálban:

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

2. Indítsd el a Claude Code alkalmazást, futtasd a `/mcp` parancsot, válaszd a **dvina** lehetőséget, majd jelentkezz be a Dvina rendszerébe.

=== ChatGPT

1. Nyisd meg a ChatGPT felületén az MCP-szerver hozzáadására szolgáló részt.
2. Add meg a `https://api.dvina.ai/mcp` cí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.
3. Jelentkezz be a Dvina rendszerébe, amikor a ChatGPT erre kér.

=== Cursor

1. Open the place where Cursor lets you add an MCP server.
2. Add a server named `dvina` with the address `https://api.dvina.ai/mcp`.
3. 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:

1. Jelentkezz be a Dvina rendszerébe a megszokott módon.
2. 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.
3. 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.

> [!NOTE]
> 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ó](/docs/teams/audit-log) 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.

1. Nyisd meg a Beállításokat, és válaszd az **API-hozzáférés** lehetőséget.
2. A **Személyes hozzáférési tokenek** résznél válaszd a **Token létrehozása** lehetőséget.
3. 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.
4. 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:

```sh
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](/docs/dvina-mcp/api-access) oldalon találsz.

## Kapcsolódó témák

- [Egyéni alkalmazások és MCP-szerverek](/docs/connectors/custom-apps)
- [API-hozzáférés](/docs/dvina-mcp/api-access)
- [A dvina parancs használata](/docs/dvina-mcp/cli)
- [A csapatok áttekintése](/docs/teams/overview)
