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 čtení a zakládání, ne úpravy:

V sadě je	V sadě není
seznamy a detaily všech zdrojů	mazání dokladů a kontaktů
číselníky a profil firmy	editace existujících záznamů
zakládání dokladů, kontaktů, plateb a skladových pohybů	zaúčtování dokladů
stažení PDF a příloh, nahrání přílohy	odeslání dokladu e-mailem a evidence v EET

Rozsah je zúžený schválně. V účetnictví neexistuje zpětný chod: smazaný nebo přeúčtovaný doklad se z API nevrátí a readOnlyHint je podle MCP jen nápověda klientovi, ne zámek na serveru. Co v sadě není, se dá zavolat API přímo — klíč je pro obojí stejný.

Instalace

Server vyžaduje Node.js 20 nebo novější.

Balíček je publikovaný v GitHub Packages pod scope @iucto, takže si napřed nastavte registry. Do ~/.npmrc nebo do .npmrc projektu:

@iucto:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=VÁŠ_GITHUB_PAT

Token potřebuje oprávnění read:packages; vygenerujete ho na GitHubu v Settings → Developer settings → Personal access tokens.

Pak už jen:

npm install -g @iucto/iucto-mcp-server

Pro MCP klienty se doporučuje npx, viz konfigurace níž.

Nastavení

Nejdřív si vygenerujte API klíč v aplikaci pod Nastavení → Nastavení API.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

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

Claude Code

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

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_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* zakládají skutečné doklady a některé z nich už z API nesmažete. 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.

Co server umí​

Instalace​

Nastavení​

Claude Desktop​

Claude Code​

Proměnné prostředí​

Soubory​

Na co si dát pozor​