MCP server pro AI asistenty

Model Context Protocol je otevřený standard, kterým se AI asistenti připojují k externím systémům. MCP server iÚčta zpřístupní účetní data přímo v Claude Desktop, Claude Code a dalších MCP klientech – asistent pak nemusí znát REST API, dostane pojmenované nástroje.

Nástroje se generují z téže specifikace jako reference, takže se s API nerozejdou. Nástroj se jmenuje stejně jako operace v referenci: createInvoiceIssued odpovídá stránce Vytvoření faktury vydané.

Co server umí

Server vystavuje všechny operace API kromě evidence v EET: seznamy a detaily, číselníky a profil firmy, zakládání i editaci dokladů, kontaktů, plateb a skladových pohybů, zaúčtování, mazání, generování odkazů pro sdílení, odesílání dokladů e-mailem, stahování PDF a příloh i nahrávání souborů.

Evidence v EET zůstává mimo: odesílá se na Finanční správu, vzít zpět ji nejde a evidence tržeb skončila v roce 2023. Zavolat ji jde API přímo, klíč je pro obojí stejný.

U operací, které v účetnictví nejdou vzít zpět – editace a mazání – si server řekne o potvrzení sám, pokud to váš MCP klient umí zobrazit. Všechny zapisovací nástroje jsou navíc označené tak, aby se Claude Code zeptal před každým voláním. Označení je ale nápověda klientovi, ne zámek – a v Claude Desktopu se potvrzovací dialog vůbec nezobrazí, takže jedinou ochranou proti nechtěné editaci nebo smazání je tam režim read-only: vyplňuje se do pole Režim v instalačním dialogu balíku, u ostatních klientů do proměnné IUCTO_MCP_MODE. Obojí je popsané níž.

Instalace a nastavení

Nejdřív si vygenerujte API klíč v aplikaci pod Nastavení → Nastavení API. Budete ho potřebovat u obou postupů.

Claude Desktop

Stáhněte si balík iucto-mcp-server.mcpb a soubor otevřete. Claude Desktop ukáže instalační dialog se třemi poli: API klíč, složka pro stažené doklady a Režim. Do režimu se vyplňuje full (předvyplněný, všechny nástroje), nebo read-only – jinde než tady si v Claude Desktopu režim nenastavíte, tabulka proměnných níž je pro Claude Code a konfigurační soubor Desktop nepoužívá. Když chcete jistotu, že asistent nic nepřepíše ani nesmaže, přepište pole na read-only. Tím instalace končí: balík si nese své závislosti a Node si přináší Claude Desktop, takže nemusíte nic doinstalovávat ani ručně upravovat konfigurační soubor.

Claude Code a ostatní MCP klienti

Balíček je na veřejném npm, takže nepotřebuje přihlášení ani .npmrc. Vyžaduje Node.js 20 nebo novější.

claude mcp add iucto \
  -e IUCTO_API_KEY=váš-klíč \
  -- npx -y @iucto.cz/iucto-mcp-server

Klienti, které se nastavují souborem, berou tentýž příkaz:

{
  "mcpServers": {
    "iucto": {
      "command": "npx",
      "args": ["-y", "@iucto.cz/iucto-mcp-server"],
      "env": { "IUCTO_API_KEY": "váš-klíč" }
    }
  }
}

Proměnné prostředí

Proměnná	Povinná	Výchozí	Význam
IUCTO_API_KEY	ano	–	hodnota hlavičky X-Auth-Key
IUCTO_API_BASE	ne	https://online.iucto.cz/api/1.3	jiná instance API
IUCTO_DOWNLOAD_DIR	ne	dočasný adresář systému	kam se ukládají stažená PDF a přílohy
IUCTO_MCP_MODE	ne	full	read-only nabídne jen 73 čtecích nástrojů, full všech 158
IUCTO_LOG_LEVEL	ne	info	debug / info / warn / error

Soubory

Nástroje pro PDF a přílohy soubor uloží na disk a vrátí cestu, ne jeho obsah: jedno faktura-PDF má stovky kilobajtů a zaplnilo by asistentovi kontext. Adresář nastavíte IUCTO_DOWNLOAD_DIR.

Při nahrávání přílohy pošlete buď file_path (cesta na stroji, kde běží server), nebo content_base64 spolu s filename. Povolené přípony a limit velikosti popisuje Nahrání přílohy.

Na co si dát pozor

Asistent píše do ostrého účetnictví

Klíč má stejná oprávnění jako uživatel ve webové aplikaci a sandbox neexistuje. Nástroje create*, update* a delete* píšou do skutečného účetnictví. Co založí createDocumentScan a createStockMovement, navíc z API nesmažete vůbec – uklidíte to jedině ručně ve webové aplikaci. Klíč nejde omezit na část účtu, platí pro celou firmu a MCP klient si ho ukládá do konfigurace jako čitelný text, takže s ním zacházejte jako s heslem. Na zkoušení si založte druhou, zkušební firmu.

• Volání jdou do denní kvóty stejně jako přímá volání API, viz Limity a kvóty.
• Server je vhodný na práci s daty („vypiš mi neuhrazené faktury", „založ zákazníka"). Když píšete integraci, potřebujete popis rozhraní, na to je reference a OpenAPI specifikace.
• Seznam nástrojů zabere asistentovi kus kontextu hned na začátku sezení. Klienti, kteří umí načítat nástroje až podle potřeby, si ho zlevní sami.

Zdrojový kód a hlášení chyb: github.com/iUcto/iucto-mcp-server.