Které AI asistenty MCP server podporuje?

Každého klienta, který umí pracovat s MCP přes Streamable HTTP: Claude Code (příkaz claude mcp add), Claude Desktop přes most mcp-remote (potřebuje Node.js, protože Claude Desktop zatím nepodporuje vlastní hlavičky přímo), Cursor (mcp.json) a VS Code s GitHub Copilot v agent módu. Hotové konfigurace jsou v portálu na stránce API tokeny v záložce MCP server. Webová a mobilní verze Claude (claude.ai) připojuje vzdálené servery jen přes OAuth, který zatím nenabízíme.

Může asistent odeslat fakturu bez mého vědomí?

Ne. Nástroj send_document odmítne volání bez argumentu confirm = true a asistent má v instrukcích serveru pokyn vyžádat si váš výslovný souhlas s konkrétní fakturou a příjemcem. Platí i brána ověření odesílání (Verifikační údaj) jako při odesílání z portálu: odesílat může jen firma, která dokončila výběr poskytovatele na portálu Finanční správy.

Co asistent vidí a kde to zkontroluji?

Přesně to, k čemu má přístup váš účet, a nic víc; data faktur zůstávají u nás v EU a asistent dostane jen to, na co se ptá. Každé volání klíče vidíte v záložce API log na stránce API tokeny a v bezpečnostním záznamu účtu. Doporučujeme samostatný klíč jen pro asistenta, abyste ho uměli kdykoli zrušit bez dopadu na ostatní integrace.

Co potřebuji před připojením?

Účet na peppol.verteco.digital s alespoň jednou firmou, protože API klíč se váže na firmy účtu. Nejjednodušší cesta je výběr Verteco jako poskytovatele na portálu Finanční správy (přihlášení přes eID nebo přihlašovacími údaji k portálu FS); firma se vám na účtu vytvoří automaticky a hned potom si vygenerujete klíč.

Propojení je zdarma. Služba stojí od €2/měs bez DPH za IČO, které odesílá nebo má zapnutý Archiv dat; příjem s vypnutým archivem je zdarma (do 1 000 faktur měsíčně). Během dobrovolného období před mandátem 1. 1. 2027 je všechno bezplatné.

Integrace / AI asistenti / MCP server pre AI asistentov

MCP server pro AI asistenty

K dispozici

Portál Verteco má vlastní server pro Model Context Protocol (MCP), otevřený standard, přes který se AI asistenti jako Claude Code, Claude Desktop, Cursor nebo VS Code Copilot připojují k externím systémům. Asistent se přihlásí běžným API klíčem vašeho účtu, dostane šest nástrojů a nikdy nevidí víc než váš účet. Odeslání faktury je právně závazné, proto nástroj send_document bez argumentu confirm = true volání odmítne.

Získat plugin v portálu Vytvořit účet zdarma

Jak to funguje

1V portálu otevřete API tokeny (levé menu) a záložku MCP server. Klikněte na Vytvořit klíč pro AI asistenta: vznikne samostatný API klíč jen pro asistenta, který kdykoli zrušíte nebo omezíte na IP adresy v záložce API klíče. Klíč se zobrazí pouze jednou.
2Zkopírujte hotovou konfiguraci pro svého asistenta: Claude Code (příkaz claude mcp add s transportem http a hlavičkou Authorization: Bearer), Claude Desktop (claude_desktop_config.json přes most mcp-remote, potřebuje Node.js), Cursor (mcp.json) nebo VS Code (.vscode/mcp.json). Adresa serveru je https://peppol.verteco.digital/api/mcp.
3Začněte rozhovor. Asistent si nástrojem list_companies načte firmy vašeho účtu a potom odpovídá na otázky typu „Které faktury z minulého měsíce ještě nejsou doručené a proč?“ nebo „Zkontroluj, zda je tento odběratel v síti Peppol“.
4Odeslání faktury asistent provede až po vašem výslovném souhlasu s konkrétní fakturou a příjemcem; nástroj send_document bez confirm = true volání odmítne. Každé volání asistenta vidíte v záložce API log.

Co integrace řeší

✓Šest nástrojů: 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 klíčem
✓Detail faktury včetně doručenky MLS, hlášení Finanční správě a volitelně UBL XML do 1 MB
✓Živé ověření příjemce v síti Peppol (SML/SMP) a validace faktury proti EN 16931 a Peppol BIS 3.0
✓Odeslání jen s confirm = true po vašem výslovném souhlasu; platí brána Verifikačního údaje jako při odesílání z portálu
✓Asistent nikdy nevidí víc než váš účet; klíč zrušíte jedním kliknutím, omezíte na IP adresy a každé volání je v API logu i v bezpečnostním záznamu účtu

Časté otázky: e-faktury pro MCP server pre AI asistentov

Které AI asistenty MCP server podporuje?: Každého klienta, který umí pracovat s MCP přes Streamable HTTP: Claude Code (příkaz claude mcp add), Claude Desktop přes most mcp-remote (potřebuje Node.js, protože Claude Desktop zatím nepodporuje vlastní hlavičky přímo), Cursor (mcp.json) a VS Code s GitHub Copilot v agent módu. Hotové konfigurace jsou v portálu na stránce API tokeny v záložce MCP server. Webová a mobilní verze Claude (claude.ai) připojuje vzdálené servery jen přes OAuth, který zatím nenabízíme.
Může asistent odeslat fakturu bez mého vědomí?: Ne. Nástroj send_document odmítne volání bez argumentu confirm = true a asistent má v instrukcích serveru pokyn vyžádat si váš výslovný souhlas s konkrétní fakturou a příjemcem. Platí i brána ověření odesílání (Verifikační údaj) jako při odesílání z portálu: odesílat může jen firma, která dokončila výběr poskytovatele na portálu Finanční správy.
Co asistent vidí a kde to zkontroluji?: Přesně to, k čemu má přístup váš účet, a nic víc; data faktur zůstávají u nás v EU a asistent dostane jen to, na co se ptá. Každé volání klíče vidíte v záložce API log na stránce API tokeny a v bezpečnostním záznamu účtu. Doporučujeme samostatný klíč jen pro asistenta, abyste ho uměli kdykoli zrušit bez dopadu na ostatní integrace.
Co potřebuji před připojením?: Účet na peppol.verteco.digital s alespoň jednou firmou, protože API klíč se váže na firmy účtu. Nejjednodušší cesta je výběr Verteco jako poskytovatele na portálu Finanční správy (přihlášení přes eID nebo přihlašovacími údaji k portálu FS); firma se vám na účtu vytvoří automaticky a hned potom si vygenerujete klíč.
Kolik to stojí?: Propojení je zdarma. Služba stojí od €2/měs bez DPH za IČO, které odesílá nebo má zapnutý Archiv dat; příjem s vypnutým archivem je zdarma (do 1 000 faktur měsíčně). Během dobrovolného období před mandátem 1. 1. 2027 je všechno bezplatné.

Začněte ještě dnes: stačí výběr na portálu Finanční správy

Příjem zdarma · bez závazků a skrytých poplatkůSplňte si zákonnou povinnost 2027 za 2 minuty

Vybrat Verteco na portálu Finanční správy →Na portálu kliknete na „Pokračovať" (Pokračovat), přihlásíte se (slovensko.sk / eID nebo přihlašovací údaje do portálu FS) a potvrdíte výběr, zbytek zařídíme automatickyCertifikovaný poskytovatel Finanční správy (EFSK000031) · bez závazku · poskytovatele můžete kdykoli změnit

Jak výběr probíhá? (3 kroky, ~2 minuty)

1Kliknete na tlačítko výše, otevře se oficiální stránka Finanční správy „Výber certifikovaného poskytovateľa" (Výběr certifikovaného poskytovatele) s předvybraným Verteco. Kliknete na „Pokračovať" (Pokračovat).
2Přihlásíte se do Portálu finanční správy, přes slovensko.sk (eID / občanský průkaz s čipem) nebo svými přihlašovacími údaji do PFS, a potvrdíte výběr poskytovatele.
3Hotovo, přijde vám e-mail s přihlášením. Účet, firmu i registraci v síti Peppol vytvoříme automaticky. Pokud váš příjem už drží jiný poskytovatel, záznam nepřebíráme: pošleme vám postup s migračním kódem, nebo si v portálu zvolíte, že příjem zůstává u něj a přes nás jen odesíláte.
Nemáte eID? Na portál Finanční správy se přihlásíte i identifikátorem a heslem (přihlašovací údaje PFS). Případně se zaregistrujte e-mailem a heslem, firmu přidejte ručně a výběr dokončete později.
Nevidíte svou firmu ve výběru daňového subjektu? Nabízejí se jen subjekty, ke kterým máte na portálu FS autorizaci. Přidejte si ji v Osobní internetové zóně (Autorizácie → Pridať autorizovaného používateľa) a výběr dokončíte.
Podrobný návod k výběru na portálu FS (slovensky) →

Související: Peppol ověření firmy · průvodce e-fakturou 2027 · ceník · všechny integrace