Verteco

Integrácie / AI asistenti / MCP server pre AI asistentov

MCP server pre AI asistentov logo

MCP server pre AI asistentov

K dispozícii

Portál Verteco má vlastný server pre Model Context Protocol (MCP), otvorený štandard, cez ktorý sa AI asistenti ako Claude Code, Claude Desktop, Cursor alebo VS Code Copilot pripájajú k externým systémom. Asistent sa prihlási bežným API kľúčom vášho účtu, dostane šesť nástrojov a nikdy nevidí viac než váš účet. Odoslanie faktúry je právne záväzné, preto nástroj send_document bez argumentu confirm = true volanie odmietne.

Čo je pri MCP inak

MCP (Model Context Protocol) je otvorený štandard, cez ktorý AI asistenti ako Claude, Cursor alebo VS Code volajú nástroje. Náš MCP server beží v portáli na adrese /api/mcp a prihlasuje sa vaším API kľúčom; asistent potom vie čítať prijaté e-faktúry, overiť odberateľa v sieti a pripraviť doklad.

Odoslanie je zámerne chránené: asistent musí volať nástroj s parametrom confirm = true a vy musíte odoslanie potvrdiť; bez toho sa nič nepošle. Rozsah kľúča (firmy, na ktoré smie) platí aj pre MCP, takže asistentovi dáte kľúč obmedzený na jednu firmu.

Hodí sa na rutinu účtovníka: zhrnúť nové prijaté faktúry, vyhľadať doklad podľa dodávateľa, skontrolovať pred odoslaním, či je odberateľ v sieti. Nie je to náhrada účtovného programu ani archívu.

Ako to funguje

  1. 1V portáli otvorte API tokeny (ľavé menu) a záložku MCP server. Kliknite na Vytvoriť kľúč pre AI asistenta: vznikne samostatný API kľúč len pre asistenta, ktorý kedykoľvek zrušíte alebo obmedzíte na IP adresy v záložke API kľúče. Kľúč sa zobrazí iba raz.
  2. 2Skopírujte hotovú konfiguráciu pre svojho asistenta: Claude Code (príkaz claude mcp add s transportom http a hlavičkou Authorization: Bearer), Claude Desktop (claude_desktop_config.json cez most mcp-remote, potrebuje Node.js), Cursor (mcp.json) alebo VS Code (.vscode/mcp.json). Adresa servera je https://peppol.verteco.digital/api/mcp.
  3. 3Začnite rozhovor. Asistent si nástrojom list_companies načíta firmy vášho účtu a potom odpovedá na otázky typu „Ktoré faktúry z minulého mesiaca ešte nie sú doručené a prečo?“ alebo „Skontroluj, či je tento odberateľ v sieti Peppol“.
  4. 4Odoslanie faktúry asistent vykoná až po vašom výslovnom súhlase s konkrétnou faktúrou a príjemcom; nástroj send_document bez confirm = true volanie odmietne. Každé volanie asistenta vidíte v záložke API log.

Čo integrácia rieši

  • ✓Šesť nástrojov: list_companies, list_documents, get_document, check_participant, validate_document a send_document
  • ✓Streamable HTTP a JSON-RPC 2.0 bez stavu: POST na /api/mcp s hlavičkou Authorization: Bearer a vaším API kľúčom
  • ✓Detail faktúry vrátane doručenky MLS, hlásenia Finančnej správe a voliteľne UBL XML do 1 MB
  • ✓Živé overenie príjemcu v sieti Peppol (SML/SMP) a validácia faktúry proti EN 16931 a Peppol BIS 3.0
  • ✓Odoslanie len s confirm = true po vašom výslovnom súhlase; platí brána Verifikačného údaja ako pri odosielaní z portálu
  • ✓Asistent nikdy nevidí viac než váš účet; kľúč zrušíte jedným klikom, obmedzíte na IP adresy a každé volanie je v API logu aj v bezpečnostnom zázname účtu

Časté otázky: e-faktúry pre MCP server pre AI asistentov

Ktorých AI asistentov MCP server podporuje?
Každého klienta, ktorý vie pracovať s MCP cez Streamable HTTP: Claude Code (príkaz claude mcp add), Claude Desktop cez most mcp-remote (potrebuje Node.js, lebo Claude Desktop zatiaľ nepodporuje vlastné hlavičky priamo), Cursor (mcp.json) a VS Code s GitHub Copilot v agent móde. Hotové konfigurácie sú v portáli na stránke API tokeny v záložke MCP server. Webová a mobilná verzia Claude (claude.ai) pripája vzdialené servery len cez OAuth, ktorý zatiaľ neponúkame.
Môže asistent odoslať faktúru bez môjho vedomia?
Nie. Nástroj send_document odmietne volanie bez argumentu confirm = true a asistent má v inštrukciách servera pokyn vyžiadať si váš výslovný súhlas s konkrétnou faktúrou a príjemcom. Platí aj brána overenia odosielania (Verifikačný údaj) ako pri odosielaní z portálu: odosielať môže len firma, ktorá dokončila výber poskytovateľa na portáli Finančnej správy.
Čo asistent vidí a kde to skontrolujem?
Presne to, k čomu má prístup váš účet, a nič viac; dáta faktúr zostávajú u nás v EÚ a asistent dostane len to, na čo sa pýta. Každé volanie kľúča vidíte v záložke API log na stránke API tokeny a v bezpečnostnom zázname účtu. Odporúčame samostatný kľúč len pre asistenta, aby ste ho vedeli kedykoľvek zrušiť bez dopadu na ostatné integrácie.
Čo potrebujem pred pripojením?
Účet na peppol.verteco.digital s aspoň jednou firmou, lebo API kľúč sa viaže na firmy účtu. Najjednoduchšia cesta je výber Verteco ako poskytovateľa na portáli Finančnej správy (prihlásenie cez eID alebo prihlasovacími údajmi k portálu FS); firma sa vám na účte vytvorí automaticky a hneď potom si vygenerujete kľúč.
Koľko to stojí?
Prepojenie je zadarmo. Služba stojí od €2/mes bez DPH za IČO, ktoré odosiela alebo má zapnutý Archív dát; príjem s vypnutým archívom je zadarmo (do 1 000 faktúr mesačne). Počas dobrovoľného obdobia pred mandátom 1. 1. 2027 je všetko bezplatné.

Začnite ešte dnes: stačí výber na portáli Finančnej správy

Príjem zadarmo · bez viazanosti a skrytých poplatkovSplňte si zákonnú povinnosť 2027 za 2 minútyFinančná správa SRVybrať Verteco na portáli Finančnej správy →Na portáli dáte „Pokračovať", prihlásite sa (slovensko.sk / eID alebo prihlasovacie údaje do portálu FS) a potvrdíte výber. Zvyšok spravíme automatickyCertifikovaný poskytovateľ (EFSK000031) · bez viazanosti · poskytovateľa môžete kedykoľvek zmeniť
Ako výber prebieha? (3 kroky, ~2 minúty)
  1. 1Kliknete na tlačidlo vyššie. Otvorí sa oficiálna stránka Finančnej správy „Výber certifikovaného poskytovateľa" s predvybraným Verteco. Kliknete „Pokračovať".
  2. 2Prihlásite sa na Portál finančnej správy, cez slovensko.sk (eID / občiansky s čipom) alebo svojimi prihlasovacími údajmi do PFS, a potvrdíte výber poskytovateľa.
  3. 3Hotovo. Príde vám e-mail s prihlásením. Účet, firmu aj registráciu v sieti Peppol vytvoríme automaticky. Ak váš príjem už drží iný poskytovateľ, záznam nepreberáme: pošleme vám postup s migračným kódom, alebo si v portáli zvolíte, že príjem ostáva u neho a cez nás len odosielate.
  4. Nemáte eID? Na portál Finančnej správy sa prihlásite aj identifikátorom a heslom (prihlasovacie údaje PFS). Prípadne sa zaregistrujte e-mailom a heslom, firmu pridajte ručne a výber dokončte neskôr.
  5. Nevidíte svoju firmu vo výbere daňového subjektu? Ponúkajú sa len subjekty, za ktoré máte na portáli FS autorizáciu. Pridajte si ju v Osobnej internetovej zóne (Autorizácie → Pridať autorizovaného používateľa) a výber dokončíte.
  6. Podrobný návod k výberu na portáli FS →

Súvisiace: Peppol overenie firmy · sprievodca e-faktúrou 2027 · cenník · všetky integrácie