AI asistent cez MCP

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 Pro funkcia.

1. Čo AI asistent vie

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.

2. Možnosti vyhľadávania

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
DokladyVydané 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 úhradNeuhradené vydané faktúry a zálohové faktúry, príchodzie a odchodzie bankové pohyby.typ dokladu, obdobie, obchodný partner
Obchodní partneriFirmy 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íkPoložky cenníka na vloženie do dokladov.názov, kód, EAN, PLU, predajné položky
ČíselníkyHotovostné 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.

3. Zostavy a prehľady

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.

ZostavaNa čo slúži
Neuhradené vydané faktúryZoznam 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íkovOdberatelia zoradení podľa výšky neuhradených pohľadávok, voliteľne len po splatnosti.
Pohľadávky podľa vekuRozdelenie 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ľovOdberatelia s najvyššími tržbami za zvolené obdobie.
Tržby podľa stredískTržby rozdelené na strediská; možno počítať podľa dátumu uskutočnenia plnenia alebo podľa dátumu vystavenia.
Vývoj tržiebTržby po mesiacoch pre porovnanie období.
Prehľad DPHZáklady a sumy dane podľa sadzieb za zvolené obdobie.
Dostupnosť zásobMnož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í.

4. Vytváranie záznamov

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

5. Príklady zadania

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

6. Bezpečnosť a oprávnenia

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.

Kam putujú vaše dáta

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.

7. Nastavenie pripojenia

Claude Desktop (Windows a macOS)

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

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

  2. Stiahnite súbor. Kliknite na odkaz vyššie. Do priečinka so stiahnutými súbormi sa uloží súbor s príponou .mcpb.

  3. Pretiahnite súbor do Claude Desktop. V aplikácii Claude Desktop otvorte Settings → Extensions a stiahnutý súbor do tohto okna pretiahnite myšou.

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

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

Ďalší MCP klienti

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áseniaHlavičkaKde ú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é údajeAuthorization: Basic a dvojica Client ID a Client Secret zakódovaná do Base64Ponuka 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.

Späť na začiatok

TeamViewer Stiahnite si program TeamViewer a spojte sa s nami priamo.