Jak propojit fakturaci s Claude a ChatGPT přes MCP (návod)

Chcete se svého AI asistenta — Claude nebo ChatGPT — přímo zeptat „kolik mám neuhrazených faktur?“ nebo mu říct „vystav fakturu firmě Nova s.r.o. za konzultaci“? Přesně tohle umožňuje standard MCP (Model Context Protocol). V tomto návodu si krok za krokem ukážeme, jak Fakturujsi.cz propojit s Claude i ChatGPT, co všechno pak AI s vaší fakturací zvládne a kde jsou hranice.

Co je MCP a proč je to důležité

MCP (Model Context Protocol) je otevřený standard pro propojení AI aplikací s externími systémy — datovými zdroji, nástroji a službami. Dokumentace protokolu ho přirovnává k „USB-C portu pro AI aplikace“: stejně jako USB-C nabízí jednotný způsob propojení zařízení, MCP nabízí jednotný způsob, jak AI aplikace napojit na vnější systémy. Standard dnes podporují AI asistenti jako Claude i ChatGPT a vývojářské nástroje jako Visual Studio Code nebo Cursor.

Architektura má tři role: MCP host je samotná AI aplikace (např. Claude), MCP klient je komponenta uvnitř hosta, která drží spojení, a MCP server je program, který poskytuje data a nástroje. Servery mohou běžet lokálně (transport stdio), nebo vzdáleně přes internet (transport Streamable HTTP). Fakturujsi.cz je právě takový vzdálený MCP server — váš AI asistent se k němu připojí přes internet a získá přístup k vašim fakturám.

Komunikace probíhá protokolem JSON-RPC 2.0 a server nabízí tzv. primitiva — především nástroje (funkce, které AI může vyvolat, např. vyhledání faktur) a zdroje (data pro kontext). U vzdálených serverů přes Streamable HTTP standard doporučuje pro získání přístupového tokenu použít OAuth — a přesně tak to Fakturujsi.cz dělá.

Návod: připojení Claude nebo ChatGPT přes OAuth

Nejjednodušší cesta je připojení jedním kliknutím přes OAuth 2.1. Nemusíte nikde kopírovat API klíče — přihlásíte se přes standardní přihlašovací obrazovku Fakturujsi.cz.

1. Přidejte konektor. Ve svém AI nástroji (Claude nebo ChatGPT) přidejte vlastní MCP konektor a zadejte adresu serveru: https://www.fakturujsi.cz/api/mcp/v1
2. Automatická registrace. AI nástroj se sám zaregistruje (tzv. Dynamic Client Registration) — nemusíte ručně vytvářet žádnou aplikaci.
3. Přihlášení. Nástroj vás přesměruje na přihlášení do Fakturujsi.cz.
4. Souhlas a rozsah. Na souhlasné obrazovce vyberete organizaci a rozsah přístupu (čtení, případně zápis) pro faktury, kontakty, náklady, platby, produkty, banku a reporty.
5. Hotovo. Vydaný token je vázán na konkrétní MCP zdroj (dle RFC 8707) a respektuje vaši roli v organizaci. Připojení kdykoli odpojíte v sekci „Připojené aplikace“ — odpojení platí okamžitě.

Připojení přes API klíč (CLI a headless nástroje)

Některé nástroje OAuth nepodporují — typicky Claude Code v příkazové řádce, Cursor nebo vlastní skripty. Pro ně lze stejný endpoint použít s API klíčem fak_… se scopem mcp:connect, který pošlete v hlavičce Authorization: Bearer fak_…. Tento režim respektuje IP allowlist i rate limit nastavený u vašeho MCP serveru. Technické detaily včetně seznamu scopů najdete v API dokumentaci v sekci MCP protokol.

Co který tarif umožňuje

MCP server je dostupný na všech tarifech včetně Free, ale s omezením podle tarifu:

• Free a Starter — připojení pouze pro čtení (1 připojení). AI se vás může ptát na stav faktur, plateb a kontaktů, ale nemůže nic měnit.
• Business a vyšší — zápis přes AI: vytváření a úpravy faktur, kontaktů, nákladů a plateb přímo z Claude nebo ChatGPT.

Omezení se vynucuje na serveru — u Free a Starter se write rozsahy na souhlasné obrazovce vůbec neudělí a případný pokus o zápis skončí chybou s odkazem na upgrade. Aktuální přehled tarifů najdete na stránce ceníku.

Bezpečnost a hranice

Propojení přes MCP dává AI přístup k reálným datům, proto stojí za to znát pojistky:

• Token vázaný na zdroj. Přístupový token je podle RFC 8707 vázán na konkrétní MCP zdroj, takže ho nelze zneužít jinde.
• Respekt k roli. AI přes MCP nikdy neobejde vaše oprávnění v organizaci — co nesmíte vy, nesmí ani asistent.
• Okamžité odpojení. Připojení zrušíte kdykoli v sekci „Připojené aplikace“; platí to hned.
• Vy kontrolujete výstup. I když AI fakturu navrhne, výsledek si vždy zkontrolujte, než ho pošlete zákazníkovi.

Časté dotazy

Potřebuji programátorské znalosti?

Ne. U připojení přes OAuth jen v Claude nebo ChatGPT přidáte konektor a vložíte adresu serveru; zbytek proběhne automaticky. API klíč potřebujete pouze u nástrojů z příkazové řádky.

Můžu z ChatGPT nebo Claude fakturu i vystavit?

Ano, ale zápis (vytváření a úpravy dokladů) přes AI vyžaduje tarif Business nebo vyšší. Na Free a Starter je připojení jen pro čtení — AI vám odpoví na dotazy o vašich datech, ale nic nezmění.

Je to bezpečné?

Přístup uděluje standard OAuth 2.1, token je vázaný na konkrétní zdroj (RFC 8707), respektuje vaši roli a připojení lze okamžitě odpojit. Doporučené je udělovat jen ty rozsahy, které skutečně potřebujete.

Jak se Fakturujsi.cz liší od ostatních v oblasti MCP?

MCP server dnes nabízí i další nástroje — například Fakturoid zveřejnil vlastní MCP server pro napojení AI asistentů. Podrobné funkční srovnání najdete na stránce Fakturujsi.cz vs. Fakturoid nebo v přehledu všech srovnání.

Kde začít, když teprve fakturuji?

Než řešit MCP, projděte si základ v průvodci První faktura krok za krokem a co obecně AI ve fakturaci umí v článku Co je AI fakturace.