AddSign

addsign-mcp

适用于 AddSign 的 MCP 服务 — 让 AI Agent 发送文档以供签署、跟踪签署状态、提醒签署人，并下载可验证哈希的已签名 PDF。

本服务在设计上无状态：只使用你的 API 密钥调用 AddSign 的公开 v1 API。不访问数据库，不共享密钥。在 addsign.io/settings/api 撤销密钥后，集成会立即失效。

设置

1. 在 addsign.io → Settings → API Keys 创建 API 密钥（所有套餐均免费；Free 套餐每月包含 8 份文档）。
2. 将其设置为环境变量 — 切勿将其写入提示词或提交到 git 的配置中：

export ADDSIGN_API_KEY=sk_...

Claude Code

claude mcp add addsign --env ADDSIGN_API_KEY=sk_... -- npx -y addsign-mcp

（npm 包发布之前，请改为指向本地检出目录： claude mcp add addsign --env ADDSIGN_API_KEY=sk_... -- node /path/to/simple-sign/mcp/dist/index.js）

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "addsign": {
      "command": "node",
      "args": ["/path/to/simple-sign/mcp/dist/index.js"],
      "env": { "ADDSIGN_API_KEY": "sk_..." }
    }
  }
}

环境变量

变量	必填	默认值	用途
ADDSIGN_API_KEY	是	—	你的 AddSign API 密钥（sk_...）
ADDSIGN_BASE_URL	否	https://addsign.io	指向其他部署

工具

工具	类型	功能
list_templates	读取	模板、每个模板需要的签署人角色，以及字段摘要
send_for_signature	写入	根据模板创建文档并通过电子邮件发送给签署人；通过 request_id 实现幂等
check_status	读取	文档和每位签署人的状态，以及近期审计事件
download_signed	读取	5 分钟有效的已签名 URL，以及用于验证的台账 SHA-256
remind	写入	提醒待签署人（服务端每位签署人有 4 小时冷却时间）
list_documents	读取	可按状态筛选的分页文档列表

不提供破坏性工具：Agent 无法通过此服务取消或删除法律文档。

典型的 Agent 工作流

list_templates                      → find "Contract to Lease", roles: [tenant_1, tenant_2]
send_for_signature {template_id,
  signers: [Artem…, Valeria…],
  request_id: <uuid>}               → document_id, status: pending, usage 3/8
check_status {document_id}          → Artem signed, Valeria viewed
remind {document_id, valeria@…}     → reminded (or skipped: reminded_recently)
download_signed {document_id}       → url + sha256 → fetch, verify, file it

错误语义

每个 AddSign 错误都包含稳定的 error_code；此服务会为 Agent 附上相应的后续操作。最重要的两种错误：

• rate_limited（429）— 等待 retry_after 秒后重试。
• plan_limit_reached（402）— 绝不重试；月度上限会在每月 1 日重置，或者由用户升级套餐。

开发

cd mcp
npm install
npm run build     # → dist/index.js
ADDSIGN_API_KEY=sk_... node dist/index.js