MCP-server

Nordlet tilbyr Model Context Protocol på https://api.nordlet.com/mcp. En KI-assistent (AI) som kobles til denne, kan søke i API-et, lese forespørselsskjemaet for en hvilken som helst operasjon og kalle den opp med samme API-nøkkel, selskapsomfang (company) og tilganger (scopes) som en direkte forespørsel. Hvert verktøykall er en vanlig API-forespørsel: Den autentiseres, hastighetsbegrenses (rate limited) og måles på lik linje med andre, og et endrende kall (mutating call) oppdaterer selskapets regnskap.

Koble til

Endepunktet benytter Streamable HTTP og autentiseres med Bearer API-nøkkelen fra Kom i gang. I Claude Code:

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

Alle andre MCP-klienter bruker den samme nettadressen og hodet (header). En nøkkel med tilgang til *:read kan bare kjøre lesoperasjoner; verktøyene rapporterer manglende tilgang som API-ets 403-feil.

Verktøy

Tre verktøy dekker samtlige operasjoner i API-et:

Verktøy	Hva det gjør
search_operations	Finner operasjoner basert på ord i navn, bane, sammendrag eller beskrivelse, eventuelt innenfor en bestemt modul (sales, bank, reports, ...). Uten et søkeord lister det opp modulene.
describe_operation	Returnerer metode, bane, beskrivelse og JSON-forespørselsskjema for én operasjon; includeResponse: true legger til skjemaet for 200-responsen.
call_operation	Kjører én operasjon med en JSON-tekstkropp (body). Svartekstkroppen returneres som JSON; et 4xx- eller 5xx-svar returneres som en verktøyfeil med statuskoden og feilomslaget (error envelope). En valgfri idempotencyKey sendes som Idempotency-Key-hodet, slik at et gjentatt kall med samme nøkkel spiller av det første svaret på nytt i stedet for å gjenta handlingen.

De mest brukte operasjonene er også tilgjengelige som egne verktøy med egne forespørselsskjemaer, slik at assistenten ser feltene direkte uten et oppslag: 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 verktøy har MCP-notater (readOnlyHint, destructiveHint) som forteller klienten om det utfører skriveoperasjoner.

Operasjonsindeksen og skjemaene genereres fra den samme OpenAPI-beskrivelsen som API-referansen og SDK-ene, slik at en operasjon som legges til i API-et, dukker opp i search_operations i samme versjon som den lanseres. Serverens instruksjoner minner assistenten på konvensjonene: Beløp er desimalstrenger, lister bruker page, pageSize, sort og filter, og en landspesifikk MVA- eller skatterapportering gir feilmeldingen 422 for et selskap som er registrert utenfor det aktuelle landet.