@signforge/mcp-server

直接从 Claude Desktop、Claude Code、Cursor 和其他 AI 代理发送电子签名文档 — 由 SignForge（免费电子签名平台）提供支持。

功能介绍

此 MCP 服务器将 AI 代理连接到 SignForge 的电子签名 API。您的 AI 助手可以：

发送文档以供签名 — 上传 PDF、指定签署人，并一步完成发送
管理信封 — 发送、作废、删除和检查状态
下载文档 — 已签名的 PDF、审计证书和 ZIP 压缩包
使用模板 — 使用带有预填字段的可重用模板创建信封
管理 Webhook — 订阅实时信封事件
生成嵌入 URL — 创建可嵌入的签名体验

快速入门

1. 获取您的 API 密钥

在 signforge.io 注册，并从您的开发者设置中生成 API 密钥。

2. 配置您的 AI 客户端

选择下方的客户端并添加配置：

Claude Desktop

添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置文件位置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add signforge -- npx -y @signforge/mcp-server

然后在您的 shell 中设置环境变量：

export SIGNFORGE_API_KEY="your-api-key-here"

Cursor

添加到您的 Cursor MCP 设置 (.cursor/mcp.json)：

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

直接使用 (npx)

SIGNFORGE_API_KEY="your-api-key-here" npx -y @signforge/mcp-server

3. 重启您的客户端

重启 Claude Desktop、Claude Code 或 Cursor 以加载新的 MCP 服务器。

工具

信封管理

工具	描述
`create_and_send`	上传 PDF、添加签署人并发送以进行电子签名。接受本地文件路径或 base64 编码的 PDF。
`check_status`	检查信封状态 — 查看签名进度、时间戳和可用文档。
`list_envelopes`	列出您的信封，支持可选的状态过滤 (`draft`、`sent`、`completed`、`voided`、`expired`)。
`send_envelope`	发送草稿信封以供签名。
`void_envelope`	作废（取消）一个活动的信封，可选择提供原因。
`delete_envelope`	永久删除草稿或已作废的信封。

文档下载

工具	描述
`download_signed`	将已完成信封的已签名 PDF 下载到本地文件。
`download_certificate`	下载包含完整审计追踪的审计证书 PDF。
`download_archive`	下载包含已签名 PDF、证书和所有文档的 ZIP 压缩包。

嵌入式签名

工具	描述
`get_embed_url`	为应用内签名体验生成可嵌入的签名 URL。

模板

工具	描述
`list_templates`	列出您的可重用文档模板。
`create_from_template`	使用模板创建信封，并可选择预填字段值。可立即发送或保存为草稿。

Webhook

工具	描述
`create_webhook`	订阅信封事件（已发送、已查看、已签名、已完成、已过期、已作废、已拒绝）。
`list_webhooks`	列出所有已配置的 Webhook。
`delete_webhook`	按 ID 删除 Webhook。

对话示例

发送文档以供签名

You: Send my NDA at ~/Documents/nda.pdf to jane@example.com (Jane Smith) for signature.

AI: I'll send that NDA for signature now.

[Uses create_and_send tool]

Done! I've created and sent the envelope:
- Envelope ID: a1b2c3d4-...
- Status: sent
- Jane Smith (jane@example.com) will receive a signing link via email.

检查状态并下载

You: Has Jane signed the NDA yet?

AI: Let me check.

[Uses check_status tool]

Yes! Jane signed it on April 7 at 2:15 PM. The envelope is now completed.

You: Great, download the signed copy and the audit certificate.

[Uses download_signed tool]
[Uses download_certificate tool]

Done! Files saved:
- Signed PDF: ~/Documents/nda-signed.pdf
- Audit Certificate: ~/Documents/nda-certificate.pdf

使用带有预填字段的模板

You: Send our standard consulting agreement to bob@acme.com.
     Pre-fill the company name as "Acme Corp" and the start date as "May 1, 2026".

AI: I'll create that from your consulting agreement template.

[Uses list_templates tool — finds "Consulting Agreement" template]
[Uses create_from_template tool — with prefill_fields and send_immediately: true]

Done! Envelope created and sent:
- Title: Consulting Agreement
- Recipient: bob@acme.com
- Pre-filled: company = "Acme Corp", start_date = "May 1, 2026"
- Status: sent

管理信封生命周期

You: List my sent envelopes.

[Uses list_envelopes tool with status: "sent"]

You: Void the contract for Project Alpha — the deal fell through.

[Uses void_envelope tool with reason]

You: Now delete it.

[Uses delete_envelope tool]

Done — envelope voided and deleted.

设置 Webhook

You: Set up a webhook to notify my server when documents are signed or completed.

[Uses create_webhook tool]

Webhook created:
- URL: https://api.yourapp.com/webhooks/signforge
- Events: envelope.signed, envelope.completed
- Secret: whsec_abc123... (save this for signature verification!)

环境变量

变量	必需	默认值	描述
`SIGNFORGE_API_KEY`	是	—	您的 SignForge API 密钥。在 signforge.io/dashboard/developers 获取。
`SIGNFORGE_API_URL`	否	`https://signforge.io/api/v1`	API 基础 URL。仅在自托管实例或测试环境时更改此项。

沙盒模式

在沙盒模式下创建的 API 密钥将创建不会发送真实电子邮件的测试信封。在开发和测试期间请使用沙盒模式。

故障排除

"SIGNFORGE_API_KEY environment variable is required" 确保您已在 MCP 客户端配置中设置了 SIGNFORGE_API_KEY。请参阅上方的设置说明。

"SignForge API error (401)" 您的 API 密钥无效或已过期。请在 signforge.io/dashboard/developers 生成一个新的。

"SignForge API error (403)" 您的 API 密钥没有此操作的权限。请检查您密钥的作用域。

"SignForge API error (429)" 您已达到速率限制。请稍后再试。

服务器未在 Claude Desktop 中显示

确保配置 JSON 有效（没有多余的逗号）
完全重启 Claude Desktop（退出并重新打开）
在 Claude Desktop 的开发者控制台中检查 MCP 服务器日志

链接

SignForge — 免费电子签名平台
API 文档 — 完整 API 参考
GitHub — 源代码
MCP 协议 — 模型上下文协议规范

许可证

MIT

SignForge