LayerOne (DocX + Sign)

LayerOne MCP — DocX + Sign

MCP（Model Context Protocol） 服务，可将 LayerOne 的 DocX 和 Sign API 直接提供给 AI Agent（Claude Desktop、ChatGPT、Cursor、Windsurf 等）。

连接后，您的 AI 助手可以使用自然语言：

• DocX — 生成文档（PDF / DOCX）、Factur-X 电子发票（2026 年改革）、上传 / 更新 / 下载 Word 模板、管理模板版本历史记录，以及查看用量配额。
• Sign — 发送 PDF 进行 eIDAS / PAdES 电子签名、跟踪签名状态、通过短信（OTP）验证签署人身份、下载已签署的文档、获取证明证书，以及验证签名的加密完整性。

---

安装

通过 npx 启动服务，无需手动安装。将以下配置块添加到客户端的 MCP 配置中，并填写两个 API 密钥。

Claude Desktop

文件 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

文件 ~/.cursor/mcp.json（或项目的 MCP 设置）——格式相同：

{
  "mcpServers": {
    "layerone": {
      "command": "npx",
      "args": ["-y", "layerone-mcp"],
      "env": {
        "DOCX_API_KEY": "votre_cle_docx",
        "SIGN_API_KEY": "votre_cle_sign"
      }
    }
  }
}

ChatGPT / 其他兼容 MCP 的客户端

大多数 MCP 客户端接受相同的结构（command = npx、 args = ["-y", "layerone-mcp"]、env = 您的两个密钥）。有关配置文件的确切位置，请参阅客户端的 MCP 文档。

---

获取 API 密钥

在 https://dev.layerone.fr 创建免费账户，然后在 “API 密钥” 选项卡中生成密钥：

• 一个 DocX 密钥 → 环境变量 DOCX_API_KEY；
• 一个 Sign 密钥 → 环境变量 SIGN_API_KEY。

免费账户每月提供 20 份 DocX 文档和 10 次 Sign 签名。

密钥绝不会硬编码到代码中：它们只会从 MCP 客户端传入的环境变量中读取。

---

提供的工具

DocX（https://docx.layerone.fr）

工具	描述	Endpoint
docx_render_facturx	生成 Factur-X 发票（PDF/A-3）	POST /render-facturx
docx_render_document	生成 PDF 或 DOCX 文档	POST /render-document
docx_list_templates	列出 / 筛选模板	GET /client/templates
docx_upload_template	上传 Word 模板	POST /client/templates
docx_update_template	更新模板（归档旧版本）	PUT /client/templates/{id}
docx_download_template	下载模板	GET /client/templates/{id}
docx_delete_template	删除模板	DELETE /client/templates/{id}
docx_list_template_versions	列出已归档的版本	GET /client/templates/{id}/versions
docx_download_template_version	下载已归档的版本	GET /client/templates/{id}/versions/{version_id}
docx_restore_template_version	恢复已归档的版本	POST /client/templates/{id}/restore/{version_id}
docx_get_usage_stats	查看配额和用量	GET /usage-stats

Sign (https://sign.layerone.fr)

工具	描述	Endpoint
sign_send_for_signature	发送 PDF 以供签署	POST /v1/documents/send
sign_detect_fields	检测签名字段（[[...]]）	POST /v1/documents/detect-fields
sign_get_document_status	查看签名状态	GET /v1/documents/{id}
sign_download_signed_document	下载已签署的 PDF	GET /v1/documents/{id}/download
sign_send_otp	通过 SMS 发送 OTP 验证码	POST /v1/otp/request
sign_verify_otp	验证 OTP 验证码	POST /v1/otp/verify
sign_validate_signature	验证签名完整性	GET /v1/documents/{id}/validate
sign_get_audit_certificate	获取证明证书	GET /v1/documents/{id}/audit
sign_cancel_document	取消签名请求	DELETE /v1/documents/{id}

文件：提供给工具的模板和 PDF 均采用 base64 编码 （template_base64、pdf_base64）。对于下载，服务端返回的是 摘要（大小 + 截断的 base64 预览），而非完整二进制文件，以避免 对话过载。

---

本地开发

cd integrations/mcp
npm install
npm run build          # compile src/ → dist/
DOCX_API_KEY=... SIGN_API_KEY=... node dist/index.js

服务器根据 MCP 协议通过 stdio（标准输入/输出）进行通信。

---

发布

• npm：通过 .github/workflows/publish.yml 自动发布，并提供来源证明 （由 GitHub release 触发）。
• MCP Registry：清单 server.json（字段 name io.github.GOLayerone/layerone，与 package.json 中的 mcpName 相同）支持通过 mcp-publisher 工具发布到官方注册表。

---

许可证

MIT — © LayerOne。