MCP poslužitelj

Nordlet poslužuje Model Context Protocol na adresi https://api.nordlet.com/mcp. Povezani AI asistent može pretraživati API, čitati shemu zahtjeva bilo koje operacije i izvršavati je uz isti API ključ, tvrtku i ovlasti (scopes) kao kod izravnog zahtjeva. Svaki poziv alata predstavlja običan API zahtjev: autentificiran je, podliježe ograničenju broja zahtjeva (rate limiting) i naplaćuje se poput njega, pri čemu svaka operacija izmjene podataka utječe na poslovne knjige tvrtke.

Povezivanje

Krajnja točka (endpoint) podržava Streamable HTTP protokol i autentificira se pomoću Bearer API ključa iz vodiča Početak rada. U alatu Claude Code:

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

Bilo koji drugi MCP klijent koristi istu adresu i zaglavlje. Ključ s ovlastima ograničenim na *:read može pozivati samo operacije čitanja, pri čemu alati vraćaju nedostatak ovlasti kao API pogrešku 403.

Alati

Tri alata obuhvaćaju svaku operaciju unutar API-ja:

Alat	Opis
search_operations	Pronalazi operacije prema ključnim riječima u njihovom nazivu, putanji, sažetku ili opisu, uz mogućnost filtriranja unutar određenog modula (sales, bank, reports, ...). Bez unesenog upita ispisuje popis dostupnih modula.
describe_operation	Vraća metodu, putanju, opis i JSON shemu zahtjeva za pojedinu operaciju; parametar includeResponse: true dodaje i shemu odgovora 200.
call_operation	Izvršava pojedinu operaciju s JSON tijelom zahtjeva. Tijelo odgovora vraća se u JSON formatu, dok se odgovor s statusom 4xx ili 5xx vraća kao pogreška alata koja sadrži statusni kod i omotnicu pogreške. Opcionalni parametar idempotencyKey šalje se kroz zaglavlje Idempotency-Key, čime se ponovljeni poziv s istim ključem oslanja na prvi spremljeni odgovor umjesto ponovnog izvršavanja akcije.

Najčešće korištene operacije ujedno su i izravni alati s vlastitim shemama zahtjeva, što asistentu omogućuje jasan uvid u polja bez potrebe za dodatnim pretraživanjem: 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. Svaki alat sadrži MCP oznake (readOnlyHint, destructiveHint) koje klijentu daju do znanja upisuje li podatke.

Indeks operacija i sheme generiraju se iz iste OpenAPI specifikacije kao i API referenca te SDK-ovi, pa se svaka nova operacija dodana u API automatski prikazuje u alatu search_operations s izdavanjem verzije u kojoj je uvedena. Upute poslužitelja podsjećaju asistenta na konvencije: iznosi su decimalni nizovi znakova, popisi prihvaćaju parametre page, pageSize, sort i filter, dok izvješća specifična za pojedinu državu vraćaju status 422 za tvrtke registrirane izvan te jurisdikcije.