MCP (Model Context Protocol) je otvorený štandard, ktorým sa AI asistent pripája k aplikácii. mPohoda prostredníctvom neho ponúka hotovú sadu nástrojov na vyhľadávanie, zostavy a prípravu záznamov, takže asistent pracuje priamo s dátami firmy a nemusíte mu nič kopírovať ručne. MCP umožňuje pripojiť k mPohode AI asistenta, ktorý vie pracovať s dátami firmy s rovnakými oprávneniami Open API ako bežná integrácia.
MCP je určený na prácu prostredníctvom AI asistenta. Pre klasickú integráciu systém-systém použite REST dokumentáciu Open API.
Pripojenie cez MCP je dostupné len pre firmy s variantom mPohoda Pro .
Pripojený AI asistent môže pomáhať pri vyhľadávaní dát, príprave nových záznamov a kontrole výsledkov. Môže napríklad:
vyhľadať doklady, obchodných partnerov, bankové účty, položky cenníka a ďalšie číselníky,
zobraziť detail nájdeného záznamu a použiť ho ako podklad na ďalší krok,
zostaviť prehľad pohľadávok, tržieb alebo DPH (výpočet prebieha na serveri, asistent si doklady nesťahuje a nesčítava sám),
pripraviť podporované doklady a obchodných partnerov a po výslovnom potvrdení ich vytvoriť,
získať PDF alebo ISDOC pri dokladoch, pri ktorých je export podporovaný,
vrátiť validačné chyby z mPohody tak, aby ich bolo možné opraviť v ďalšom pokuse.
Vyhľadávanie je vhodné použiť pred vytvorením dokladu, ak asistent potrebuje nájsť odberateľa, položku cenníka, bankový účet alebo existujúci doklad.
| Oblasť | Čo možno hľadať | Príklady parametrov |
|---|---|---|
| Doklady | Vydané a prijaté faktúry a zálohové faktúry, ponuky, objednávky, výdajky a ostatné záväzky podľa typu, čísla, partnera a obdobia. | typ dokladu, text, dátum od/do, dátum zmeny, obchodný partner |
| Stav úhrad | Neuhradené vydané faktúry a zálohové faktúry, príchodzie a odchodzie bankové pohyby. | typ dokladu, obdobie, obchodný partner |
| Obchodní partneri | Firmy a osoby z adresára. | názov, IČO, DIČ, e-mail, telefón |
| Bankové účty | Účty firmy používané na dokladoch a platbách. | číslo účtu, kód banky, IBAN, SWIFT, aktívne účty |
| Cenník | Položky cenníka na vloženie do dokladov. | názov, kód, EAN, PLU, predajné položky |
| Číselníky | Hotovostné pokladnice, strediská, činnosti, prevádzky, formy úhrady, predajné ceny a kódy bánk. | text, stránkovanie |
Vyhľadávanie prebieha na strane databázy a vracia len záznamy dostupné pre aktuálny API prístup.
Na bežné finančné otázky nemusí asistent prechádzať jednotlivé doklady — má k dispozícii hotové zostavy, v ktorých sa filtrovanie, rozdelenie do skupín a súčty počítajú priamo na serveri. Odpoveď je preto rýchlejšia a čísla zodpovedajú tomu, čo uvidíte v mPohode.
| Zostava | Na čo slúži |
|---|---|
| Neuhradené vydané faktúry | Zoznam otvorených pohľadávok s celkovou, zaplatenou a zostávajúcou sumou v mene dokumentu a prepočítanou na domácu menu. Celková suma je uvedená iba v domácej mene. |
| Prehľad dlžníkov | Odberatelia zoradení podľa výšky neuhradených pohľadávok, voliteľne len po splatnosti. |
| Pohľadávky podľa veku | Rozdelenie neuhradených pohľadávok do pásiem po splatnosti, vo východiskovom nastavení 30, 60 a 90 dní. |
| Faktúry splatné v období | Vydané aj prijaté faktúry splatné vo zvolenom období, so súhrnom príjmov, výdavkov a rozdielu. |
| Tržby podľa odberateľov | Odberatelia s najvyššími tržbami za zvolené obdobie. |
| Tržby podľa stredísk | Tržby rozdelené na strediská; možno počítať podľa dátumu uskutočnenia plnenia alebo podľa dátumu vystavenia. |
| Vývoj tržieb | Tržby po mesiacoch pre porovnanie období. |
| Prehľad DPH | Základy a sumy dane podľa sadzieb za zvolené obdobie. |
| Dostupnosť zásob | Množstvo na sklade pri hľadanej zásobe (ak zodpovedá viac položiek, asistent sa dopýta na spresnenie). |
Zostavy nad pohľadávkami pracujú s dátumom splatnosti, zostavy nad DPH s dátumom uskutočnenia zdaniteľného plnenia. Ak potrebujete iné hľadisko, uveďte ho v zadaní.
AI asistent vždy najskôr pripraví návrh podporovaného záznamu. Samotné odoslanie je možné až po výslovnom potvrdení presného návrhu užívateľom. Pri príprave dokladu je vhodné najskôr vyhľadať potrebné väzby, napríklad odberateľa, položky cenníka, formu úhrady alebo bankový účet.
Predajné doklady: napríklad vydaná faktúra, zálohová faktúra, ponuka, prijatá objednávka a výdajka.
Nákupné doklady: napríklad prijatá faktúra a vydaná objednávka, ak sú dostupné v Open API.
Adresár a číselníky: úprava alebo vytvorenie obchodného partnera alebo ďalších podporných záznamov podľa aktuálne dostupných nástrojov Open API.
Úhrady: uhradenie faktúry bez väzby alebo úhrada jedného či viacerých dokladov bankovým pohybom.
Nadväzujúce doklady: prevod objednávky alebo ponuky na nadväzujúci doklad, prenos jednej alebo viacerých výdajok do vydanej faktúry a odpočet zálohovej faktúry.
Exporty: pri vybraných dokladoch možno zobraziť detail a stiahnuť PDF alebo ISDOC.
Ak Open API daný typ záznamu nepodporuje, asistent ho cez MCP nevytvorí. V takom prípade má odpovedať, že akcia nie je dostupná.
Vyhľadaj všetky neuhradené vydané faktúry spoločnosti Nový s.r.o. za minulý mesiac.
Vyhľadaj obchodného partnera podľa IČO 12345678 a vystav mu faktúru s dvoma cenníkovými položkami Z100 a Z120.
Je aktívny bankový účet 1234567890/0200 a akú má nastavenú menu?
Stiahni PDF poslednej vydanej faktúry pre odberateľa ABC.
Vytvor prijatú faktúru podľa tohto PDF a uveď, či je potrebné niečo doplniť.
Kto mi najviac dlhuje a ako dlho sú faktúry po splatnosti?
Ktoré faktúry sú splatné tento týždeň a koľko za ne celkom zaplatím dodávateľom?
Ukáž tržby podľa stredísk za druhý kvartál podľa dátumu uskutočnenia plnenia.
MCP používa rovnaké autentizačné údaje a rovnaký firemný kontext ako Open API. AI asistent nemôže obchádzať prístupové práva a má rovnaké oprávnenia ako užívateľ, ktorý mu vygeneroval API prístup.
API kľúč alebo OAuth klientské údaje (Client ID a Client Secret) sú citlivé údaje a mali by byť sprístupnené iba dôveryhodnému klientovi.
AI asistent pracuje len s dátami firmy, ku ktorej má daný API prístup oprávnenie.
Zmazané alebo neprístupné záznamy sa vo vyhľadávaní nezobrazujú.
Práva k dokladom a skladom sa vyhodnocujú rovnako ako pri bežnom Open API prístupe.
MCP server sprístupňuje iba rozhranie — sadu nástrojov na pripojenie AI. Ktorú konkrétnu aplikáciu alebo AI službu k mPohode pripojíte, volíte vy. Ak použijete cloudovú AI službu (napríklad Claude, Gemini alebo ChatGPT), prechádzajú dáta, ktoré si vyžiadate alebo odošlete, aj cez túto zvolenú AI službu a jej servery — mimo mPohodu aj mimo STORMWARE. Môže ísť aj o osobné alebo citlivé firemné údaje obsiahnuté v nájdených záznamoch.
Pripojená AI má prístup ku všetkému, čo je dostupné cez Open API, a to v rozsahu oprávnení vášho prístupu (API kľúča alebo OAuth klienta). Rozsah obmedzíte právami daného prístupu. Prístup je možné kedykoľvek odvolať zmazaním API kľúča alebo OAuth klienta v agende API.
STORMWARE neurčuje, akú AI službu si pripojíte, kde beží ani ako nakladá s odovzdanými dátami. Za výber AI služby, za spracovanie dát na jej strane a za zmluvné podmienky s jej poskytovateľom zodpovedá používateľ. Používajte len dôveryhodné AI služby, oboznámte sa s ich podmienkami ochrany dát a pri citlivých dátach zvážte AI prevádzkovanú lokálne.
Najjednoduchší spôsob, ako AI asistenta pripojiť k mPohode. Stiahnete jeden súbor, pretiahnete ho do aplikácie Claude Desktop a vložíte API kľúč. Nič ďalšie neinštalujete a žiadne konfiguračné súbory neupravujete.
Stiahnuť prepojenie s Claude Desktop
Vytvorte API kľúč. V mPohode vyberte firmu, ktorú chcete pripojiť, v ponuke firmy otvorte API a v časti Prístup pomocou API kľúča vytvorte tlačidlom Nový kľúč nový kľúč. Skopírujte si ho.
Stiahnite súbor. Kliknite na odkaz vyššie. Do priečinka so stiahnutými súbormi sa uloží súbor s príponou .mcpb.
Pretiahnite súbor do Claude Desktop. V aplikácii Claude Desktop otvorte Settings → Extensions a stiahnutý súbor do tohto okna pretiahnite myšou.
Vložte API kľúč. Claude Desktop zobrazí okno s poľom API kľúč. Vložte doň skopírovaný kľúč a potvrďte tlačidlom Install.
Vyskúšajte to. Otvorte novú konverzáciu a napíšte napríklad „Zobraz moje neuhradené vydané faktúry“. Ak sa Claude opýta, či smie použiť nástroje mPohody, povoľte to.
Pretiahnutie nefunguje? V Claude Desktop zvoľte Settings → Extensions → Advanced settings → Install Extension… a stiahnutý súbor vyberte.
Claude Desktop zatiaľ nemáte? Aplikáciu pre Windows aj macOS stiahnete na claude.ai/download.
Súbor neobsahuje žiadne prihlasovacie údaje. API kľúč zadávate až v Claude Desktop, ktorý ho uloží do zabezpečeného úložiska vášho počítača. Použite kľúč z rovnakej mPohody, z ktorej ste súbor stiahli (napríklad pre beta verziu kľúč z beta mPohody). Ak chcete pripojiť inú firmu, vytvorte kľúč v nej a v Claude Desktop ho zmeňte v Settings → Extensions pri prepojení s mPohodou.
Balíček .mcpb je určený pre Claude Desktop. V iných aplikáciách, napríklad VS Code alebo Cursor, nastavte vlastné MCP pripojenie s hlavičkou Api-Key. ChatGPT pri vlastných MCP pripojeniach aktuálne ponúka OAuth alebo prístup bez prihlásenia; prihlásenie API kľúčom mPohody týmto spôsobom nenastavíte. Podrobnosti nájdete v dokumentácii ChatGPT.
Pre pripojenie AI asistenta je potrebné poznať URL MCP servera a prihlasovací údaj z agendy API. Adresu servera, typ prepojenia, podporované hlavičky aj hotovú ukážku konfigurácie klienta nájdete v technickom nastavení MCP servera, na ktoré vedie odkaz nižšie. Prihlasovací údaj sa posiela v hlavičke každej požiadavky. Spôsob nastavenia hlavičiek nájdete v dokumentácii svojho AI asistenta.
MCP pripojenie odporúčame nastavovať v desktopových (lokálne nainštalovaných) MCP klientoch. Webové rozhrania niektorých AI asistentov zatiaľ pripojenie MCP servera nepodporujú alebo je nastavenie komplikované.
| Spôsob prihlásenia | Hlavička | Kde údaj získate |
|---|---|---|
| API kľúč (odporúčané) | Api-Key: váš API kľúč | Ponuka firmy → API → Prístup pomocou API kľúča → Nový kľúč |
| OAuth klientské údaje | Authorization: Basic a dvojica Client ID a Client Secret zakódovaná do Base64 | Ponuka firmy → API → Prístup pomocou prístupového tokenu |
Niektoré aplikácie umožňujú zadať iba token typu Bearer. V takom prípade vložte API kľúč do hlavičky Authorization ako Bearer, server ho prijme. Ak si môžete zvoliť vlastnú hlavičku, použite Api-Key. Prístupový token vydaný pre Open API na prihlásenie k MCP serveru nepoužijete — pre OAuth zadajte Client ID a Client Secret podľa tabuľky vyššie.
API kľúč nevkladajte do verejných promptov, zdieľaných dokumentov ani do logov. Ak máte podozrenie na únik, kľúč zmažte a vytvorte nový.
Zobraziť technické nastavenie MCP servera
Strojovo čitateľná GraphQL schéma je dostupná ako SDL súbor po prihlásení k Open API.
Požiadavky AI asistenta cez MCP sa počítajú do rovnakého limitu požiadaviek Open API ako bežné REST volania. Základný počet je 8 000 požiadaviek za mesiac pre variant mPohoda Pro a pri rozšírení mCAL ďalších 8 000 požiadaviek za každé mCAL. Náročnejšie zadania (vyhľadávanie, zostavy, príprava dokladov) môžu spotrebovať aj viac požiadaviek. Stav limitov nájdete v hlavičke každej odpovede z API a v agende API.