MCP-server

Nordlet stiller Model Context Protocol til rådighed på https://api.nordlet.com/mcp. En AI-assistent, der er forbundet hertil, kan søge i API'et, læse anmodningsskemaet for enhver handling og udføre den med samme API-nøgle, virksomheid og rettigheder (scopes) som en direkte anmodning. Et hvilket som helst værktøjskald er en almindelig API-anmodning: Den godkendes, underligger hastighedsbegrænsning (rate limiting) og afregnes som en sådan, og et ændrende kald (mutating call) opdaterer virksomhedens regnskab.

Forbindelse

Slutpunktet (endpoint) kommunikerer via Streamable HTTP og godkendes med Bearer API-nøglen fra Kom i gang. I Claude Code:

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

Enhver anden MCP-klient anvender den samme URL og header. En nøgle begrænset til *:read kan udelukkende udføre læsehandlinger; værktøjerne rapporterer en manglende rettighed som en 403-fejl fra API'et.

Værktøjer

Tre værktøjer dækker samtlige af API'ets funktioner:

Værktøj	Beskrivelse
search_operations	Finder handlinger baseret på ord i deres navn, sti (path), resumé eller beskrivelse, eventuelt afgrænset til et bestemt modul (sales, bank, reports osv.). Uden en søgestreng vises en liste over modulerne.
describe_operation	Returnerer metode, sti, beskrivelse og JSON-anmodningsskema for en given handling; includeResponse: true tilføjer skemaet for 200-svaret.
call_operation	Udfører en handling med et JSON-indhold. Svaret returneres som JSON; et 4xx- eller 5xx-svar returneres som en værktøjsfejl indeholdende statuskoden og fejlomslaget. En valgfri idempotencyKey sendes med som Idempotency-Key-headeren, hvilket sikrer, at et gentaget kald med samme nøgle returnerer det første resultat i stedet for at gentage handlingen.

De mest anvendte handlinger findes desuden som direkte værktøjer med deres egne anmodningsskemaer, så assistenten kan se felterne uden et opslag: 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 og reports_debt_aging. Hvert værktøj er udstyret med MCP-annotationer (readOnlyHint, destructiveHint), som oplyser klienten om, hvorvidt handlingen foretager skriveoperationer.

Handlingsindekset og skemaerne genereres ud fra den samme OpenAPI-beskrivelse som API-referencen og SDK'erne, hvilket betyder, at en handling, der føjes til API'et, automatisk gøres tilgængelig i search_operations i den version, den udgives i. Serverens instruktioner minder assistenten om konventionerne: beløb angives som decimalstrenge, lister håndterer page, pageSize, sort og filter, og landespecifik indberetning svarer med 422, såfremt virksomheden hører til uden for det pågældende land.