OpenAI Codex a doklad.ai: fakturace z terminálu přes MCP

OpenAI Codex připojíte k doklad.ai dvěma příkazy: `codex mcp add` přidá MCP server https://doklad.ai/mcp a `codex mcp login` vás přihlásí účtem doklad.ai. Codex pak v terminálu, v rozšíření pro VS Code i v desktopové aplikaci ChatGPT vystavuje faktury, dohledává platby a zapisuje náklady — hodí se na automatizace i hromadné úpravy.

Co Codex s doklad.ai zvládne

Přes MCP server doklad.ai AI vyhledá a vystaví faktury, upraví je, pošle e-mailem, zapíše úhradu, založí zákazníka, zapíše náklad a spočítá statistiky nebo cash flow — celkem 17 nástrojů. Zkuste třeba:

„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í.“
„Jaký byl cash flow za září?“

Připojení s přihlášením (OAuth)

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.

Připojení s API klíčem

Pro skripty a CI bez prohlížeče použijte API klíč z Integrace → API klíče a webhooky → MCP server v proměnné prostředí:

codex mcp add doklad --url https://doklad.ai/mcp --bearer-token-env-var DOKLAD_API_KEY

Bezpečnost a oprávnění

Přístup povolujete na stránce doklad.ai a vybíráte firmu; připojit AI smí jen vlastník nebo administrátor. Každé volání se zapisuje do auditního logu a připojení zrušíte v Integrace → API klíče a webhooky → Připojené aplikace. Více v kapitole o bezpečnosti.

Když připojení nefunguje

codex mcp list ukazuje „Not logged in“: spusťte codex mcp login doklad.
Po změně firmy vidíte stará data: codex mcp logout doklad a znovu login s jinou firmou.

Průvodce MCP serverem doklad.ai shrnuje připojení ve všech aplikacích na jedné stránce.

Časté dotazy

Funguje doklad.ai v Codexu pro VS Code i v desktopové aplikaci ChatGPT?

Ano. Codex CLI, rozšíření pro VS Code i desktopová aplikace ChatGPT sdílejí konfiguraci ~/.codex/config.toml, takže doklad.ai stačí přidat jednou.

Potřebuji API klíč?

Ne, stačí codex mcp login doklad a přihlášení účtem doklad.ai. API klíč je volitelný pro skripty a CI.

Může Codex fakturu smazat?

Jen koncept nebo stornovanou fakturu. Mazání je v MCP označené jako destruktivní a každé volání se zapisuje do auditního logu.