LayerOne (DocX + Sign)

io.github.GOLayerone由 GitHub 帳號 GOLayerone 發布v1.0.0更新於 Oct 24, 2026

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

已驗證STDIO僅桌面效率與工作流檔案與儲存商業與電商

概覽

AI 產生的概覽

LayerOne MCP 讓 AI 助理透過 LayerOne 的 DocX 與 Sign API 產生 PDF/DOCX 文件與 Factur-X 發票，並送出 PDF 進行 eIDAS/PAdES 電子簽章。

可以做什麼
  • 依範本產生文件與 Factur-X（PDF/A-3）發票
  • 列出、上傳、更新、下載、刪除 Word 範本並管理版本歷程，查詢用量配額
  • 送出 PDF 進行 eIDAS/PAdES 簽章、偵測簽章欄位、查詢狀態、下載已簽署檔案、取消簽章請求
  • 以簡訊 OTP 驗證簽署人身分，取得稽核憑證或驗證簽章完整性
  • 檔案以 base64 傳入；下載時回傳大小摘要與截斷的預覽，而非完整二進位內容
適用情境
適合讓助理依自有 Word 範本產生發票或業務文件，或在對話中完成電子簽章流程（送出、追蹤、驗證、下載）。
執行需求
透過 npx 以 stdio 在本機執行（需要 Node.js），須在用戶端的 MCP 設定檔中設定。需要免費的 LayerOne 帳號，並以環境變數提供兩組 API 金鑰：DOCX_API_KEY 與 SIGN_API_KEY。需要連線至 LayerOne 的 DocX 與 Sign 服務。
安裝前請注意
需要兩組 API 金鑰（DOCX_API_KEY、SIGN_API_KEY），可存取你的 LayerOne 帳號，請勿放入共用設定。工具會建立、更新、刪除與還原範本，送出待簽文件、發送簡訊 OTP 驗證碼並取消簽章請求，操作會造成真實的外部影響。文件與 PDF 會傳送至 LayerOne 伺服器，免費額度為每月 20 份文件與 10 次簽章。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 LayerOne (DocX + Sign)，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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 :

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 :

json
{  "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

bash
cd integrations/mcpnpm installnpm 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.

來源：README.md，提交 6d33eb6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。