AI asistent přes MCP

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

Připojení přes MCP je dostupné pouze ve variantě mPohoda Pro .

1. Co AI asistent umí

Připojený AI asistent 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, položky ceníku a další číselníky,

• zobrazit detail nalezeného záznamu a použít ho jako podklad pro další krok,

• sestavit přehled pohledávek, tržeb nebo DPH; výpočet probíhá na serveru, asistent si doklady nestahuje a nesčítá sám,

• připravit podporované doklady a obchodní partnery a po výslovném potvrzení je vytvořit,

• 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 asistent potřebuje najít odběratele, položku ceníku, bankovní účet nebo existující doklad.

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

3. Sestavy a přehledy

Na běžné finanční otázky nemusí asistent procházet jednotlivé doklady — má k dispozici hotové sestavy, které filtrování, součty a rozdělení do skupin počítají přímo na serveru. Odpověď je proto rychlejší a čísla odpovídají tomu, co uvidíte v mPohodě.

Sestavy nad pohledávkami pracují s datem splatnosti, sestavy nad DPH s datem uskutečnění zdanitelného plnění. Pokud potřebujete jiné hledisko, uveďte ho v zadání.

4. Vytváření záznamů

AI asistent vždy nejprve připraví návrh podporovaného záznamu. Samotné odeslání je možné až po výslovném potvrzení přesného návrhu uživatelem. Při přípravě dokladu je vhodné nejdříve dohledat potřebné vazby, například odběratele, položky ceníku, formu úhrady nebo bankovní účet.

• Prodejní 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: editace nebo založení obchodního partnera nebo dalších podpůrných záznamů podle aktuálně dostupných nástrojů Open API.

• Úhrady: uhrazení faktury bez vazby, nebo úhrada jednoho i více dokladů bankovním pohybem.

• Návazné doklady: převod objednávky nebo nabídky na navazující doklad, přenos výdejky do vydané faktury — i hromadně, několik výdejek do jedné faktury — a odpočet zálohové faktury.

• Exporty: u vybraných dokladů lze dohledat detail a stáhnout PDF nebo ISDOC.

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

5. Příklady zadání

• Vyhledej všechny neuhrazené vydané faktury společnosti Novák s.r.o. za minulý měsíc.

• Vyhledej obchodního partnera podle IČ 12345678 a vystav na něj fakturu se dvěma ceníkovými položkami Z100 a Z120.

• Je aktivní bankovní účet 1234567890/0100 a jakou má nastavenou měnu?

• Stáhni PDF poslední vydané faktury pro odběratele ABC.

• Vytvoř přijatou fakturu podle tohoto PDF a případně vypiš, jestli je potřeba něco doplnit.

• Kdo mi nejvíc dluží a jak dlouho jsou faktury po splatnosti?

• Které faktury mi jsou splatné tento týden a kolik celkem za ně dodavatelům zaplatím?

• Ukaž tržby po střediscích za druhé čtvrtletí podle data uskutečnění plnění.

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

MCP používá stejné autentizační údaje a stejný firemní kontext jako Open API. AI asistent nemůže obcházet přístupová práva, disponuje výhradně identickými oprávněními jako uživatel, který mu vygeneroval API přístup.

• API klíč nebo OAuth klientské údaje (Client ID a Client Secret) jsou tajné údaje a patří pouze důvěryhodnému klientovi.

• AI asistent pracuje jen s daty firmy, ke které má daný API přístup oprávnění.

• Smazané nebo nepřístupné záznamy se ve vyhledávání nezobrazují.

• Práva k dokladům a skladům se vyhodnocují stejně jako u běžného Open API přístupu.

Kam putují vaše data

MCP server zpřístupňuje pouze rozhraní — sadu nástrojů pro připojení AI. Kterou konkrétní aplikaci nebo AI službu k mPohodě připojíte, volíte vy. Použijete-li cloudovou AI službu (například Claude, Gemini nebo ChatGPT), procházejí data, která si vyžádáte nebo odešlete, také přes tuto zvolenou AI službu a její servery — mimo mPohodu i mimo STORMWARE. Může jít i o osobní nebo citlivé firemní údaje obsažené v nalezených záznamech.

Připojená AI má přístup ke všemu, co je dostupné přes Open API, a to v rozsahu oprávnění vašeho přístupu (API klíče nebo OAuth klienta). Rozsah omezíte právy daného přístupu. Přístup lze kdykoli odvolat smazáním API klíče nebo OAuth klienta v agendě Open API.

STORMWARE neurčuje, jakou AI službu si připojíte, kde běží ani jak nakládá s předanými daty. Za výběr AI služby, za zpracování dat na její straně a za smluvní podmínky s jejím poskytovatelem odpovídá uživatel. Používejte jen důvěryhodné AI služby, seznamte se s jejich podmínkami ochrany dat, a u citlivých dat zvažte AI provozovanou lokálně.

7. Nastavení připojení

Pro připojení AI asistenta je potřeba znát URL MCP serveru a přihlašovací údaj z agendy Open API. Adresu serveru, typ propojení, podporované hlavičky i hotovou ukázku konfigurace klienta najdete v technickém nastavení MCP serveru, na které vede odkaz níže. Přihlašovací údaj se posílá v hlavičce každého požadavku; kde se hlavičky nastavují, najdete v dokumentaci svého AI asistenta.

MCP připojení doporučujeme nastavovat z desktopových (lokálně nainstalovaných) MCP klientů. Webová rozhraní některých AI asistentů zatím připojení MCP serveru nepodporují nebo je nastavení komplikované.

Některé aplikace umožňují zadat jen token typu Bearer. V takovém případě vložte API klíč do hlavičky Authorization jako Bearer, server ho přijme. Pokud si můžete zvolit vlastní hlavičku, použijte Api-Key. Přístupový token vydaný pro Open API k přihlášení k MCP serveru nepoužijete — pro OAuth zadejte Client ID a Client Secret podle tabulky výše.

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ý.

Zobrazit technické nastavení MCP serveru.

Strojově čitelné GraphQL schéma je dostupné jako SDL soubor po přihlášení k Open API.

Požadavky AI asistenta přes MCP se počítají do stejného limitu požadavků Open API jako běžná REST volání. Základní počet je 8000 požadavků za měsíc pro variantu mPohoda Pro, v případě rozšíření mCAL dalších 8000 za každé mCAL. Náročnější zadání (vyhledávání, sestavy, příprava dokladů) může spotřebovat i více požadavků. Stav limitů najdete v hlavičce každé odpovědi z API a v agendě Open API.

Zpět na začátek

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