AI asistent cez MCP

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 .

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.

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.

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 Open 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

Pre pripojenie AI asistenta je potrebné poznať URL MCP servera a prihlasovací údaj z agendy Open 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é.

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 Open API.

Späť na začiatok

Stiahnite si program TeamViewer a spojte sa s nami priamo.