Serveur MCP

Nordlet propose le Model Context Protocol à l'adresse https://api.nordlet.com/mcp. Un assistant IA connecté à ce service peut rechercher dans l'API, lire le schéma de requête de n'importe quelle opération et l'exécuter, en utilisant la même clé d'API, la même entreprise et les mêmes habilitations (scopes) que lors d'une requête directe. Chaque appel d'outil correspond à une requête d'API ordinaire: son authentification, sa limitation de débit (rate limiting) et sa facturation sont gérées de la même manière, et tout appel modificateur a un impact direct sur la comptabilité de l'entreprise.

Connexion

L'endpoint utilise le protocole Streamable HTTP et s'authentifie au moyen d'une clé d'API Bearer obtenue dans le guide Prise en main. Dans Claude Code:

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

Tout autre client MCP utilise la même URL et le même en-tête. Une clé restreinte au scope *:read ne peut exécuter que les opérations de lecture; si un outil tente d'effectuer une autre action, il renvoie l'erreur 403 standard de l'API pour signaler un scope manquant.

Outils

Trois outils couvrent l'ensemble des opérations de l'API:

Outil	Fonction
search_operations	Recherche des opérations à partir de mots-clés présents dans leur nom, leur chemin, leur résumé ou leur description, éventuellement au sein d'un module spécifique (sales, bank, reports, etc.). Sans terme de recherche, l'outil liste l'ensemble des modules.
describe_operation	Renvoie la méthode, le chemin, la description et le schéma de requête JSON d'une opération. Le paramètre includeResponse: true permet d'inclure en plus le schéma de la réponse 200.
call_operation	Exécute une opération dotée d'un corps JSON. Le corps de la réponse est renvoyé au format JSON; en cas d'erreur 4xx ou 5xx, l'outil renvoie une erreur contenant le code de statut ainsi que l'enveloppe d'erreur. Un paramètre optionnel idempotencyKey est transmis via l'en-tête Idempotency-Key, ce qui garantit qu'un appel répété avec la même clé renvoie la réponse initiale sans dupliquer l'effet de l'opération.

Les opérations les plus courantes disposent également d'outils dédiés dotés de leurs propres schémas de requête, ce qui permet à l'assistant d'accéder directement à leurs champs sans recherche préalable: 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 et reports_debt_aging. Chaque outil intègre les annotations MCP requises (readOnlyHint, destructiveHint) pour indiquer au client s'il s'agit d'une opération d'écriture.

L'index des opérations et les schémas sont générés à partir de la même description OpenAPI que la référence de l'API et les kits de développement (SDK). Par conséquent, toute nouvelle opération ajoutée à l'API est immédiatement accessible via search_operations dès sa mise en service. Les instructions du serveur rappellent à l'assistant les conventions en vigueur: les montants sont représentés par des chaînes de caractères décimales, la pagination et le tri des listes s'effectuent via page, pageSize, sort et filter, et toute déclaration fiscale spécifique à un pays renvoie une erreur 422 si elle est appliquée à une entreprise située hors de cette juridiction.