Fakturace a účetnictví přes MCP: doklad.ai v Claude, ChatGPT, Codexu i Cursoru

Doklad.ai má vlastní MCP server na adrese https://doklad.ai/mcp. Připojíte ho do Claude, ChatGPT, Claude Code, Codexu, Cursoru, VS Code nebo Gemini CLI a faktury, zákazníky i náklady pak spravujete běžnou větou — třeba „vystav fakturu firmě Alfa s.r.o. za 12 hodin konzultací po 1 500 Kč“. Přihlašujete se svým účtem doklad.ai přes OAuth, žádný klíč nikam nekopírujete. MCP server je stejně jako celý doklad.ai aktuálně zdarma, bez limitu faktur a bez platební karty.

Co je MCP a proč se týká vaší fakturace

Model Context Protocol (MCP) je otevřený standard, přes který AI asistent volá nástroje jiných aplikací. Jedno rozhraní funguje v Claude, ChatGPT, Codexu, Cursoru, VS Code i dalších nástrojích, takže doklad.ai připojíte kamkoli, kde zrovna pracujete.

Bez MCP vám AI o fakturaci jen radí. S MCP serverem doklad.ai si sama přečte vaše faktury, najde odběratele, vystaví doklad, pošle ho e-mailem nebo zapíše úhradu — přímo ve vašem účtu, s vaším souhlasem a se záznamem v auditním logu.

Co AI přes doklad.ai zvládne

MCP server doklad.ai nabízí 17 nástrojů:

• Faktury: vyhledání a filtrování (stav, zákazník, období), detail s položkami, vystavení, úprava, odeslání e-mailem, odkaz na PDF, zápis úhrady a smazání konceptu.
• Zákazníci: vyhledání podle názvu, IČO nebo e-mailu, detail, založení a úprava.
• Náklady: seznam, detail a zápis nového nákladu.
• Přehledy: statistiky faktur (zaplacené, odeslané, po splatnosti, koncepty) a cash flow — příjmy, výdaje a zisk za zvolené období.

Co můžete AI napsat

• „Které faktury jsou po splatnosti a kolik mi dohromady dluží?“
• „Vystav fakturu firmě Alfa s.r.o. za 12 hodin konzultací po 1 500 Kč bez DPH, splatnost 14 dní.“
• „Pošli fakturu 2026-0142 odběrateli e-mailem.“
• „Přišla platba 18 150 Kč za fakturu 2026-0137, zapiš úhradu k dnešnímu dni.“
• „Jaký byl cash flow za září a jak se liší od srpna?“
• „Zapiš náklad: hosting za září, 990 Kč bez DPH, dnešní datum.“

Potřebné kroky si AI poskládá sama — nejdřív najde odběratele, pak vystaví fakturu. Doklad.ai ji navíc instruuje, aby odeslání e-mailu, zápis úhrady a mazání vždy nejdřív potvrdila s vámi.

Adresa serveru a přihlášení

Adresa MCP serveru je pro všechny aplikace stejná:

https://doklad.ai/mcp

Přihlašujete se svým účtem doklad.ai přes OAuth: AI aplikace vás přesměruje na doklad.ai, tam vyberete firmu a povolíte přístup. Heslo AI aplikace nikdy neuvidí a žádný klíč nikam nekopírujete. Pro nástroje bez OAuth (n8n, vlastní skripty) je k dispozici API klíč.

Claude: claude.ai, Claude Desktop a mobil

1. Na claude.ai otevřete Customize → Connectors a klikněte na Add custom connector — nebo rovnou použijte předvyplněný odkaz.
2. Jako název zadejte Doklad.ai, jako URL https://doklad.ai/mcp, přihlášení ponechte Sign in now a konektor přidejte.
3. Otevře se doklad.ai — přihlaste se, vyberte firmu a povolte přístup.
4. V chatu zapněte doklad.ai v nabídce nástrojů a napište třeba „Jaké faktury mám po splatnosti?“.

Připojený konektor funguje na webu, v aplikaci Claude Desktop i v mobilní aplikaci Claude. Vlastní konektory jsou ve všech tarifech Claude, ve Free je povolený jeden. V tarifech Team a Enterprise konektor nejdřív přidá vlastník organizace v Organization settings → Connectors → Add → Custom → Web a členové se pak jen připojí svým účtem doklad.ai.

ChatGPT

1. V ChatGPT na webu otevřete Settings → Security and login a zapněte Developer mode.
2. Otevřete chatgpt.com/plugins, klikněte na + a vyplňte název Doklad.ai, krátký popis a jako připojení (Connection) adresu https://doklad.ai/mcp s ověřením OAuth.
3. Přihlaste se do doklad.ai, vyberte firmu a povolte přístup.
4. V novém chatu vyberte doklad.ai v nabídce nástrojů a pište běžně česky.

Vývojářský režim je dostupný v tarifech Plus, Pro, Business, Enterprise a Edu na webu ChatGPT. Před akcí, která něco mění (vystavení faktury, odeslání e-mailu), si ChatGPT řekne o potvrzení.

Claude Code

claude mcp add --transport http doklad https://doklad.ai/mcp

Pak v Claude Code napište /mcp, vyberte doklad a zvolte Authenticate — otevře se prohlížeč s přihlášením do doklad.ai. Přepínač --scope user zpřístupní doklad.ai ve všech vašich projektech.

OpenAI Codex (CLI, VS Code, desktopová aplikace)

codex mcp add doklad --url https://doklad.ai/mcp
codex mcp login doklad

Příkaz login otevře prohlížeč s přihlášením do doklad.ai. Nastavení se uloží do ~/.codex/config.toml, které sdílí Codex CLI, rozšíření Codex pro VS Code i desktopová aplikace ChatGPT, takže doklad.ai stačí přidat jednou. Stav ověříte příkazem codex mcp list — u doklad.ai má být OAuth. Codex je součástí všech tarifů ChatGPT včetně Free.

Cursor

Nejrychleji tlačítkem Přidat do Cursoru na této stránce. Ručně do souboru ~/.cursor/mcp.json (všechny projekty) nebo .cursor/mcp.json (jeden projekt) přidejte:

{
  "mcpServers": {
    "doklad": {
      "url": "https://doklad.ai/mcp"
    }
  }
}

V Cursor Settings → Tools & MCP se u doklad.ai objeví výzva k přihlášení. Po kliknutí se otevře doklad.ai, kde vyberete firmu a povolíte přístup.

VS Code s GitHub Copilotem

Nejrychleji tlačítkem Přidat do VS Code na této stránce. Ručně do souboru .vscode/mcp.json v projektu (nebo přes příkaz MCP: Add Server) přidejte:

{
  "servers": {
    "doklad": {
      "type": "http",
      "url": "https://doklad.ai/mcp"
    }
  }
}

Při prvním spuštění serveru se VS Code zeptá na přihlášení do doklad.ai. Nástroje pak používá GitHub Copilot v chatu v režimu Agent. Potřebujete VS Code 1.99 nebo novější; v tarifech Copilot Business a Enterprise musí správce organizace povolit zásadu MCP servers in Copilot.

Gemini CLI

gemini mcp add --scope user --transport http doklad https://doklad.ai/mcp

Bez --scope user se server přidá jen do aktuálního projektu. V Gemini CLI pak spusťte /mcp auth doklad a přihlaste se v prohlížeči.

API klíč: n8n, skripty a nástroje bez OAuth

API klíč vytvoříte v doklad.ai v Integrace → API klíče a webhooky → MCP server. AI nástroj ho posílá v hlavičce Authorization: Bearer dk_…. Klíč patří do proměnné prostředí, ne do souborů, které sdílíte nebo commitujete.

Claude Code:

claude mcp add --transport http doklad https://doklad.ai/mcp --header "Authorization: Bearer $DOKLAD_API_KEY"

Codex (~/.codex/config.toml):

[mcp_servers.doklad]
url = "https://doklad.ai/mcp"
bearer_token_env_var = "DOKLAD_API_KEY"

Claude Desktop přes most mcp-remote (Node.js 20.18 nebo novější) v claude_desktop_config.json — otevřete ho v Settings → Developer → Edit Config a po úpravě aplikaci úplně ukončete a spusťte znovu. Mezera za Bearer patří do proměnné, ne do argumentu; jinak ji Claude Desktop ve Windows rozdělí:

{
  "mcpServers": {
    "doklad": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://doklad.ai/mcp", "--header", "Authorization:${DOKLAD_AUTH_HEADER}"],
      "env": { "DOKLAD_AUTH_HEADER": "Bearer dk_VAS_KLIC" }
    }
  }
}

V n8n použijte uzel MCP Client Tool: Endpoint https://doklad.ai/mcp, Server Transport HTTP Streamable, Authentication Bearer Auth s klíčem dk_….

Bezpečnost a kontrola nad daty

• OAuth 2.1 s PKCE. AI aplikace nikdy nevidí vaše heslo. Dostane token k jedné firmě, který platí hodinu a průběžně se obnovuje.
• Souhlas s výběrem firmy. Na stránce doklad.ai vidíte, která aplikace žádá o přístup a kam vás po povolení vrátíme. Připojit AI smí jen vlastník nebo administrátor firmy.
• Odvolání jedním kliknutím. Všechna připojení najdete v Integrace → API klíče a webhooky → Připojené aplikace.
• Auditní log. Každé volání nástroje se zapisuje do auditního logu firmy.
• Opatrnost u zásahů. Nástroje, které něco mění nebo posílají ven, jsou v MCP označené a AI aplikace je ve výchozím nastavení spouštějí až po vašem potvrzení. Smazat jde jen koncept nebo stornovaná faktura.
• Limit požadavků. Nejvýš 60 volání za minutu na firmu, takže zacyklená AI nenadělá škody.
• Otisky místo tajemství. Tokeny ani API klíče v databázi nejsou v čitelné podobě, jen jejich otisk.

Fakturace, nebo účetnictví?

Doklad.ai pokrývá fakturaci, evidenci nákladů, párování plateb a přehledy pro OSVČ a malé firmy. Podvojné účetnictví a daňová přiznání dál vede účetní — podklady jí předáte exportem, například do Pohody nebo Money S3. Přes MCP tak AI připraví a zkontroluje podklady pro účetnictví, ne účetní závěrku. Účetní, která s doklad.ai umí pracovat, najdete v katalogu účetních.

Kolik to stojí

MCP server je stejně jako celý doklad.ai aktuálně zdarma, bez limitu faktur a bez platební karty. Předplatné samotné AI aplikace (Claude, ChatGPT, Cursor…) platíte jejímu poskytovateli; některé aplikace nabízejí vlastní konektory jen v placených tarifech.

Časté dotazy