LayerOne (DocX + Sign)
MCP server for LayerOne DocX (documents & Factur-X) and Sign (e-signature) APIs.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
layerone-mcpclaude mcp add layerone-docx-sign -e 'DOCX_API_KEY=<your docx_api_key>' -e 'SIGN_API_KEY=<your sign_api_key>' -- npx -y layerone-mcp@1.0.0
{
"mcpServers": {
"layerone-docx-sign": {
"command": "npx",
"args": [
"-y",
"layerone-mcp@1.0.0"
],
"env": {
"DOCX_API_KEY": "<your docx_api_key>",
"SIGN_API_KEY": "<your sign_api_key>"
}
}
}
}
Environment variables
DOCX_API_KEYrequired secret DocX API key (documents, PDF, Factur-X). Generate at https://dev.layerone.frSIGN_API_KEYrequired secret Sign API key (eIDAS/PAdES e-signature). Generate at https://dev.layerone.fr
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
LayerOne MCP — DocX + Sign
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 :
- DocX — générer des documents (PDF / DOCX), des factures électroniques Factur-X (réforme 2026), déposer / mettre à jour / télécharger des modèles Word, gérer leur historique de versions, et consulter le quota d'usage.
- Sign — envoyer un PDF à la signature électronique eIDAS / PAdES, suivre son statut, vérifier l'identité du signataire par SMS (OTP), télécharger le document signé, récupérer le certificat de preuve et valider l'intégrité cryptographique de la signature.
Installation
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.
Claude Desktop
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"
}
}
}
}
Cursor
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"
}
}
}
}
ChatGPT / autres clients compatibles MCP
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.
Obtenir les clés API
Créez un compte gratuit sur https://dev.layerone.fr**, puis générez vos clés dans l'onglet **« Clés API » :
- une clé DocX → variable d'environnement
DOCX_API_KEY; - une clé Sign → variable d'environnement
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.
Outils exposés
DocX (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 |
Sign (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.
Développement local
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.
Publication
- npm : publication automatique avec provenance via
.github/workflows/publish.yml(déclenché par une release GitHub). - MCP Registry : le manifeste
server.json(champnameio.github.GOLayerone/layerone, identique aumcpNamedepackage.json) permet la publication au registre officiel via l'outilmcp-publisher.
Licence
MIT — © LayerOne.
Frequently asked questions
What is LayerOne (DocX + Sign)?
MCP server for LayerOne DocX (documents & Factur-X) and Sign (e-signature) APIs.
How do I install LayerOne (DocX + Sign)?
It runs on your machine. In Claude Code: claude mcp add layerone-docx-sign -e 'DOCX_API_KEY=<your docx_api_key>' -e 'SIGN_API_KEY=<your sign_api_key>' -- npx -y layerone-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does LayerOne (DocX + Sign) need an API key?
Yes. It expects DOCX_API_KEY, SIGN_API_KEY, which you set in its configuration.
Is LayerOne (DocX + Sign) open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains LayerOne (DocX + Sign)?
It is published by GOLayerone. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.