MCP server

Nordlet nodrošina Model Context Protocol galapunktā https://api.nordlet.com/mcp. Mākslīgā intelekta asistents, kas tam pieslēgts, var meklēt API, lasīt jebkuras operācijas pieprasījuma shēmu un to izsaukt, izmantojot to pašu API atslēgu, uzņēmumu un atļauju kopas (scopes) kā tiešā pieprasījumā. Katrs rīka izsaukums ir parasts API pieprasījums: tas tiek autentificēts, tam tiek piemēroti pieprasījumu biežuma ierobežojumi (rate limit) un uzskaite tāpat kā parasti, un datu izmaiņu pieprasījums mainīts uzņēmuma grāmatvedības datus.

Pieslēgšanās

Galapunkts izmanto straumējamu HTTP (Streamable HTTP) un tiek autentificēts ar Bearer API atslēgā no sadaļas Darba sākšana. Lietotnē Claude Code:

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

Jebkurš cits MCP klients izmanto to pašu vietrādi URL un galveni. Atslēga ar piekļuves tiesībām *:read var izsaukt tikai lasīšanas operācijas; ja pietrūkst tiesību, rīki ziņo par to kā par API kļūdu 403.

Rīki

Trīs rīki aptver visas API operācijas:

Rīks	Ko tas dara
search_operations	Atrod operācijas pēc vārdiem to nosaukumā, ceļā, kopsavilkumā vai aprakstā, pēc izvēles viena moduļa ietvaros (sales, bank, reports utt.). Bez vaicājuma tas uzskaita moduļus.
describe_operation	Atgriež vienas operācijas metodi, ceļu, aprakstu un JSON pieprasījuma shēmu; parametrs includeResponse: true pievieno arī 200 atbildes shēmu.
call_operation	Izpilda vienu operāciju ar JSON pamattekstu. Atbildes pamatteksts tiek atgriezts JSON formātā; atbilde 4xx vai 5xx tiek atgriezta kā rīka kļūda kopā ar statusu un kļūdas struktūru. Neobligāts parametrs idempotencyKey tiek nosūtīts kā galvene Idempotency-Key, tāpēc atkārtots izsaukums ar to pašu atslēgu atgriež pirmo atbildi, atkārtoti neizpildot darbību.

Visbiežāk izmantotās operācijas ir arī tieši rīki ar savām pieprasījuma shēmām, tāpēc asistents redz to laukus bez atsevišķas meklēšanas: 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 un reports_debt_aging. Katrs rīks ietver MCP anotācijas (readOnlyHint, destructiveHint), kas informē klientu par to, vai rīks veic datu ierakstīšanu.

Operāciju rādītājs un shēmas tiek ģenerētas no tā paša OpenAPI apraksta, ko API atsauce un SDK, tāpēc API pievienotā operācija parādās rīkā search_operations reizē ar tās izlaišanu. Servera instrukcijas atgādina asistentam par vispārējiem nosacījumiem: summas ir decimāldaļu virknes, sarakstos izmanto page, pageSize, sort un filter, savukārt nodokļu deklarācija konkrētai valstij atgriež kļūdu 422, ja uzņēmums reģistrēts ārpus šīs valsts.