layerone-mcp

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 (champ name io.github.GOLayerone/layerone, identique au mcpName de package.json) permet la publication au registre officiel via l'outil mcp-publisher.

Licence

MIT — © LayerOne.