MCP (Model Context Protocol) je otevřený standard, kterým se AI asistent připojuje k aplikaci. mPohoda přes něj nabízí hotovou sadu nástrojů pro vyhledávání, sestavy a přípravu záznamů, takže asistent pracuje přímo s daty firmy a nemusíte mu nic kopírovat ručně. 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.
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 .
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.
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.
| Oblast | Co lze hledat | Příklady parametrů |
|---|---|---|
| Doklady | Vydané a přijaté faktury a zálohové faktury, nabídky, objednávky, výdejky a ostatní závazky podle typu, čísla, partnera a období. | typ dokladu, text, datum od/do, datum změny, obchodní partner |
| Stav úhrad | Neuhrazené vydané faktury a zálohové faktury, příchozí a odchozí bankovní pohyby. | typ dokladu, období, obchodní partner |
| 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 |
| Číselníky | Hotovostní pokladny, střediska, činnosti, provozovny, formy úhrady, prodejní ceny a kódy bank. | text, stránkování |
Vyhledávání probíhá na straně databáze a vrací jen záznamy dostupné pro aktuální API přístup.
Na běžné finanční otázky nemusí asistent procházet jednotlivé doklady — má k dispozici hotové sestavy, kde filtrování, rozdělení do skupin a výpočty jsou prováděny přímo na serveru.
| Sestava | K čemu slouží |
|---|---|
| Neuhrazené vydané faktury | Seznam otevřených pohledávek s celkovou, uhrazenou a zbývající částkou v měně dokladu i v přepočtu na domácí měnu. Celkový součet sestava uvádí jen v domácí měně. |
| Přehled dlužníků | Odběratelé seřazení podle výše neuhrazených pohledávek, volitelně jen po splatnosti. |
| Pohledávky podle stáří | Rozdělení neuhrazených pohledávek do pásem po splatnosti, ve výchozím nastavení 30, 60 a 90 dní. |
| Faktury splatné v období | Vydané i přijaté faktury splatné ve zvoleném období, se souhrnem příjmů, výdajů a rozdílu. |
| Tržby podle odběratelů | Odběratelé s nejvyššími tržbami za zvolené období. |
| Tržby podle středisek | Tržby rozdělené na střediska (lze počítat podle data uskutečnění plnění, nebo podle data vystavení). |
| Vývoj tržeb | Tržby po měsících pro porovnání období. |
| Přehled DPH | Základy a částky daně po sazbách za zvolené období. |
| Dostupnost zásob | Množství skladem u hledané zásoby (pokud odpovídá více položek, asistent se doptá na upřesnění). |
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í.
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 (lze 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á.
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í.
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 citlivé ú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.
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), data, která si vyžádáte nebo odešlete, procházejí 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ě 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ě.
Nejjednodušší způsob, jak AI asistenta k mPohodě připojit. Stáhnete jeden soubor, přetáhnete ho do aplikace Claude Desktop a vložíte API klíč. Nic dalšího neinstalujete a žádné konfigurační soubory neupravujete.
Stáhnout propojení s Claude Desktop
Vytvořte API klíč. V mPohodě vyberte firmu, kterou chcete připojit, v nabídce firmy otevřete API a v části Přístup pomocí API klíče vytvořte tlačítkem Nový klíč nový klíč. Zkopírujte si ho.
Stáhněte soubor. Klikněte na odkaz výše. Do složky se staženými soubory se uloží soubor s příponou .mcpb.
Přetáhněte soubor do Claude Desktop. V aplikaci Claude Desktop otevřete Settings → Extensions a stažený soubor do tohoto okna přetáhněte myší.
Vložte API klíč. Claude Desktop zobrazí okno s polem API klíč. Vložte do něj zkopírovaný klíč a potvrďte tlačítkem Install.
Vyzkoušejte to. Otevřete novou konverzaci a napište například „Zobraz moje neuhrazené vydané faktury“. Pokud se Claude zeptá, zda smí použít nástroje mPohody, povolte to.
Přetažení nefunguje? V Claude Desktop zvolte Settings → Extensions → Advanced settings → Install Extension… a stažený soubor vyberte.
Claude Desktop zatím nemáte? Aplikaci pro Windows i macOS stáhnete na claude.ai/download.
Soubor neobsahuje žádné přihlašovací údaje. API klíč zadáváte až v Claude Desktop, který ho uloží do zabezpečeného úložiště vašeho počítače. Použijte klíč ze stejné mPohody, ze které jste soubor stáhli (například pro beta verzi klíč z beta mPohody). Chcete-li připojit jinou firmu, vytvořte klíč v ní a v Claude Desktop ho změňte v Settings → Extensions u propojení s mPohodou.
Balíček .mcpb je určený pro Claude Desktop. V jiných aplikacích, například VS Code nebo Cursor, nastavte vlastní MCP připojení s hlavičkou Api-Key. ChatGPT u vlastních MCP připojení aktuálně nabízí OAuth nebo přístup bez přihlášení; přihlášení API klíčem mPohody tímto způsobem nenastavíte. Podrobnosti najdete v dokumentaci ChatGPT.
Pro připojení AI asistenta je potřeba znát URL MCP serveru a přihlašovací údaj z agendy 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é.
| Způsob přihlášení | Hlavička | Kde údaj získáte |
|---|---|---|
| API klíč (doporučeno) | Api-Key: váš API klíč | Nabídka firmy → API → Přístup pomocí API klíče → Nový klíč |
| OAuth klientské údaje | Authorization: Basic a dvojice Client ID a Client Secret zakódovaná do Base64 | Nabídka firmy → API → Přístup pomocí přístupového tokenu |
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ě API.