AI agent přes MCP

MCP umožní připojit k mPohodě AI asistenta, který umí pracovat s daty firmy přes stejné Open API oprávnění jako běžná integrace. Stránka popisuje, co může agent dělat, jaké vyhledávání má k dispozici a jak s ním bezpečně zadávat požadavky.

MCP je určené pro práci přes AI asistenta. Pro klasickou integraci systém-systém použijte REST dokumentaci Open API.

1. Co agent umí

Připojený agent může pomáhat s vyhledáním dat, přípravou nových záznamů a kontrolou výsledků. Typicky může:

vyhledat doklady, obchodní partnery, bankovní účty a položky ceníku,
zobrazit detail nalezeného záznamu a použít ho jako podklad pro další krok,
vytvořit podporované doklady a obchodní partnery,
získat PDF nebo ISDOC u dokladů, u kterých je export podporovaný,
vrátit validační chyby z mPohody tak, aby je šlo opravit v dalším pokusu.

2. Možnosti vyhledávání

Vyhledávání je vhodné používat před vytvořením dokladu, pokud agent potřebuje najít odběratele, položku ceníku, bankovní účet nebo existující doklad.

Oblast	Co lze hledat	Příklady parametrů
Doklady	Vydané a přijaté doklady podle typu, čísla, partnera a období.	typ dokladu, text, datum od/do, datum změny, partner, stav smazání
Obchodní partneři	Firmy a osoby z adresáře.	název, IČ, DIČ, e-mail, telefon
Bankovní účty	Účty firmy používané na dokladech a platbách.	číslo účtu, kód banky, IBAN, SWIFT, aktivní účty
Ceník	Položky ceníku pro vložení na doklady.	název, kód, EAN, PLU, prodejní položky

Vyhledávání probíhá na straně databáze a vrací jen záznamy dostupné pro aktuální API přístup.

3. Vytváření dokladů

Agent může připravit a odeslat vytvoření podporovaných záznamů podle nástrojů dostupných v MCP serveru. Při tvorbě dokladu je vhodné nejdříve dohledat potřebné vazby, například odběratele, položky ceníku, formu úhrady nebo bankovní účet.

Vydané doklady: například vydaná faktura, zálohová faktura, nabídka, přijatá objednávka a výdejka.
Nákupní doklady: například přijatá faktura a vydaná objednávka, pokud jsou dostupné v Open API.
Adresář a číselníky: například obchodní partner nebo další podpůrné záznamy podle aktuálně dostupných nástrojů.
Úhrady a exporty: u vybraných dokladů lze dohledat detail, stáhnout PDF/ISDOC nebo pracovat s úhradami.

Pokud Open API daný typ záznamu nepodporuje, agent ho přes MCP nevytvoří. V takovém případě má odpovědět, že akce není dostupná.

4. Příklady zadání

Najdi vydané faktury pro firmu Novák s.r.o. za poslední měsíc a ukaž neuhrazené.
Najdi obchodního partnera podle IČ a připrav vydanou fakturu na dvě položky z ceníku.
Vyhledej bankovní účet s IBAN CZ... a zkontroluj, jestli je aktivní.
Stáhni PDF poslední vydané faktury pro odběratele ABC.
Vytvoř přijatou fakturu podle těchto údajů a vrať mi validační chyby, pokud něco chybí.

5. Bezpečnost a oprávnění

MCP používá stejné autentizační údaje a stejný firemní kontext jako Open API. Agent nemá obcházet práva uživatele ani firmy.

API klíč nebo přístupový token je tajný údaj a patří pouze důvěryhodnému klientovi.
Agent pracuje jen s daty firmy, ke které má daný API přístup oprávnění.
Smazané nebo nepřístupné záznamy se nemají ve vyhledávání zobrazovat.
Práva k dokladům se vyhodnocují stejně jako u běžného Open API přístupu.

6. Nastavení připojení

Pro připojení AI asistenta je potřeba znát URL MCP serveru a použít API klíč nebo přístupový token z agendy Open API.

Zobrazit technické nastavení MCP serveru.

API klíč nevkládejte do veřejných promptů, sdílených dokumentů ani do logů. Pokud existuje podezření na únik, klíč smažte a vytvořte nový.

Zpět na začátek

Stáhněte si program TeamViewer a spojte se s námi přímo.