@sumosign/mcp

这是一个 MCP 服务器，通过 stdio 将 SumoSign 签名 API 暴露给 AI 代理（Claude、ChatGPT、Copilot 以及任何兼容 MCP 的客户端）。

API 密钥认证的是代理，而非签署人。它永远无法完成签名——签名始终由人类接收者通过其电子邮件中的一次性链接完成，并伴有同意采集和仅追加的审计跟踪。

安装与运行

无需安装步骤；直接使用 npx 运行：

SUMOSIGN_API_KEY=ss_live_... npx @sumosign/mcp

配置

客户端配置示例

{
  "mcpServers": {
    "sumosign": {
      "command": "npx",
      "args": ["-y", "@sumosign/mcp"],
      "env": { "SUMOSIGN_API_KEY": "ss_live_..." }
    }
  }
}

Related MCP server: SignaTrust MCP Server

工具

该服务器注册了 16 个工具：

文档

• upload_document — 上传本地 PDF；返回用于创建信封的文档 ID。

• analyze_document — 分析已上传的 PDF 以提供字段放置建议（文本提取，无 OCR）。

模板

• create_template — 从带有 {{signature_1}} 等文本锚点的 PDF 创建可复用模板。

• list_templates — 列出组织的可复用模板。

• seed_starter_templates — 植入示例模板（测试信封、简单 NDA、单页协议）。

信封 — 创建

• create_envelope — 从已上传文档（内联字段）或模板创建草稿信封。

• create_envelope_from_template — 从模板创建草稿信封；字段会被继承。

信封 — 验证与发送

• preview_envelope — 将放置预览（每个字段绘制为带标签的虚线框）下载到本地路径。不会发送电子邮件，也不会消耗信封——在发送前用它与人类确认放置位置。

• send_envelope — 发送草稿信封。只有人类才能签署；此工具无法完成签名。

信封 — 跟踪

• send_reminder — 向尚未签署的接收者重新发送签名电子邮件。24 小时冷却；适用消费和反垃圾邮件上限。无法完成签名。

• get_envelope — 获取信封状态，包括每个接收者的进度。

• list_envelopes — 列出组织最近的信封。

• void_envelope — 在完成前作废信封；撤销未完成的签名链接（记录在审计日志中）。

• get_audit_trail — 获取带有操作者归属的仅追加审计跟踪。

下载

• download_signed_pdf — 将已完成信封的扁平化签名 PDF 下载到本地路径。

• download_certificate — 将完成证书下载到本地路径。

安全

• 本地文件系统访问。 upload_document 读取你提供的本地 PDF 路径，preview_envelope、download_signed_pdf 和 download_certificate 将文件写入你提供的本地路径。因此，服务器可以读取和写入宿主进程能访问的任何文件。请以最小权限运行，并且只指向你打算共享的路径。

• 不受信任的文档内容 / 提示注入。 analyze_document 从 PDF 中提取文本并将其返回给代理。文档内容是不受信任的输入，可能包含提示注入尝试。请将提取的文本视为数据而非指令，并在 send_envelope 之前保持人工参与。

• 最小权限 API 密钥。 从 SumoSign 门户为每个代理签发受限密钥，并且只授予该代理所需的作用域。可用作用域：documents:create、documents:read、documents:send、documents:download、templates:read、templates:write、signers:manage、webhooks:write、audit_logs:read、branding:write、voice:trigger。密钥在静态存储时经过哈希处理且可撤销，并且永远无法代表人类完成签名。

关于

SumoSign 由 Cipher Projects 开发。

许可证

MIT