Přehled

MCP server

Připojte Claude, ChatGPT nebo Cursor k účetnictví přes Model Context Protocol, přihlášením OAuth 2.1 nebo API klíčem.

Aktualizováno 30. 10. 2026

MCP server připojuje AI asistenty k vašemu účetnictví přes Model Context Protocol. Ptáte se vlastními slovy a asistent volá stejné operace, jaké používá aplikace.


Adresa	`https://api.damedoklad.cz/mcp`
Přenos	Streamable HTTP, bezstavový, jen `POST`
Nástroje	Každá operace `/v1` je jeden nástroj, viz seznam nástrojů
Přihlášení	OAuth 2.1 s dynamickou registrací klienta, nebo API klíč

Přihlášení přes OAuth

To je cesta pro Claude, ChatGPT a další klienty, kteří umějí otevřít prohlížeč. Zadáte jen adresu výše. Klient se sám zaregistruje, pošle vás přihlásit se do DameDokladu a vy vyberete:

které firmy připojení uvidí a
jestli smí zapisovat (full), nebo jen číst (read).

Připojené aplikace uvidíte a odvoláte v Nastavení > API a MCP. Tarif s API klíči k tomu nepotřebujete.

Pro vývojáře klientů jsou tady podrobnosti:


Zjišťování	`/.well-known/oauth-protected-resource/mcp` a `/.well-known/oauth-authorization-server`
Registrace	`POST /oauth/register` (RFC 7591) a dokumenty s metadaty klienta
Tok	Autorizační kód s PKCE `S256`; veřejní klienti používají `none`
Rozsahy	`read` a `full`
Platnost	Přístupový token 15 minut, obnovovací token 60 dní

Nepřihlášený požadavek dostane 401 s hlavičkou WWW-Authenticate, která odkazuje na zjišťovací dokument.

Přihlášení API klíčem

Pro skripty a nástroje bez prohlížeče. Klíč založíte v Nastavení > API a MCP, viz Přihlášení a API klíče. Klíč patří jedné firmě a určuje rozsah:

Text

Authorization: Bearer secret_…

Claude

V Claude na webu a v desktopové aplikaci přidáte v Settings > Connectors vlastní konektor s adresou výše. Přihlásí se přes OAuth.

V Claude Code stačí jeden příkaz a při prvním použití serveru se přihlásíte přes OAuth:

Terminal

claude mcp add --transport http damedoklad https://api.damedoklad.cz/mcp

Pokud tam chcete použít API klíč, přidejte --header "Authorization: Bearer $DAMEDOKLAD_API_KEY".

ChatGPT

V ChatGPT se vzdálené MCP servery přidávají ve vývojářském režimu v nastavení. Zadejte adresu výše a přihlaste se přes OAuth.

Cursor

Server přidejte do ~/.cursor/mcp.json nebo do .cursor/mcp.json v projektu. Cursor se přihlásí přes OAuth; API klíč načtěte z proměnné prostředí, ať nezůstane v repozitáři:

.cursor/mcp.json

{
  "mcpServers": {
    "damedoklad": {
      "url": "https://api.damedoklad.cz/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DAMEDOKLAD_API_KEY}"
      }
    }
  }
}

Ostatní klienti

Jakýkoli klient, který podporuje vzdálený server přes Streamable HTTP, se připojí stejně: přes zjišťování OAuth, nebo adresou a hlavičkou Authorization.

Více firem

Připojení přes OAuth vidí všechny firmy, které jste mu povolili. get-current-workspace řekne, která je aktivní, a switch-workspace ji změní. API klíč zůstává vždy ve své jedné firmě.

Méně nástrojů

Někteří klienti omezují počet nástrojů. Parametrem tools vyberete jen některé skupiny:

Text

https://api.damedoklad.cz/mcp?tools=invoices,contacts

Názvy skupin vypíše nástroj list-tool-groups a najdete je i v seznamu nástrojů. Nástroje get-current-workspace a list-tool-groups jsou dostupné vždy.

Když chcete u libovolného připojení nabídnout jen čtecí nástroje, přidejte ?read_only=1 nebo hlavičku X-MCP-Readonly: 1. Připojení s rozsahem read zapisovací nástroje nikdy neuvidí.

Na co si dát pozor

Vystavení dokladu a zaúčtování mají právní účinky. Asistent by si je s vámi měl potvrdit.

Nástroje confirm-payment-order-send a confirm-filing-submission odesílají skutečné peníze a podání. Připojení je uvidí, jen když má oprávnění odesílat, a fungují, jen když to vlastník ve firmě zapnul a v jeho limitech. Bez toho asistent příkaz nebo podání připraví a potvrdíte ho vy v aplikaci.

Text v dokladech a e-mailech píší cizí lidé a může agentovi něco podsouvat. Oprávnění odesílat dávejte jen agentovi, kterému plně věříte, a takovému, který nečte cizí dokumenty bez dohledu.

Částky v nástrojích jsou celá čísla v haléřích a data jsou ve tvaru YYYY-MM-DD, viz Konvence API.

Vyzkoušejte si

„Ke které firmě jsi připojený?“
„Které faktury jsou víc než 30 dní po splatnosti?“
„Připrav fakturu pro Kavárnu Modrou na 18 400 Kč bez DPH se sazbou 12 %.“