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.

概览

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 分

    请在仓库或注册中心条目中声明许可证。