digisign-mcp

用途

digisign-mcp 是一个 MCP（Model Context Protocol）服务器，用于对接 DigiSign.cz 的数字签名 API。它专为 Claude Code 构建，让用户能够直接在 AI 编程助手中创建、发送和管理数字签名信封（envelope）。

主要能力

该服务器提供两类工具：

• 读取工具：可安全地自动批准。
• 写入工具：建议手动批准，以避免意外操作。

具体工具包括：

• create_envelope：创建草稿信封。
• upload_and_attach_document：上传并附加 PDF 文档。
• add_recipient：添加签署人（使用短信认证时需要手机号码）。
• add_signature_tag：放置签名标签。
• send_envelope：发送信封以供签署。

此外，还涉及取消和删除信封的操作（具体工具名称未在资料中列出）。

使用方式

1. 获取 DigiSign API 密钥

在 DigiSign 仪表板中：设置 > Pro vyvojare > API klice。创建一个 API 密钥对（访问密钥 + 秘密密钥）。

2. 安装依赖

资料中未提供具体的安装命令。

3. 注册到 Claude Code

资料中未提供具体的注册命令。

安全建议

在 ~/.claude/settings.local.json 中将不可逆的写入工具添加到拒绝列表，以确保 Claude Code 在发送、取消或删除信封前提示确认。

安全的准备工具（create_envelope、upload_and_attach_document、add_recipient、add_signature_tag）可以添加到允许列表，因为它们只修改草稿信封。

签名标签定位

有两种在文档上放置签名标签的方法：

基于占位符（推荐）

在文档中添加不可见的文本标记（例如白色文本如 {sign_here}）。DigiSign 会在 PDF 文本层中找到它们，并相对于它们定位签名标签。

重要提示：DigiSign 的占位符正则表达式只允许 [\w\-\{\}\[\]\(\)=,]——不允许空格或变音符号。使用简单的 ASCII 占位符，如 {sign_ceo}、{sign_client}。

定位：bottom_left 将签名框放在占位符文本上方（合同的标准做法，签名位于打印姓名上方）。scale: 70 保持框紧凑。

注意：即使使用占位符定位，documentId 也是必需的。

基于坐标

将标签放置在精确的页面坐标（以点为单位）。资料中未提供具体示例。

基于占位符的方法更稳健——它能适应文档布局变化。

典型工作流程

1. create_envelope — 创建草稿
2. upload_and_attach_document — 附加 PDF
3. add_recipient — 添加签署人（使用短信认证时需要手机号码）
4. add_signature_tag — 放置签名标签
5. send_envelope — 发送以供签署

适用场景

适用于需要在 AI 编程助手（如 Claude Code）中集成 DigiSign.cz 数字签名功能的开发者和团队，用于自动化创建、发送和管理数字签名信封。

限制

• 需要 DigiSign.cz 账户并具有 API 访问权限。
• 需要 Claude Code 或任何兼容 MCP 的客户端。
• 占位符正则表达式限制：不允许空格或变音符号。
• 资料中未提供具体的安装命令和注册命令。
• 资料中未提供基于坐标定位的具体示例。

作者

由 David Simoes / Sounds Good Agency 构建。