MCP server · zdarma

iÚčetní ve vašem Claude nebo ChatGPT

Model Context Protocol (MCP) propojí vaše faktury, odběratele a výdaje s AI, kterou už používáte. Připojení je zdarma ve všech verzích iÚčetní.

Adresa MCP serveru

https://mcp.iucetni.com/mcp/

Připojení v Claude

V Claude (web, desktop nebo mobil) otevřete Nastavení → Konektory a zvolte Přidat vlastní konektor.
Jako název zadejte iÚčetní a jako adresu https://mcp.iucetni.com/mcp/.
Klikněte na Připojit. Otevře se přihlašovací stránka iÚčetní, kde se přihlásíte e-mailem a heslem svého účtu.
Potvrďte přístup. Hotovo: v novém rozhovoru můžete napsat třeba „Kdo mi ještě nezaplatil?“.

Připojení v ChatGPT

V nastavení ChatGPT přidejte vlastní konektor (aplikaci) typu MCP s adresou https://mcp.iucetni.com/mcp/. Přihlášení a potvrzení přístupu proběhne stejně jako u Claude. Dostupnost vlastních konektorů závisí na vašem tarifu ChatGPT.

Další klienti a AI agenti

Server podporuje transport Streamable HTTP. Klienti s podporou OAuth (Claude Code, Cursor a další) se přihlásí sami:

claude mcp add --transport http iucetni https://mcp.iucetni.com/mcp/

Pro vlastní agenty a automatizace bez přihlašovacího okna vydejte v aplikaci klíč pro AI (Nastavení → Klíče pro AI → Vydat klíč). Můžete ho omezit na vybrané firmy a nastavit mu platnost. Klíč se zobrazí jen jednou a posílá se v hlavičce:

Authorization: Bearer uct_…

Agent tak může například číst objednávky ve své e-mailové schránce na namailu.cz, připravit podle nich fakturu v iÚčetní a poslat ji odběrateli.

Autorizace pro vývojáře

MCP server používá OAuth 2.1 podle specifikace MCP:

Authorization Code s PKCE (S256), refresh tokeny a odvolání tokenu.
Dynamická registrace klientů (RFC 7591): https://mcp.iucetni.com/oauth/register.
Metadata autorizačního serveru: /.well-known/oauth-authorization-server.
Metadata chráněného zdroje: /.well-known/oauth-protected-resource. Server je odkazuje v hlavičce WWW-Authenticate odpovědi 401.
Rozsah (scope): mcp.
Issuer a autorizační server: https://mcp.iucetni.com. Přihlašovací a souhlasová stránka je česky i anglicky podle ui_locales nebo jazyka prohlížeče.

Dřívější adresa https://api.iucetni.com/mcp funguje dál, takže už připojené konektory není potřeba měnit.

Co AI přes MCP umí

Hlavní nástroje serveru:

list_invoices, get_invoice – doklady a jejich stav
get_invoice_pdf – PDF vystaveného dokladu (volitelně s ISDOC) k odeslání e-mailem
create_draft, update_invoice – koncept faktury
issue_invoice – vystavení konceptu s číslem z řady
mark_invoice_paid – evidence úhrady
list_customers, create_customer – odběratelé
lookup_ares – údaje firmy z ARES podle IČO
list_catalog, create_catalog_item – ceník
list_expenses, create_expense, update_expense – výdaje
read_receipt – přečtení účtenky nebo faktury
list_companies, list_bank_accounts – firmy a účty

Bezpečnost a kontrola

Koncepty místo hotových dokladů. Co AI vytvoří, je označené jako „Koncept · AI“ a výdaje štítkem AI, takže je hned poznáte.
Otevřený doklad je chráněný. Do dokladu, který máte otevřený v aplikaci, AI nezapíše.
Přístup zrušíte jedním klepnutím. V aplikaci v Nastavení → Klíče pro AI vidíte všechny přístupy (připojení přes Claude a ChatGPT mají štítek OAuth) i jejich poslední použití.
Data zůstávají v EU. Ukládáme je na serverech v Evropské unii. Poskytovateli AI se předává jen to, co si AI v rozhovoru vyžádá. Podrobnosti najdete v zásadách ochrany soukromí.

S připojením vám rádi pomůžeme na support@iucetni.com.