# Používejte Dvina z jiných aplikací pomocí MCP

> Připojte k Dvina klienta MCP, jako je Claude Code, ChatGPT nebo Cursor, přihlaste se a umožněte mu s vaším souhlasem číst obsah v Dvina a přidávat nový.

Dvina má vlastní MCP server. Připojte klienta MCP, jako je Claude Code, ChatGPT nebo Cursor. Tato aplikace pak může vaším jménem prohledávat Dvina, číst vaše dokumenty a paměť a přidávat poznámky, úkoly a připomínky.

## Než začnete

Budete potřebovat adresu serveru:

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

Pokud vaše firma provozuje Dvina na vlastních serverech, použijte firemní adresu API Dvina s `/mcp` na konci. Požádejte o ni správce.

Server používá Streamable HTTP. Pokud klient vyžaduje výběr transportu, zvolte HTTP.

## Připojení klienta

::: tabs

=== Claude Code

1. V terminálu spusťte:

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

2. Spusťte Claude Code, zadejte `/mcp`, vyberte **dvina** a přihlaste se do Dvina.

=== ChatGPT

1. Open the place where ChatGPT lets you add an MCP server.
2. Enter `https://api.dvina.ai/mcp` as the server's address, and choose OAuth if it asks how to sign in.
3. Sign in to Dvina when ChatGPT asks.

=== Cursor

1. V Cursor otevřete místo, kde můžete přidat MCP server.
2. Přidejte server s názvem `dvina` a adresou `https://api.dvina.ai/mcp`.
3. Až vás Cursor vyzve, přihlaste se do Dvina.

:::

Nepotřebujete ID klienta ani tajný klíč. Klient se při prvním připojení sám zaregistruje v Dvina.

## Přihlášení

MCP server Dvina vás přihlásí pomocí OAuth ve vašem prohlížeči:

1. Přihlaste se do Dvina jako obvykle.
2. Pokud patříte do více pracovních prostorů, vyberte jeden v části **Vyberte pracovní prostor** a pak zvolte **Pokračovat**. Klient bude pracovat pouze v tomto pracovním prostoru.
3. V části **Povolit přístup** zkontrolujte název aplikace a pak zvolte **Povolit přístup**. Pokud aplikaci nepoznáváte, zvolte **Zamítnout**.

Klient zůstane připojený, takže se nemusíte přihlašovat pokaždé.

## Co klient dokáže

Klient má k dispozici nástroje Dvina a používá je, když je to pro váš požadavek potřeba:

| Oblast                 | Co klient umí                                                                                                                                |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vyhledávání**        | Prohledávat vaše chaty, dokumenty, paměť a svět najednou.                                                                                      |
| **Paměť**              | Zobrazit seznam souborů paměti, číst je, přidat nový soubor nebo upravit stávající.                                                            |
| **Svět**               | Zobrazit seznam vašich témat, ukázat, co Dvina ví o určitém tématu nebo čemkoli jiném, a zobrazit položky ve vašem kanálu Feed.                 |
| **Dokumenty**          | Zobrazit seznam položek v Knihovně, číst je a prohledávat, vytvářet poznámky a složky, nahrávat soubory a nahrazovat, přesouvat či přejmenovávat dokumenty nebo je přesouvat do koše. |
| **Plátno**             | Zobrazit seznam vašich pláten, číst je, vytvořit plátno nebo přepsat stránku.                                                                  |
| **Úkoly a cíle**       | Zobrazit seznam vašich úkolů a přečíst si, co udělaly, spustit úkol nebo úkol směřující k cíli, zadat úkolu další práci nebo ho zastavit.        |
| **Naplánované zprávy** | Zobrazit jejich seznam, naplánovat jednorázovou nebo opakovanou zprávu či připomínku nebo ji zrušit.                                           |
| **Agenti a dovednosti** | Zobrazit seznam vašich agentů a dovedností, číst je, vytvořit agenta, přidat dovednost nebo upravit agenta či dovednost.                       |
| **Projekty**           | Zobrazit seznam vašich projektů a ukázat složku projektu a jeho nedávné úkoly.                                                                |
| **Sdílení**            | Zjistit, kdo má k položce přístup a co s vámi sdíleli ostatní, nebo někomu přístup udělit či odebrat.                                           |
| **Nastavení**          | Zobrazit vaše předvolby nebo zapnout či vypnout paměť.                                                                                       |

Klient nemůže nic trvale smazat, otevírat veřejné odkazy, připojovat ani odpojovat aplikace ani měnit nastavení správy nebo fakturace.

## Schvalování změn

Pro činnost klienta platí stejná pravidla jako všude v Dvina:

- Čtení probíhá bez dotazu.
- Přidávání nových položek, například poznámky, souboru paměti nebo úkolu, probíhá bez dotazu. Nikdy nemění to, co už existuje.
- Změna nebo odstranění položky, například přesunutí dokumentu do koše, přepsání stránky plátna, zastavení úkolu nebo sdílení položky, nejprve vyžaduje váš souhlas. Klient zobrazí shrnutí změny přímo od Dvina a vy ji schválíte nebo odmítnete. Když ji odmítnete, nic se nezmění.

> [!NOTE]
> Pokud vás klient nemůže požádat o potvrzení, Dvina změnu z tohoto klienta neprovede. Proveďte ji přímo v aplikaci Dvina nebo použijte klienta, který vás o potvrzení požádat může.

## Váš přístup a pravidla vaší firmy

Klient jedná vaším jménem a má přístup jen k tomu, co v Dvina můžete vidět a dělat vy:

- Funguje jen po dobu, kdy jste členem pracovního prostoru, a pouze v rozsahu, který dovoluje vaše role.
- Pokud správce vypne některou funkci, například nahrávání souborů, nemůže ji používat ani klient.
- Na vše, co klient přidá nebo změní, se vztahují pravidla ochrany dat vaší firmy, stejně jako v aplikaci.
- Vše, co přidá nebo změní, se zaznamená do vašeho [protokolu auditu](/docs/teams/audit-log) jako akce asistenta provedená vaším jménem, s uvedením klienta, ze kterého pochází.
- Jeho činnost se započítává do vašeho využití a podléhá vašim obvyklým limitům.

## Připojení pomocí klíče API místo OAuth

V tarifu Enterprise se klient může místo přihlášení připojit pomocí osobního přístupového tokenu. Tuto možnost použijte pro klienta, který se nemůže přihlásit přes OAuth, nebo pro skript.

1. Otevřete Nastavení a vyberte **Přístup k API**.
2. V části **Osobní přístupové tokeny** vyberte **Vytvořit token**.
3. Zadejte **Název**, zvolte **Přístup** a datum **Vypršení platnosti** a pak vyberte **Vytvořit token**.
4. V části **Zkopírujte si token** token zkopírujte. Zobrazí se pouze tentokrát.

Zvolte přístup, který klient potřebuje:

- **Pouze čtení:** klient vidí pouze nástroje pro čtení. Může v Dvina vyhledávat a číst, ale nemůže nic přidávat ani měnit.
- **Čtení a zápis:** klient vidí všechny nástroje a změny stále vyžadují vaše schválení, stejně jako při použití OAuth.

Token odešlete v hlavičce `Authorization` za `Bearer`. Například v Claude Code:

```sh
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
```

V jiném klientovi přidejte stejnou hlavičku tam, kde umožňuje nastavit hlavičky pro server MCP.

Token jedná vaším jménem v pracovním prostoru, ve kterém jste ho vytvořili, s vaší aktuální rolí v tomto prostoru. Pokud ho chcete nahradit, otevřete ho v části **Osobní přístupové tokeny** a vyberte **Obměnit…**: nahradí ho nový token a starý okamžitě přestane fungovat. Pokud ho chcete zneplatnit, vyberte **Zneplatnit…**: vše, co ho používá, okamžitě přestane fungovat.

Další informace o tokenech najdete v článku [Přístup k API](/docs/dvina-mcp/api-access).

## Související

- [Vlastní aplikace a servery MCP](/docs/connectors/custom-apps)
- [Přístup k API](/docs/dvina-mcp/api-access)
- [Používání příkazu dvina](/docs/dvina-mcp/cli)
- [Přehled týmů](/docs/teams/overview)