MCP serveris

Prijunkite „Claude Code“, „Claude Desktop“ arba bet kurį MCP klientą prie Nordlet API naudodami vieną API raktą.

Nordlet palaiko Model Context Protocol protokolas adresu https://api.nordlet.com/mcp. Prie jo prijungtas dirbtinio intelekto asistentas gali ieškoti API, skaityti bet kurios operacijos užklausos schemą ir ją vykdyti naudodamas tą patį API raktą, įmonę ir teises (scopes) kaip ir atlikdamas tiesioginę užklausą. Kiekvienas įrankio iškvietimas yra įprasta API užklausos: ji autentifikuojama, jai taikomi užklausų dažnio ribojimai (rate limits) ir apskaita, o duomenis keičiantis iškvietimas pakeičia įmonės apskaitos knygas.

Prisijungimas

Galinis punktas (endpoint) palaiko srauto HTTP (Streamable HTTP) protokolą ir yra autentifikuojamas per „Bearer“ API raktą, gautą skyriuje Pradžia. „Claude Code“ aplinkoje tai atliekama taip:

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

Bet kuris kitas MCP klientas naudoja tokį patį URL adresą ir antraštę. Raktas, turintis teisę *:read, gali iškviesti tik skaitymo operacijas; įrankiai praneša apie trūkstamą teisę grąžindami API 403 klaidą.

Įrankiai

Trys įrankiai apima visas API operacijas:

Įrankis	Ką jis daro
`search_operations`	Suranda operacijas pagal pavadinimo, kelio, santraukos ar aprašymo žodžius, pasirinktinai nurodytame modulyje (`sales`, `bank`, `reports`, ...). Be užklausos pateikiamas modulių sąrašas.
`describe_operation`	Grąžina vienos operacijos metodą, kelią, aprašymą ir JSON užklausos schemą; nustačius `includeResponse: true`, pridedama ir `200` atsako schema.
`call_operation`	Vykdo vieną operaciją su JSON pagrindiniu tekstu (body). Atsako turinys grąžinamas JSON formatu, o `4xx` arba `5xx` atsakymas grąžinamas kaip įrankio klaida su būsenos kodu ir klaidos voku. Pasirenkamas `idempotencyKey` siunčiamas kaip `Idempotency-Key` antraštė, todėl pakartotinis iškvietimas su tuo pačiu raktu pakartoja pirmąjį atsakymą iš naujo nebeatlikdamas veiksmo.

Dažniausiai naudojamos operacijos taip pat pateikiamos kaip tiesioginiai įrankiai su savo užklausų schemomis, todėl asistentas mato jų laukus be papildomos paieškos: 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 ir reports_debt_aging. Kiekvienas įrankis turi MCP anotacijas (readOnlyHint, destructiveHint), kurios nurodo klientui, ar įrankis atlieka įrašymo veiksmus.

Operacijų rodyklė ir schemos sugeneruotos iš to paties OpenAPI aprašo kaip ir API žinynas bei SDK, todėl prie API pridėta operacija automatiškai atsiranda search_operations rezultatuose kartu su ją pridedančia versija. Serverio instrukcijos primena asistentui taikomas taisykles: sumos pateikiamos kaip dešimtainiai tekstiniai laukai (decimal strings), sąrašams naudojami parametrai page, pageSize, sort ir filter, o pateikiant ataskaitą konkrečiai valstybei grąžinama 422 klaida, jei įmonė yra už tos valstybės ribų.