MCP þjónn

Nordlet býður upp á Model Context Protocol á slóðinni https://api.nordlet.com/mcp. Gervigreindaraðstoðarmaður sem er tengdur þjónustunni getur leitað í API, lesið beiðnaskema (request schema) fyrir hvaða aðgerð sem er og kallað í hana, með sömu API lyklum, fyrirtæki og heimildum (scopes) og venjuleg beiðni. Hvert tólkall er hefðbundin API beiðni: hún er auðkennd, takmörkuð af álagsþröskuldi (rate limited) og mæld eins og aðrar beiðnir, og breytingakall breytir bókhaldi fyrirtækisins.

Tenging

Endapunkturinn styður Streamable HTTP og notar Bearer API lykil til auðkenningar frá Fyrstu skrefunum. Í Claude Code:

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

Hvaða annar MCP biðlari sem er notar sömu slóð og haus. Lykill sem hefur heimildina *:read getur eingöngu kallað í lestraraðgerðir; tólin tilkynna um vantar heimild sem 403 villu frá API.

Tólin

Þrjú tól ná yfir allar aðgerðir API-sins:

Tól	Lýsing á virkni
search_operations	Finnur aðgerðir eftir leitarorðum í nafni þeirra, slóð, samantekt eða lýsingu, og mákorða eftir einum kerfiseiningu (sales, bank, reports, ...). Ef engin leitarorð eru gefin upp birtir það listann yfir kerfiseiningar.
describe_operation	Skilar aðferð (method), slóð, lýsingu og JSON beiðnaskema einnar aðgerðar; includeResponse: true bætir við skema fyrir 200 svarið.
call_operation	Framkvæmir eina aðgerð með JSON búk (body). Svarbúkurinn skilar sér sem JSON; 4xx eða 5xx svar skilar sér sem tólamistök ásamt stöðukóða og villuumbúðum. Hægt er að senda valfrjálst idempotencyKey sem Idempotency-Key haus, þannig að endurtekið kall með sama lykli skilar fyrsta svarinu í stað þess að endurtaka aðgerðina.

Mest notaðar aðgerðir eru einnig bein tól með sín eigin beiðnaskemur, þannig að aðstoðarmaðurinn sér reitina án þess að þurfa að fletta þeim upp: 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 og reports_debt_aging. Hvert tól er með MCP-tilvísunum (readOnlyHint, destructiveHint) sem segja biðlaranum til um hvort það skrifi gögn.

Yfirlit yfir aðgerðir og skemur eru útbúin út frá sömu OpenAPI lýsingu og API tilvísunin og hugbúnaðarsett (SDK), þannig að aðgerð sem er bætt við API birtist í search_operations samhliða þeirri útgáfu sem bætir henni við. Leiðbeiningar þjónsins minna aðstoðarmanninn á starfsvenjur: fjárhæðir eru tugabrotastrengir, listar taka við page, pageSize, sort og filter, og skattskýrsluskil fyrir tiltekið land skila 422 fyrir fyrirtæki sem eru utan þess lands.