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:
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
Claude Code
V terminálu spusťte:
claude mcp add --transport http dvina https://api.dvina.ai/mcpSpusťte Claude Code, zadejte
/mcp, vyberte dvina a přihlaste se do Dvina.
ChatGPT
- Open the place where ChatGPT lets you add an MCP server.
- Enter
https://api.dvina.ai/mcpas the server's address, and choose OAuth if it asks how to sign in. - Sign in to Dvina when ChatGPT asks.
Cursor
- V Cursor otevřete místo, kde můžete přidat MCP server.
- Přidejte server s názvem
dvinaa adresouhttps://api.dvina.ai/mcp. - 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:
- Přihlaste se do Dvina jako obvykle.
- 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.
- 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í.
Poznámka
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 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.
- Otevřete Nastavení a vyberte Přístup k API.
- V části Osobní přístupové tokeny vyberte Vytvořit token.
- Zadejte Název, zvolte Přístup a datum Vypršení platnosti a pak vyberte Vytvořit token.
- 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:
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.