signforge

@signforge/mcp-server

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

功能

此 MCP 服务将 AI Agent 连接到 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	下载 ZIP 压缩包，其中包含已签名 PDF、证书和所有文档。

嵌入式签署

工具	说明
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 [email protected] (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 ([email protected]) 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 [email protected].
     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: [email protected]
- 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 中未显示服务

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

链接

• SignForge — 免费电子签名平台
• API 文档 — 完整的 API 参考
• GitHub — 源代码
• MCP 协议 — Model Context Protocol 规范

许可证

MIT