MCP strežník

Povežite Claude Code, Claude Desktop ali kateri koli odjemalec MCP z API-jem Nordlet z enim ključem API.

Nordlet omogoča dostop do protokola Model Context Protocol na naslovu https://api.nordlet.com/mcp. Nanj povezani pomočnik z umetno inteligenco lahko išče po API-ju, bere shemo zahtev posameznih operacij in jih kliče z istim ključem API, podjetjem in obsegi pooblastil (scopes) kot pri neposrednem zahtevku. Vsak klic orodja je običajen zahtevek API: zanj velja preverjanje pristnosti, omejevanje pogostosti (rate limiting) in obračunavanje kot za vsakega drugega, klici s spremembami podatkov pa vplivajo na poslovne knjige podjetja.

Povezava

Končna točka podpira protokol Streamable HTTP, avtentikacija pa poteka s ključem API Bearer iz navodil Začetek uporabe. V orodju Claude Code:

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

Vsak drug odjemalec MCP uporablja enak URL in glavo. Ključ z obsegom *:read lahko kliče samo operacije za branje, pri čemer orodja manjkajoči obseg sporočijo kot napako 403 API-ja.

Orodja

Vse operacije API-ja pokrivajo tri orodja:

Orodje	Kaj počne
`search_operations`	Poišče operacije glede na besede v njihovem imenu, poti, povzetku ali opisu, po želji znotraj določenega modula (`sales`, `bank`, `reports` itd.). Brez poizvedbe izpiše sezname modulov.
`describe_operation`	Vrne metodo, pot, opis in shemo zahtev JSON posamezne operacije; z nastavitvijo `includeResponse: true` doda še shemo odziva `200`.
`call_operation`	Izvede eno operacijo s telesom JSON. Telo odziva se vrne v obliki JSON, odziv `4xx` ali `5xx` pa se vrne kot napaka orodja, ki vključuje status in ovojnico napake. Neobvezen parameter `idempotencyKey` se pošlje v glavi `Idempotency-Key`, zato ponovljen klic z istim ključem vrne prvotni odziv, ne da bi ponovil učinek.

Najbolj uporabljane operacije so na voljo tudi kot neposredna orodja z lastnimi shemami zahtev, zato jih pomočnik vidi brez predhodnega poizvedovanja: 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 in reports_debt_aging. Vsako orodje vsebuje ustrezne opombe MCP (readOnlyHint, destructiveHint), ki odjemalcu povedo, ali orodje zapisuje podatke.

Kazalo operacij in sheme so ustvarjeni iz istega opisa OpenAPI kot referenca API-ja in kompleti SDK, zato je operacija, dodana v API, na voljo v orodju search_operations takoj ob izdaji. Navodila strežnika pomočnika spomnijo na dogovore: zneski so decimalni nizi, seznami sprejemajo parametre page, pageSize, sort in filter, poročanje za posamezno državo pa vrne napako 422, če podjetje ni iz te države.