MCP-Server

Nordlet stellt das Model Context Protocol unter https://api.nordlet.com/mcp bereit. Ein damit verbundenes KI-Assistentensystem kann die API durchsuchen, das Anfrageschema jeder Operation auslesen und diese aufrufen, und das mit demselben API-Schlüssel, denselben Unternehmensdaten und denselben Berechtigungen (Scopes) wie bei einer direkten Anfrage. Jeder Tool-Aufruf ist eine ganz normale API-Anfrage: Sie wird wie eine solche authentifiziert, ratenlimitiert und abgerechnet, und ein schreibender Aufruf ändert die Bücher des Unternehmens.

Verbinden

Der Endpunkt unterstützt Streamable HTTP und wird mit dem Bearer-API-Schlüssel aus den Ersten Schritten authentifiziert. In Claude Code:

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

Jeder andere MCP-Client verwendet dieselbe URL und denselben Header. Ein auf *:read eingeschränkter Schlüssel kann ausschließlich Leseoperationen aufrufen; die Tools melden fehlende Berechtigungen als 403-Fehler der API.

Tools

Drei Tools decken sämtliche Operationen der API ab:

Tool	Funktion
search_operations	Findet Operationen anhand von Begriffen in deren Namen, Pfad, Zusammenfassung oder Beschreibung, optional innerhalb eines bestimmten Moduls (sales, bank, reports, ...). Ohne Suchbegriff werden die Module aufgelistet.
describe_operation	Gibt die Methode, den Pfad, die Beschreibung und das JSON-Anfrageschema einer Operation zurück; includeResponse: true fügt das Schema der 200-Antwort hinzu.
call_operation	Führt eine Operation mit einem JSON-Body aus. Der Antwort-Body wird als JSON zurückgegeben; eine 4xx- oder 5xx-Antwort wird als Tool-Fehler samt Statuscode und dem Fehler-Envelope ausgegeben. Ein optionaler idempotencyKey wird als Idempotency-Key-Header übermittelt, sodass ein wiederholter Aufruf mit demselben Schlüssel die erste Antwort wiedergibt, statt die Ausführung zu wiederholen.

Die am häufigsten genutzten Operationen stehen zudem als direkte Tools mit eigenen Anfrageschlüsseln zur Verfügung, sodass ein Assistent deren Felder ohne vorherige Suche einsehen kann: 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 und reports_debt_aging. Jedes Tool verfügt über die entsprechenden MCP-Annotationen (readOnlyHint, destructiveHint), die dem Client mitteilen, ob es schreibende Aktionen ausführt.

Der Operationsindex und die Schemas werden aus derselben OpenAPI-Beschreibung generiert wie die API-Referenz und die SDKs. Eine neu zur API hinzugefügte Operation ist somit ab dem Release, in dem sie erscheint, auch über search_operations verfügbar. Die Anweisungen des Servers erinnern den Assistenten an die geltenden Konventionen: Beträge werden als Dezimalstrings übergeben, Listen unterstützen page, pageSize, sort und filter, und länderspezifische Meldungen antworten mit 422, falls das Unternehmen in einem anderen Land ansässig ist.