MCP-server

Nordlet biedt het Model Context Protocol aan op https://api.nordlet.com/mcp. Een AI-assistent die hiermee is verbonden kan de API doorzoeken, het aanvraagschema (request schema) van elke bewerking inzien en deze aanroepen, met dezelfde API-sleutel, administratie en toegangsrechten (scopes) als bij een rechtstreeks verzoek. Elke toolaanroep is een gewoon API-verzoek: het wordt op dezelfde manier geverifieerd, gelimiteerd qua frequentie (rate limited) en geregistreerd, en een muterende aanroep wijzigt de boeking van de administratie.

Verbinden

Het eindpunt ondersteunt Streamable HTTP en wordt geverifieerd met de Bearer API-sleutel uit Aan de slag. In Claude Code:

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

Elke andere MCP-client gebruikt dezelfde URL en header. Een sleutel met de scope *:read kan enkel de leestaken uitvoeren; de tools retourneren een ontbrekende scope als de 403-fout van de API.

Tools

Drie tools dekken elke bewerking van de API af:

Tool	Wat het doet
search_operations	Zoekt bewerkingen op trefwoorden in hun naam, pad, samenvatting of beschrijving, optioneel binnen één module (sales, bank, reports, ...). Zonder zoekopdracht worden de modules weergegeven.
describe_operation	Retourneert de methode, het pad, de beschrijving en het JSON-aanvraagschema van één bewerking; includeResponse: true voegt het schema van de 200-respons toe.
call_operation	Voert één bewerking uit met een JSON-body. De responsbody wordt geretourneerd als JSON; een 4xx- of 5xx-antwoord komt terug als een toolfout met de status en de foutenenvelope (error envelope). Een optionele idempotencyKey wordt verzonden als de Idempotency-Key-header, zodat een herhaalde aanroep met dezelfde sleutel het eerste antwoord opnieuw afspeelt in plaats van het effect te herhalen.

De meest gebruikte bewerkingen zijn tevens rechtstreekse tools met hun eigen aanvraagschema's, zodat een assistent de velden kan inzien zonder opzoeking: 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 en reports_debt_aging. Elke tool bevat de MCP-annotaties (readOnlyHint, destructiveHint) die de client vertellen of er schrijfhandelingen worden verricht.

De bewerkingenindex en de schema's worden gegenereerd vanuit dezelfde OpenAPI-beschrijving als de API-referentie en de SDK's, waardoor een aan de API toegevoegde bewerking verschijnt in search_operations zodra deze wordt vrijgegeven. De instructies van de server herinneren de assistent aan de standaarden: bedragen zijn decimale tekenreeksen, lijsten accepteren page, pageSize, sort en filter, en een aangifte voor een specifiek land retourneert 422 voor een administratie buiten dat land.