swiftsign

swiftsign-mcp

用于 SwiftSign 的 MCP 服务 — 让你直接从 Claude Code 发送文档以供电子签名。

设置

将以下内容添加到你的 .mcp.json（Claude Code 配置）：

{
  "mcpServers": {
    "swiftsign": {
      "command": "npx",
      "args": ["-y", "swiftsign-mcp"],
      "env": {
        "SWIFTSIGN_API_KEY": "sk_your_api_key"
      }
    }
  }
}

在 swiftsign.ca/dashboard 获取 API 密钥 — 也可以完全跳过浏览器，调用 swiftsign_signup 来生成沙盒密钥（见下文）。

测试密钥 → 正式密钥

SwiftSign 密钥分为两种：

• 沙盒密钥以 sk_test_ 开头。所有功能都可用（发送、状态、模板、嵌入式 URL），但发送的文档仅用于测试。无需信用卡。
• 正式密钥可发送具有法律约束力的真实文档。调用一次 swiftsign_upgrade 即可升级（开发者打开 Stripe 付款链接并添加信用卡）。

两种模式使用相同的工具；具体模式由 SWIFTSIGN_API_KEY 中的密钥决定。

Agent 原生工作流（无需浏览器）

Agent 无需打开控制面板，即可从零开始完成电子签名流程并启用正式发送：

1. swiftsign_signup — 创建沙盒账户并获取 sk_test_ 密钥。将其设置为 SWIFTSIGN_API_KEY。
2. swiftsign_send_envelope（或 swiftsign_send_from_template）— 发送测试文档，确认完整流程正常运行。
3. swiftsign_upgrade — 获取 Stripe 结账链接；开发者打开一次链接并添加信用卡。之后即可正式发送。

swiftsign_signup 是唯一一个无需设置密钥即可使用的工具 — 你可以通过它获取密钥。

工具

工具	描述
swiftsign_signup	创建沙盒账户并获取测试 API 密钥（无需浏览器）
swiftsign_send_envelope	发送文档以供电子签名
swiftsign_send_from_template	按角色从已保存的模板发送信封
swiftsign_check_status	检查信封签名状态
swiftsign_list_envelopes	列出所有已发送的信封
swiftsign_list_templates	列出已保存的模板
swiftsign_create_embedded_url	生成短时有效的嵌入式签名 URL
swiftsign_void_envelope	取消信封
swiftsign_upgrade	获取 Stripe 付款链接，升级到 PRO（正式发送）

用法

配置完成后，只需向 Claude 提出请求：

"Send this contract to [email protected] for signing"

Claude 将使用 SwiftSign 发送文档、放置签名栏，并通过电子邮件向收件人发送签名链接。

示例

"Send the MSA at data/contracts/generated/Acme_MSA.pdf to John Smith ([email protected]) for signing, with a signature field at the bottom"

SwiftSign 负责：

• 安全签名链接（签署者无需账户）
• 电子签名同意（符合法律要求）
• 签名采集（手绘、键入或上传）
• 使用 SHA-256 哈希封存文档
• 完成证书
• 向所有相关方发送电子邮件通知

法律合规

SwiftSign 电子签名依据以下法律具有法律约束力：

• 加拿大：Electronic Commerce Act（安大略省）、PIPEDA
• 美国：ESIGN Act、UETA

链接

• 控制面板
• API 文档
• 网站