Accueil › Guides › Serveur MCP et API DSN

Serveur MCP et API DSN : comment déposer sur net-entreprises

Par Etienne Bourrinet, président de SASU EBO, qui fait lui-même sa paie et ses DSN. Mis à jour le 10 novembre 2026.

Cet article s'adresse aux développeurs. Il montre comment un serveur MCP dépose une DSN par l'API de net-entreprises, à partir du code public de DSNap. Il ne remplace pas le guide d'implémentation officiel, qui fait foi.

Ce qu'est l'API DSN

net-entreprises la définit ainsi : « L'API DSN est l'interface qui permet au logiciel de paie du déclarant (ou au concentrateur) de s'authentifier directement sur le point de dépôt des déclarations sociales nominatives sans avoir à naviguer sur net-entreprises.fr ». Le GIP-MDS en publie les spécifications : « à implémenter par chaque éditeur dans son logiciel de paie ». Le guide en vigueur est la version 6.9 du 4 septembre 2026.

Les quatre étapes

ÉtapeServiceCe qu'il faut savoir
S'authentifierservices.net-entreprises.fr/authentifier/1.0/POST en XML avec SIRET, nom, prénom et mot de passe. Renvoie un jeton
Déposerdepot.dsnrg.net-entreprises.fr/deposer-dsn/2.0/POST du fichier, avec l'en-tête Authorization: DSNLogin jeton=…
Lire les retoursconsultation.dsnrg.net-entreprises.fr/lister-retours-flux/2.0/GET par identifiant de flux. Le bilan est le retour de nature 11
Téléchargertelechargement.dsnrg.net-entreprises.fr/Le contenu de chaque retour

Un jeton expiré répond 401 : DSNap se réidentifie une fois, puis recommence. La liste des dépôts d'une période passe par lister-depots/2.0/. C'est elle qui permet de retrouver un dépôt fait hors de l'outil.

Si la réponse se perd

Le pire cas : le fichier part, puis net-entreprises répond par une erreur serveur. Le dépôt a peut-être été reçu. Redéposer créerait un doublon. Si la réponse se perd ainsi, DSNap note le dépôt comme incertain, cherche le flux dans la liste des dépôts, et dit de ne pas redéposer tant que ce n'est pas tiré au clair.

Test, puis réel

Le fichier de test et le fichier réel ne diffèrent que par la rubrique S10.G00.00.005 : 01 pour le test, 02 pour le réel. Le test est contrôlé mais transmis à aucun organisme. Un serveur MCP doit donc fabriquer les deux d'un coup, déposer le test, lire le bilan, et ne proposer le réel qu'après un bilan conforme.

Les pièges du fichier

  • Encodage : net-entreprises attend de l'ISO-8859-1, pas de l'UTF-8.
  • Total de lignes : la rubrique S90.G00.90.001 doit être juste. Modifier le fichier à la main la fausse.
  • Adresse de l'entreprise : sans elle, rejet bloquant.
  • Norme : les tables de codes changent. DSNap les télécharge depuis net-entreprises et s'en sert pour contrôler chaque fichier.

Ce que le protocole MCP change

L'API est faite pour un logiciel qui suit un chemin fixe. Avec MCP, c'est un modèle de langage qui choisit l'outil. Le serveur doit donc se protéger contre un appel de travers.

RisqueGarde-fou dans DSNap
Le modèle dépose en réel trop vitedeposer_dsn en réel exige la confirmation explicite de l'utilisateur, sauf s'il a choisi le dépôt automatique
Deux dépôts pour le même moisLe journal et la liste des dépôts bloquent le doublon
Le mot de passe passe dans la conversationSaisie sur une page locale, jeton à usage unique, jamais d'argument d'outil
Un numéro de sécurité sociale dans une réponseMasqué dans toutes les sorties
Un lien de retour piégéTéléchargement limité aux adresses de net-entreprises
Un fichier hors du dossier de paieChemins limités au dossier de paie

Pourquoi un serveur local, en stdio

DSNap se lance comme un programme local, sans dépendance, et parle au client par l'entrée et la sortie standard. Le client lit la liste des outils, puis les appelle. Résultat : le mot de passe reste dans le trousseau du système, et les fichiers restent dans le dossier de paie. Le coût : il faut un client capable de lancer un programme, et chaque ordinateur doit être configuré.

Un détail qui compte : certains clients ne transmettent au modèle que les données structurées d'un résultat d'outil. DSNap recopie donc son message en tête de structuredContent, en plus de content.

Lire le code

Le code est public sur GitHub. Le client net-entreprises est dans server/lib/netentreprises.js. Il tient en moins de 300 lignes, sans dépendance. Pour le contexte d'ensemble, lisez la page MCP DSN.

Questions fréquentes

Faut-il un agrément pour utiliser l'API DSN ?

Le guide d'implémentation de net-entreprises fait foi. L'authentification se fait avec les identifiants du déclarant. DSNap n'a pas d'agrément à faire valoir.

Où trouver la documentation de l'API DSN ?

Sur la page API DSN de net-entreprises, avec le guide d'implémentation à télécharger.

Peut-on tester sans déposer en réel ?

Oui : un dépôt de test est contrôlé et transmis à aucun organisme. DSNap a aussi un mode démonstration, qui ne contacte pas net-entreprises.

Pourquoi pas un serveur MCP distant ?

Il devrait détenir le mot de passe net-entreprises et le numéro de sécurité sociale. DSNap préfère les garder sur l'ordinateur.

Sources

Le voir tourner.

Installez DSNap dans Claude et essayez la démonstration : elle ne contacte pas net-entreprises.