MCP Konektor | DocuAssist.sk

MCP konektor DocuAssist vám umožňuje prepojiť vaše znalostné bázy priamo s AI klientmi, ktorí podporujú protokol Model Context Protocol (MCP) — ako sú Claude a ChatGPT. Po prepojení môže AI vo vašom mene prehľadávať a klásť otázky naprieč všetkými vašimi znalostnými bázami.

Čo je MCP?

Model Context Protocol je otvorený štandard, ktorý umožňuje AI aplikáciám bezpečne sa pripojiť k externým nástrojom a dátam. DocuAssist sprístupňuje vaše znalostné bázy ako MCP server, takže ľubovoľný kompatibilný AI klient dokáže získať odpovede podložené vašimi dokumentmi.

Požiadavky

Predplatné programu Premium alebo Team.
Aspoň jedna znalostná báza s indexovanými dokumentmi.
Klient s podporou MCP (napr. Claude Desktop, Claude na webe, ChatGPT).

URL konektora

https://www.docuassist.sk/mcp

Pripojiť sa dá dvoma spôsobmi. Prihlásenie cez váš účet (OAuth) odporúčame pre Claude na webe a mobile; statický kľúč je vhodný pre nastavenie cez konfiguračný súbor.

Možnosť A — Prihlásenie cez váš účet (OAuth)

Najvhodnejšie pre Claude na webe/mobile a pre postup „Add connector“ v Claude Desktop. Nie je potrebné kopírovať žiadne kľúče — stačí sa prihlásiť.

Vo vašom AI klientovi zvoľte Pridať vlastný konektor (alebo podobne).
Zadajte URL konektora https://www.docuassist.sk/mcp.
Kliknite na Pripojiť. V prehliadači sa otvorí prihlasovacia stránka DocuAssist.
Prihláste sa svojím existujúcim účtom DocuAssist a na obrazovke súhlasu schváľte požiadavku na prístup.
Hotovo — klient teraz môže používať vaše znalostné bázy.

Prístup môžete kedykoľvek zrušiť vo svojom účte DocuAssist.

Možnosť B — Statický MCP kľúč (konfiguračný súbor)

Najvhodnejšie pre Claude Desktop nastavený cez JSON súbor, skripty alebo CI.

Krok 1: Vytvorenie MCP kľúča

Na ovládacom paneli prejdite do sekcie API kľúče (v bočnom paneli pod vaším účtom).
Kliknite na Vytvoriť MCP kľúč.
Pomenujte ho (napr. „Claude Desktop“).
Kliknite na Vytvoriť a okamžite si skopírujte kľúč — zobrazí sa iba raz.

Na rozdiel od widget kľúča nie je MCP kľúč viazaný na jednu konkrétnu znalostnú bázu — udeľuje prístup ku každej znalostnej báze, ku ktorej má váš účet prístup.

Krok 2: Pridanie do konfigurácie klienta

{
  "mcpServers": {
    "docuassist": {
      "type": "http",
      "url": "https://www.docuassist.sk/mcp",
      "headers": {
        "Authorization": "Bearer dk_vas_cely_kluc"
      }
    }
  }
}

Dostupné nástroje

Po prepojení môže AI používať tieto nástroje:

list_knowledge_bases — vypíše každú znalostnú bázu, ktorú môžete prehľadávať (id, názov, popis). AI ho zvyčajne volá ako prvý.
search_knowledge_base — hybridné (sémantické + kľúčové slová) vyhľadávanie v znalostnej báze; vráti najrelevantnejšie úryvky dokumentov, aby nad nimi AI mohla uvažovať sama.
ask_knowledge_base — položí otázku v prirodzenom jazyku a vráti kompletne zostavenú odpoveď z vlastného RAG systému DocuAssist vrátane zdrojov.
list_documents — vypíše každý dokument v znalostnej báze (id, názov súboru, stav, veľkosť, typ), aby si AI mohla vybrať konkrétny dokument.
get_document — vráti celý text jedného dokumentu (nielen úryvky z vyhľadávania) na prečítanie celej zmluvy alebo správy doslovne.
get_kb_summary — vráti vopred pripravený prehľad AI Wiki k znalostnej báze, aby sa AI zorientovala pred vyhľadávaním.
compare_documents — vráti celý text dvoch dokumentov vedľa seba, aby ich AI mohla porovnať (rozdiely, rozpory, zmeny medzi verziami).
answer_with_citations — vyhľadávanie, ktoré ku každému úryvku vráti explicitný odkaz na zdroj (názov súboru + id dokumentu), aby bolo možné odpovede citovať.
anonymize_text — odstráni osobné údaje (e-maily, telefónne čísla, IBAN/bankové účty, rodné čísla, mená, adresy) z ľubovoľného textu, ktorý mu zadáte (do 20 000 znakov), a nahradí ich zástupnými symbolmi. Funguje na akomkoľvek texte, nielen na obsahu znalostnej bázy. Ak sa maskovanie mien/adries nedá plne vykonať, aj tak odstráni údaje rozpoznateľné podľa vzoru a vráti upozornenie, aby ste text pred zdieľaním skontrolovali.
list_reference_examples — vypíše dokumenty, ktoré ste v znalostnej báze označili ako vzory (id, názov súboru). Používa sa spolu s promptom generate_document nižšie.

Generovanie dokumentov

Konektor ponúka aj prompt s názvom generate_document (prompty sa v klientoch, ktoré ich podporujú — napr. Claude — zobrazujú oddelene od nástrojov). Vytvorí nový dokument — zmluvu, správu, list, ponuku a pod. — ktorý napodobní štýl vašich existujúcich dokumentov namiesto rigidnej šablóny:

Označte jeden alebo viac svojich existujúcich, už hotových dokumentov ako vzor — v dashboarde otvorte znalostnú bázu a pri dokumente kliknite na tlačidlo ⭐ Použiť ako vzor. Netreba písať ani udržiavať žiadne šablóny.
Vo vašom AI klientovi spustite prompt generate_document (voliteľne zadajte znalostnú bázu, vzorový dokument a inštrukcie).
AI načíta vzor, naštuduje jeho štruktúru/tón/formát, vytiahne potrebné fakty z vašej znalostnej bázy a vytvorí nový dokument v rovnakom štýle — s uvedenými zdrojmi.

Tvorbu robí váš AI klient, takže nespotrebúva vlastnú AI kvótu DocuAssist. Každý draft je len východiskový bod, ktorý vyžaduje ľudskú kontrolu — nie je to finálny ani právne záväzný dokument.

Bezpečnosť a limity

Konektor z vašich znalostných báz iba číta; nemôže dokumenty upravovať ani mazať.
Pri OAuth AI koná vo vašom mene a dostane sa len k znalostným bázam, ku ktorým má váš účet prístup.
Statický MCP kľúč udržiavajte v tajnosti — udeľuje prístup na čítanie vašich znalostných báz. Ak unikne, zrušte ho v sekcii API kľúče a vytvorte nový.
Požiadavky sú obmedzené rýchlostným limitom. Ak limit dosiahnete, počkajte minútu a skúste to znova.
Jazyk odpovede sa automaticky riadi jazykom vašej otázky — nie je potrebné žiadne viacjazyčné nastavenie.

Zrušenie prístupu

Statický kľúč: prejdite do sekcie API kľúče, nájdite svoj MCP kľúč (označený odznakom MCP) a kliknite na ikonu koša. Kľúč okamžite prestane fungovať.
OAuth: zrušte prepojenú aplikáciu v nastaveniach svojho účtu DocuAssist.