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
| Étape | Service | Ce qu'il faut savoir |
|---|---|---|
| S'authentifier | services.net-entreprises.fr/authentifier/1.0/ | POST en XML avec SIRET, nom, prénom et mot de passe. Renvoie un jeton |
| Déposer | depot.dsnrg.net-entreprises.fr/deposer-dsn/2.0/ | POST du fichier, avec l'en-tête Authorization: DSNLogin jeton=… |
| Lire les retours | consultation.dsnrg.net-entreprises.fr/lister-retours-flux/2.0/ | GET par identifiant de flux. Le bilan est le retour de nature 11 |
| Télécharger | telechargement.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.001doit ê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.
| Risque | Garde-fou dans DSNap |
|---|---|
| Le modèle dépose en réel trop vite | deposer_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 mois | Le journal et la liste des dépôts bloquent le doublon |
| Le mot de passe passe dans la conversation | Saisie sur une page locale, jeton à usage unique, jamais d'argument d'outil |
| Un numéro de sécurité sociale dans une réponse | Masqué 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 paie | Chemins 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
- net-entreprises : l'API DSN et son guide d'implémentation, version 6.9 du 4 septembre 2026
- Model Context Protocol : définition du protocole
- GitHub : code source de DSNap
- net-entreprises : DSN-Val
Le voir tourner.
Installez DSNap dans Claude et essayez la démonstration : elle ne contacte pas net-entreprises.