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.