MCP server

Nordlet pakub Model Context Protocol tuge aadressil https://api.nordlet.com/mcp. Sellega ühendatud tehisintellekti assistent saab otsida API-st teavet, lugeda mis tahes toimingu päringuskeemi ning seda käivitada, kasutades sama API-võtit, ettevõtet ja õigusi (scopes) nagu otsepäringu korral. Iga tööriista kutse on tavaline API-päring: seda autentitakse, sellele kehtivad päringupiirangud (rate limits) ning seda mõõdetakse samamoodi ja andmeid muutev kutse muudab ettevõtte raamatupidamiskirjeid.

Ühendamine

Lõpp-punkt kasutab voogedastatavat HTTP-d (Streamable HTTP) ja seda autenditakse Bearer API-võtmega, mille leiate juhendist Alustamine. Claude Code'is käib see nii:

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

Iga teine MCP-klient kasutab sama URL-i ja päist. Õigusega *:read piiratud võti saab käivitada ainult lugemistoiminguid; tööriistad annavad puuduvast õigusest teada API 403 veaga.

Tööriistad

Kolm tööriista katavad API kõik toimingud:

Tööriist	Mida see teeb
search_operations	Leiab toimingud nimes, tees, kokkuvõttes või kirjelduses olevate sõnade järgi, soovi korral kindla mooduli piires (sales, bank, reports, ...). Ilma päringuta loetleb see moodulid.
describe_operation	Tagastab ühe toimingu meetodi, tee, kirjelduse ja JSON-päringuskeemi; parameeter includeResponse: true lisab ka 200 vastuse skeemi.
call_operation	Käivitab ühe toimingu JSON-korpusega (body). Vastuse sisu tagastatakse JSON-ina; 4xx või 5xx vastus tagastatakse tööriista veana koos staatuskoodi ja veaümbrisega. Valikuline idempotencyKey saadetakse päisena Idempotency-Key, nii et sama võtmega korduv kutse taasesitab esimese vastuse ilma toimingut uuesti tegemata.

Enimkasutatavad toimingud on saadaval ka otsetööriistadena koos oma päringuskeemidega, mistõttu assistent näeb nende välju ilma eraldi otsinguta: 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 ja reports_debt_aging. Iga tööriist sisaldab MCP märkusi (readOnlyHint, destructiveHint), mis annavad kliendile teada, kas tegemist on andmeid muutva toiminguga.

Toimingute loend ja skeemid genereeritakse samast OpenAPI kirjeldusest, mida kasutavad API viide ja SDK-d, mistõttu API-le lisatud toiming ilmub funktsioonis search_operations samal ajal selle väljalaskega. Serveri juhised tuletavad assistendile meelde kokkulepitud reegleid: summad on kümnendmurruna esitatud tekstistringid, loendid kasutavad parameetreid page, pageSize, sort ja filter, ning riigipõhine aruandlus vastab veaga 422, kui ettevõte ei asu vastavas riigis.