English Français العربية

LayerOne (DocX + Sign)

السجل الرسمي الإنتاجية

MCP server for LayerOne DocX (documents & Factur-X) and Sign (e-signature) APIs.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package layerone-mcp
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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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>"
            }
        }
    }
}

متغيرات البيئة

  • DOCX_API_KEY إلزامي سري DocX API key (documents, PDF, Factur-X). Generate at https://dev.layerone.fr
  • SIGN_API_KEY إلزامي سري Sign API key (eIDAS/PAdES e-signature). Generate at https://dev.layerone.fr

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. LayerOne MCP — DocX + Sign
  2. Installation
  3. Obtenir les clés API
  4. Outils exposés
  5. Développement local
  6. Publication
  7. Licence

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)
OutilDescriptionEndpoint
docx_render_facturxGénérer une facture Factur-X (PDF/A-3)POST /render-facturx
docx_render_documentGénérer un document PDF ou DOCXPOST /render-document
docx_list_templatesLister / filtrer les modèlesGET /client/templates
docx_upload_templateDéposer un modèle WordPOST /client/templates
docx_update_templateMettre à jour un modèle (archive l'ancien)PUT /client/templates/{id}
docx_download_templateTélécharger un modèleGET /client/templates/{id}
docx_delete_templateSupprimer un modèleDELETE /client/templates/{id}
docx_list_template_versionsLister les versions archivéesGET /client/templates/{id}/versions
docx_download_template_versionTélécharger une version archivéeGET /client/templates/{id}/versions/{version_id}
docx_restore_template_versionRestaurer une version archivéePOST /client/templates/{id}/restore/{version_id}
docx_get_usage_statsConsulter le quota et l'usageGET /usage-stats
Sign (https://sign.layerone.fr)
OutilDescriptionEndpoint
sign_send_for_signatureEnvoyer un PDF à signerPOST /v1/documents/send
sign_detect_fieldsDétecter les champs de signature ([[...]])POST /v1/documents/detect-fields
sign_get_document_statusConsulter le statut d'une signatureGET /v1/documents/{id}
sign_download_signed_documentTélécharger le PDF signéGET /v1/documents/{id}/download
sign_send_otpEnvoyer un code OTP par SMSPOST /v1/otp/request
sign_verify_otpVérifier le code OTPPOST /v1/otp/verify
sign_validate_signatureVérifier l'intégrité de la signatureGET /v1/documents/{id}/validate
sign_get_audit_certificateRécupérer le certificat de preuveGET /v1/documents/{id}/audit
sign_cancel_documentAnnuler une demande de signatureDELETE /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.

الأسئلة الشائعة

ما هو LayerOne (DocX + Sign)؟

MCP server for LayerOne DocX (documents & Factur-X) and Sign (e-signature) APIs.

كيف أثبّت LayerOne (DocX + Sign)؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج LayerOne (DocX + Sign) إلى مفتاح API؟

نعم. يتطلب DOCX_API_KEY, SIGN_API_KEY، وتضبطها في إعداداته.

هل LayerOne (DocX + Sign) مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون LayerOne (DocX + Sign)؟

ينشره GOLayerone. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.