内容
# DigiSign MCP 服务器
DigiSign.cz 数字签名 API 的 MCP 服务器。为 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 构建。
直接从 AI 编码助手创建、发送和管理数字签名信封。
[](https://glama.ai/mcp/servers/davidsimoes/digisign-mcp)
## 设置
### 1. 获取 DigiSign API 密钥
在您的 DigiSign 仪表板中：**设置 > Pro vyvojare > API klice**。创建一对 API 密钥（访问密钥 + 秘密密钥）。
### 2. 安装依赖项
```bash
git clone https://github.com/davidsimoes/digisign-mcp.git
cd digisign-mcp
npm install
```
### 3. 注册 Claude Code
```bash
claude mcp add digisign \
-e DIGISIGN_ACCESS_KEY=您的访问密钥 \
-e DIGISIGN_SECRET_KEY=您的秘密密钥 \
-- node /path/to/digisign-mcp/src/index.js
```
## 工具
### 读取工具（安全自动批准）
| 工具 | 描述 |
|------|-------------|
| `list_envelopes` | 列出信封，可选状态/页面筛选 |
| `get_envelope` | 获取详细的信封信息（状态、收件人、文件） |
| `list_documents` | 列出附加到信封的文件 |
| `list_recipients` | 列出收件人及其签名状态 |
| `list_tags` | 列出放置在文件上的签名/表单标签 |
| `get_download_url` | 获取已签名文件的临时下载 URL |
| `get_account` | 获取账户信息（积分、计划、使用情况） |
### 编写工具（建议手动批准）
| 工具 | 描述 |
|------|-------------|
| `create_envelope` | 创建新的草稿信封 |
| `upload_and_attach_document` | 上传 PDF/DOCX 并附加到信封 |
| `add_recipient` | 添加签名者、审批者或抄送收件人 |
| `add_signature_tag` | 放置签名/表单标签（占位符或坐标定位） |
| `send_envelope` | 发送信封进行签名（向所有收件人发送电子邮件） |
| `cancel_envelope` | 取消已发送的信封（通知签名者） |
| `delete_envelope` | 删除草稿信封 |
| `discard_envelope` | 丢弃草稿信封（当 API 密钥缺乏删除权限时使用） |
## 安全建议
在 `~/.claude/settings.local.json` 中将不可逆的写入工具添加到拒绝列表：
```json
{
"permissions": {
"deny": [
"mcp__digisign__send_envelope",
"mcp__digisign__cancel_envelope",
"mcp__digisign__delete_envelope",
"mcp__digisign__discard_envelope"
]
}
}
```
这确保 Claude Code 在发送、取消或删除信封之前提示确认。
安全准备工具（`create_envelope`、`upload_and_attach_document`、`add_recipient`、`add_signature_tag`）可以添加到允许列表，因为它们只修改草稿信封。
## 签名标签定位
在文件上放置签名标签的两种方法：
### 基于占位符（推荐）
在文件中添加不可见的文本标记（例如，白色文本 `{sign_here}`）。DigiSign 在 PDF 文本层中找到它们，并相对于它们定位签名标签。
```
add_signature_tag(
envelopeId: "...",
recipientId: "...",
documentId: "...",
placeholder: "{sign_here}",
positioning: "bottom_left",
scale: 70
)
```
**重要**：DigiSign 的占位符正则表达式仅允许 `[\w\-\{\}\[\]\(\)=,]` — 不允许空格或变音符号。使用简单的 ASCII 占位符，如 `{sign_ceo}`、`{sign_client}`。
**定位**：`bottom_left` 将签名框放在占位符文本上方（合同的标准，签名位于打印名称上方）。`scale: 70` 保持框紧凑。
**注意**：即使使用占位符定位，也需要 `documentId`。
### 基于坐标
在精确的页面坐标（以点为单位）放置标签：
```
add_signature_tag(
envelopeId: "...",
recipientId: "...",
documentId: "...",
page: 5,
xPosition: 320,
yPosition: 680
)
```
基于占位符的方法更强大 — 它可以承受文档布局变化。
## 典型工作流程
1. `create_envelope` — 创建草稿
2. `upload_and_attach_document` — 附加 PDF
3. `add_recipient` — 添加签名者（需要手机号码进行 SMS 身份验证）
4. `add_signature_tag` — 放置签名标签
5. `send_envelope` — 发送签名
## 要求
- Node.js 18+
- DigiSign.cz 账户，启用 API 访问
- Claude Code（或任何 MCP 兼容客户端）
## 许可证
MIT
---
由 [David Simoes](https://github.com/davidsimoes) / [Sounds Good Agency](https://soundsgood.agency) 构建
