MCP server

Připojte Claude Code, Claude Desktop nebo jakéhokoli jiného klienta MCP k rozhraní Nordlet API pomocí jediného klíče API.

Nordlet poskytuje Model Context Protocol na adrese https://api.nordlet.com/mcp. Připojený asistent s umělou inteligencí může vyhledávat v API, číst schéma požadavků pro libovolnou operaci a volat ji, přičemž používá stejný klíč API, společnost a oprávnění jako při přímém požadavku. Každé volání nástroje je běžným požadavkem API: prochází ověřením, limitem četnosti (rate limit) i měřením využití a modifikační volání mění účetní knihu společnosti.

Připojení

Koncový bod komunikuje prostřednictvím protokolu Streamable HTTP a ověřuje se pomocí Bearer klíče API získaného v části Začínáme. V aplikaci Claude Code proveďte následující:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp --header "Authorization: Bearer nl_..."

Kterýkoli jiný klient MCP využívá stejnou adresu URL a hlavičku. Klíč s oprávněním omezeným na *:read může volat pouze operace pro čtení; nástroje hlásí chybějící oprávnění jako chybu 403 vrácenou API.

Nástroje

Veškeré operace API pokrývají tři nástroje:

Nástroj	Co dělá
`search_operations`	Vyhledává operace podle slov v názvu, cestě, shrnutí nebo popisu, případně v rámci jednoho modulu (`sales`, `bank`, `reports`, ...). Bez zadaného dotazu vypíše seznam modulů.
`describe_operation`	Vrací metodu, cestu, popis a JSON schéma požadavku pro danou operaci; parametr `includeResponse: true` přidá schéma odpovědi `200`.
`call_operation`	Spustí jednu operaci s tělem v JSON. Tělo odpovědi se vrátí ve formátu JSON; odpověď `4xx` nebo `5xx` se vrátí jako chyba nástroje obsahující stavový kód a chybovou obálku. Volitelný parametr `idempotencyKey` se odesílá v hlavičce `Idempotency-Key`, takže opakované volání se stejným klíčem vrátí původní odpověď, aniž by se akce provedla znovu.

Nejčastěji používané operace jsou zároveň k dispozici jako přímé nástroje s vlastními schématy požadavků, takže asistent vidí jejich pole bez nutnosti vyhledávání: partners_list, partners_get, partners_create, partners_find_or_create, catalog_items_list, sales_invoices_list, sales_invoices_get, sales_invoices_create, sales_invoices_issue, sales_invoices_send, purchases_invoices_list, purchases_invoices_create, purchases_invoices_register, bank_transactions_list, bank_transactions_import, bank_transactions_match, ledger_journal_transactions_list, reports_trial_balance, reports_financial_statements, reports_vat_summary a reports_debt_aging. Každý nástroj obsahuje anotace MCP (readOnlyHint, destructiveHint), které klientovi sdělují, zda provádí zápis.

Index operací a schémata se generují ze stejného popisu OpenAPI jako referenční příručka API a sady SDK, takže operace přidaná do API se v nástroji search_operations objeví současně se svým vydáním. Pokyny serveru připomínají asistentovi platné konvence: částky jsou desetinná čísla zadaná jako řetězce, seznamy podporují parametry page, pageSize, sort a filter, a výkazy pro daňové úřady vrací kód 422, pokud společnost sídlí v jiné než příslušné zemi.