MCP server

MCP (Model Context Protocol) je standardní rozhraní, přes které se k datům a akcím aplikace připojují AI klienti, například Claude nebo ChatGPT, jako sadu nástrojů. TAS vlastní MCP server vystavuje na adrese vaší instalace a AI klient přes něj může zakládat případy, dohledávat je, upravovat proměnné úkolu nebo číst firemní dokumentaci – vždy v rozsahu práv uživatele, který se k serveru připojil. Kapitola je určená administrátorům, kteří přístup AI klientům povolují, a integrátorům, kteří klienta připojují.

Adresa a scénáře

MCP server naslouchá na https://vase-tas.cz/mcp, volitelně s názvem scénáře v cestě:

https://vase-tas.cz/mcp/case-creation

Scénář zúží nabízenou sadu nástrojů na to, co má daný AI klient dělat. Bez scénáře (/mcp) AI klient uvidí všechny nástroje, které má uživatel právo používat.

ScénářK čemu slouží
case-creationZaložení nového případu: najít spustitelné šablony/hlavičky, zjistit potřebné proměnné, ověřit vstup a případ založit. Navíc nástroje pro vyhledávání ve firemních AI dokumentech.
case-editingÚprava rozpracovaného případu: dohledání případu, spuštění ručních událostí případu, úprava proměnných běžícího úkolu.
case-lookupJen dohledání a přehled případů uživatele přes jeho přehledy (Custom Views).
knowledgeVyhledávání ve firemních AI dokumentech a v dokumentaci TAS (HelpDocs).
accountRole přihlášeného uživatele a jeho dřívější konverzace s AI.
administrationPřehled nainstalovaných pluginů. Jen pro administrátora.
(bez scénáře)Všechny výše uvedené nástroje a navíc nástroje pro práci s právě otevřeným případem (přehled, dokumenty, proměnné, úkoly, historie, události).

TAS komunikuje protokolem MCP přes HTTP (JSON-RPC v těle POST požadavku), bez udržování stavu na straně serveru a bez streamování přes SSE – metody GET a DELETE na stejné adrese vrací „Method not allowed“.

Ověření a připojení AI klienta

MCP server přijímá jen token API nebo OAuth, ne běžnou přihlašovací relaci prohlížeče. Pro AI klienta, ke kterému přistupuje konkrétní uživatel (typický případ), použijte OAuth s autorizačním kódem – postup je stejný jako pro libovolnou veřejnou OAuth aplikaci:

  1. Administrátor s rolí $ApiTokenAdmin vytvoří v Přístup k API veřejného OAuth klienta a zadá Redirect URI, kterou vyžaduje AI klient (viz článek API tokeny a OAuth klienti v praxi).
  2. Do AI klienta zadáte adresu MCP serveru (https://vase-tas.cz/mcp, případně se scénářem) a Client ID.
  3. Klient přesměruje uživatele na /oauth/authorize; TAS zobrazí obrazovku Autorizace aplikace se jménem aplikace a adresou přesměrování, uživatel přístup schválí nebo odmítne.
  4. Klient si kód vymění za přístupový token na /oauth/token a od té chvíle volá MCP s hlavičkou Authorization: Bearer <token>.

Pro integraci bez účasti uživatele (např. firemní automatizaci, která běží jako jeden systémový účet) lze místo toho použít API token nebo důvěrného OAuth klienta – oba druhy tokenů MCP server přijímá stejně.

Práva podle připojeného uživatele
AI klient vidí a smí jen to, co smí uživatel (nebo systémový uživatel), kterého token zastupuje. Nástroje označené jako zápis (založení případu, úprava proměnných, spuštění události) mohou v AI klientovi vyžadovat ještě jeho vlastní potvrzení před provedením.

Dostupné nástroje

NástrojeCo dělají
Založení případu (case-creation)Najdou šablony a hlavičky, které uživatel smí spustit, vrátí potřebné proměnné jako schéma, ověří vyplněná data a případ založí.
Dokumenty a znalosti (AiDocumentsTools, HelpDocsTools)Vyhledají ve firemních AI dokumentech organizace (nejdřív podle klíčových slov, pak celý dokument) a v dokumentaci TAS.
Dohledání případu (case-lookup, case-editing)Projdou přehledy (Custom Views), které má uživatel k dispozici, a najdou v nich konkrétní případ.
Úprava případu (case-editing)Zjistí dostupné ruční události případu a spustí vybranou, zjistí proměnné rozpracovaného úkolu jako schéma, ověří a uloží jejich novou hodnotu.
Role a konverzace (account)Vrátí role přihlášeného uživatele a jeho dřívější konverzace s AI asistentem.
Pluginy (administration)Jen pro administrátora: přehled nainstalovaných pluginů a jejich vlastností.
Otevřený případ (bez scénáře)Přehled, dokumenty, proměnné, aktivní úkoly, historie a ruční události právě otevřeného případu.

U každé skupiny nástrojů je nejdřív nástroj, který AI klientovi vysvětlí, jak dál hledat nebo filtrovat (např. jaké sloupce má přehled), a teprve pak nástroj, který data skutečně vrátí nebo zapíše – AI klient si tak nejdřív ověří kontext, než provede akci.

Kde zjistit, co AI smí
Konkrétní seznam rolí a práv, která AI klient zdědí, nastavujete u uživatele nebo systémového uživatele stejně jako u běžného přihlášení – v Uživatelích a Rolích. MCP server žádná vlastní práva nepřidává ani neubírá.

Související: Přístup k API, API tokeny a OAuth klienti v praxi, Autentizace.

How to Activate the AI Feature

MCP server
Team assistant (opens in a new tab)

Powered by HelpDocs (opens in a new tab)