Verteco

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

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.

Získať plugin v portáliVytvoriť účet zadarmo

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