MCP server for LayerOne DocX (documents & Factur-X) and Sign (e-signature) APIs.
Runs on your machine from its package; the steps are below.
At most: moves money, runs code or commands, deletes data, or sends messages for you.
Odel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y layerone-mcp
MCP client config
{
"mcpServers": {
"layerone-docx-sign": {
"command": "npx",
"args": [
"-y",
"layerone-mcp"
]
}
}
}Serveur MCP (Model Context Protocol) qui expose les API DocX et Sign de LayerOne directement aux agents IA (Claude Desktop, ChatGPT, Cursor, Windsurf, etc.).
Une fois branché, votre assistant IA peut, en langage naturel :
Le serveur se lance via npx — aucune installation manuelle requise. Ajoutez le bloc
ci-dessous à la configuration MCP de votre client, en renseignant vos deux clés API.
Fichier claude_desktop_config.json :
{
"mcpServers": {
"layerone": {
"command": "npx",
"args": ["-y", "layerone-mcp"],
"env": {
"DOCX_API_KEY": "votre_cle_docx",
"SIGN_API_KEY": "votre_cle_sign"
}
}
}
}
Fichier ~/.cursor/mcp.json (ou réglages MCP du projet) — même format :
{
"mcpServers": {
"layerone": {
"command": "npx",
"args": ["-y", "layerone-mcp"],
"env": {
"DOCX_API_KEY": "votre_cle_docx",
"SIGN_API_KEY": "votre_cle_sign"
}
}
}
}
La plupart des clients MCP acceptent la même structure (command = npx,
args = ["-y", "layerone-mcp"], env = vos deux clés). Reportez-vous à la
documentation MCP de votre client pour l'emplacement exact du fichier de configuration.
Créez un compte gratuit sur https://dev.layerone.fr, puis générez vos clés dans l'onglet « Clés API » :
DOCX_API_KEY ;SIGN_API_KEY.Le compte gratuit offre 20 documents DocX et 10 signatures Sign par mois.
Les clés ne sont jamais écrites en dur dans le code : elles sont lues uniquement depuis les variables d'environnement passées par votre client MCP.
https://docx.layerone.fr)| Outil | Description | Endpoint |
|---|---|---|
docx_render_facturx | Générer une facture Factur-X (PDF/A-3) | POST /render-facturx |
docx_render_document | Générer un document PDF ou DOCX | POST /render-document |
docx_list_templates | Lister / filtrer les modèles | GET /client/templates |
docx_upload_template | Déposer un modèle Word | POST /client/templates |
docx_update_template | Mettre à jour un modèle (archive l'ancien) | PUT /client/templates/{id} |
docx_download_template | Télécharger un modèle | GET /client/templates/{id} |
docx_delete_template | Supprimer un modèle | DELETE /client/templates/{id} |
docx_list_template_versions | Lister les versions archivées | GET /client/templates/{id}/versions |
docx_download_template_version | Télécharger une version archivée | GET /client/templates/{id}/versions/{version_id} |
docx_restore_template_version | Restaurer une version archivée | POST /client/templates/{id}/restore/{version_id} |
docx_get_usage_stats | Consulter le quota et l'usage | GET /usage-stats |
https://sign.layerone.fr)| Outil | Description | Endpoint |
|---|---|---|
sign_send_for_signature | Envoyer un PDF à signer | POST /v1/documents/send |
sign_detect_fields | Détecter les champs de signature ([[...]]) | POST /v1/documents/detect-fields |
sign_get_document_status | Consulter le statut d'une signature | GET /v1/documents/{id} |
sign_download_signed_document | Télécharger le PDF signé | GET /v1/documents/{id}/download |
sign_send_otp | Envoyer un code OTP par SMS | POST /v1/otp/request |
sign_verify_otp | Vérifier le code OTP | POST /v1/otp/verify |
sign_validate_signature | Vérifier l'intégrité de la signature | GET /v1/documents/{id}/validate |
sign_get_audit_certificate | Récupérer le certificat de preuve | GET /v1/documents/{id}/audit |
sign_cancel_document | Annuler une demande de signature | DELETE /v1/documents/{id} |
Fichiers : les modèles et PDF sont fournis aux outils encodés en base64 (
template_base64,pdf_base64). Pour les téléchargements, le serveur renvoie un résumé (taille + aperçu base64 tronqué) plutôt que le binaire complet, afin de ne pas saturer la conversation.
cd integrations/mcp
npm install
npm run build # compile src/ → dist/
DOCX_API_KEY=... SIGN_API_KEY=... node dist/index.js
Le serveur communique sur stdio (entrée/sortie standard) selon le protocole MCP.
.github/workflows/publish.yml (déclenché par une release GitHub).server.json (champ name
io.github.GOLayerone/layerone, identique au mcpName de package.json) permet la
publication au registre officiel via l'outil mcp-publisher.MIT — © LayerOne.