MCP-server

Nordlet tillhandahåller Model Context Protocol på https://api.nordlet.com/mcp. En AI-assistent som ansluter hit kan söka i API:et, läsa begäransschemat för en åtgärd och anropa den med samma API-nyckel, företag och behörigheter (scopes) som vid en direktbegäran. Varje verktygsanrop är en vanlig API-begäran: det autentiseras, beläggs med hastighetsbegränsning (rate limiting) och mäts på samma sätt, och ett ändrande anrop uppdaterar företagets bokföring.

Anslut

Slutpunkten stöder Streamable HTTP och autentiseras med en Bearer API-nyckel från Komma igång. I Claude Code:

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

Alla andra MCP-klienter använder samma URL och huvud. En nyckel med behörigheten *:read kan endast anropa läsåtgärder, och verktygen rapporterar saknad behörighet som API:ets 403-fel.

Verktyg

Tre verktyg täcker in samtliga åtgärder i API:et:

Verktyg	Funktion
search_operations	Hittar åtgärder baserat på ord i deras namn, sökväg, sammanfattning eller beskrivning, valfritt begränsat till en modul (sales, bank, reports osv.). Utan sökfråga listas modulerna.
describe_operation	Returnerar metod, sökväg, beskrivning och JSON-schema för en åtgärd; includeResponse: true lägger till schemat för 200-svaret.
call_operation	Kör en åtgärd med en JSON-textkropp. Svaret returneras som JSON; ett 4xx- eller 5xx-svar returneras som ett verktygsfel med statuskod och felmeddelandeomslag. En valfri idempotencyKey skickas med som huvudet Idempotency-Key, vilket gör att ett upprepat anrop med samma nyckel återskapar det ursprungliga svaret i stället för att upprepa åtgärden.

De mest använda åtgärderna är även direktverktyg med egna begäranscheman, vilket gör att assistenten ser deras fält utan en separat sökning: 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 och reports_debt_aging. Varje verktyg har tillhörande MCP-annoteringar (readOnlyHint, destructiveHint) som talar om för klienten om det gör skrivningar.

Åtgärdsindexet och schemana genereras från samma OpenAPI-beskrivning som API-referensen och SDK:erna, vilket innebär att en åtgärd som läggs till i API:et visas i search_operations i samma version som den lanseras i. Serverns instruktioner påminner assistenten om konventionerna: belopp anges som decimalsträngar, listor hanterar page, pageSize, sort och filter, och skatterapporter för ett visst land svarar med 422 för företag som är registrerade i ett annat land.