Serverul MCP

Nordlet oferă protocolul Model Context Protocol la adresa https://api.nordlet.com/mcp. Un asistent AI conectat la acesta poate căuta în API, poate citi schema cererii pentru orice operațiune și o poate apela, utilizând aceeași cheie API, companie și aceleași permisiuni (scopes) ca în cazul unei cereri directe. Fiecare apel de unealtă este o cerere API obișnuită: este autenticată, supusă limitării de frecvență (rate limit) și contorizată ca atare, iar un apel care modifică datele va schimba registrele contabile ale companiei.

Conectare

Endpoint-ul utilizează protocolul HTTP Streaming (Streamable HTTP) și este autentificat cu ajutorul cheii API de tip Bearer din secțiunea Noțiuni de bază. În Claude Code:

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

Orice alt client MCP folosește aceeași adresă URL și același antet (header). O cheie cu permisiunea *:read poate apela doar operațiunile de citire; uneltele raportează lipsa unei permisiuni sub forma erorii 403 a API-ului.

Unelte (Tools)

Trei unelte acoperi toate operațiunile API-ului:

Unealtă	Ce face
search_operations	Găsește operațiuni după cuvinte din denumire, cale, rezumat sau descriere, opțional în cadrul unui singur modul (sales, bank, reports, ...). Fără un termen de căutare, afișează lista modulelor.
describe_operation	Returnează metoda, calea, descrierea și schema JSON a cererii pentru o operațiune; parametrul includeResponse: true adaugă schema răspunsului 200.
call_operation	Execută o operațiune cu un corp (body) în format JSON. Corpul răspunsului este returnat în format JSON; un răspuns de tip 4xx sau 5xx este returnat ca eroare a uneltei, incluzând codul de stare și plicul de eroare. Un parametru opțional idempotencyKey este trimis ca antet Idempotency-Key, astfel încât un apel repetat cu aceeași cheie va reda primul răspuns în loc să repete efectul.

Cele mai utilizate operațiuni sunt, de asemenea, unelte directe cu propriile scheme de cerere, astfel încât un asistent le poate vedea câmpurile fără a fi nevoie de o căutare prealabilă: 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 și reports_debt_aging. Fiecare unealtă conține adnotările MCP corespunzătoare (readOnlyHint, destructiveHint), care indică clientului dacă operațiunea efectuează scrieri.

Indexul operațiunilor și schemele sunt generate din aceeași descriere OpenAPI ca și referința API și kiturile SDK, prin urmare, o operațiune adăugată în API va apărea în search_operations odată cu lansarea care o include. Instrucțiunile serverului îi reamintesc asistentului convențiile utilizate: sumele sunt reprezentate ca șiruri de caractere decimale (decimal strings), listele acceptă parametrii page, pageSize, sort și filter, iar o declarație fiscală specifică unei țări va returna codul 422 pentru o companie care nu își desfășoară activitatea în acea țară.