# MCP server · Dokumentace DameDokladu

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

Source: https://damedoklad.cz/docs/mcp/

# 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.

MCP server připojuje AI asistenty k vašemu účetnictví přes [Model Context Protocol](https://modelcontextprotocol.io). 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ů](/docs/mcp/tools/) |
| **Přihlášení** | OAuth 2.1 s dynamickou registrací klienta, nebo API klíč |

**OAuth, nebo API klíč**

Server podporuje přihlášení OAuth 2.1. Klient, který ho umí, vás pošle přihlásit se do DameDokladu a žádný klíč nepotřebujete. Skripty a nástroje bez prohlížeče používají API klíč v hlavičce Authorization.

## 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](/docs/authentication/). 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:

```bash
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:

```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ů](/docs/mcp/tools/). 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](/docs/authentication/), 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.

Nevratné nástroje jsou označené a MCP klienti se před jejich spuštěním ptají. Než návrh schválíte, projděte si ho. Zaúčtované zápisy se nikdy neupravují, jen se opravují protizápisem.

Částky v nástrojích jsou celá čísla v haléřích a data jsou ve tvaru `YYYY-MM-DD`, viz [Konvence API](/docs/conventions/).

## 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 %.“