如何通过 MCP 将 DocuSeal 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → DocuSeal、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

DocuSeal + Gemini

DocuSeal 是开源电子签名平台，可用云端（US 或 EU）或自托管：查找模板、签署请求和签署人，查看谁已签署，获取已签 PDF 和完成事件，发送模板或单个 PDF 签署，修改签署人，并从 PDF、DOCX 或 HTML 创建模板。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

DOCUSEAL_API_URL, DOCUSEAL_API_KEY

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个 DocuSeal Cloud 账户，或能访问自托管的 DocuSeal。

1. 复制你的 API 密钥：DocuSeal Cloud 在 https://console.docuseal.com/api（EU 账户：https://console.docuseal.eu/api），自托管的 DocuSeal 在 Settings > API（https://<your host>/settings/api）。
2. 把它粘贴到 DOCUSEAL_API_KEY。它通过 X-Auth-Token 请求头发送，并以密钥所属用户的身份操作。
3. 设置 DOCUSEAL_API_URL：美国云端用 https://api.docuseal.com，欧盟云端用 https://api.docuseal.eu，自己的实例用 https://<your host>/api（即打开 DocuSeal 的地址加上 /api）。末尾不要加斜杠。
4. 安装连接器并运行 docuseal_list_templates 检查密钥。

测试模式：DocuSeal Cloud 有一个带独立 API 密钥的测试模式，可在控制台中切换。测试签署请求免费且不具法律效力，试用连接器时请使用测试密钥。

可读取的内容：

• 模板：包含角色、字段（名称、类型、角色、是否必填）和文档，可按名称（q）、文件夹或外部 ID 搜索。字段名就是预填值的键。
• 签署请求（submission）：状态、模板、每位签署人的邮箱、角色和状态、事件历史、合并文档和审计日志链接。可按模板、状态、文件夹或签署人筛选。
• 所有签署请求中的签署人：发送、打开、完成或拒签时间，拒签原因，填写的值，以及个人签署链接 embed_src。
• 签署请求文档的下载链接：完成后是已签 PDF，完成前是部分填写的文档；用 merge 可合并为一个 PDF。
• 完成事件：每位完成签署的签署人一条（form.completed），每个全部签完的签署请求一条（submission.completed），数据与 Webhook 相同，可用来补查某个时间点以来签署的所有内容。

可写入的内容：

• 发送签署：docuseal_create_submission 按模板发送，每个角色一位签署人；role 必须与模板的角色名一致，例如 "First Party"，values 按字段名预填字段。对于只有一位签署人的模板，docuseal_create_submissions_from_emails 最快捷：每个邮箱地址一个签署请求，邀请立即发出。docuseal_create_submission_from_pdf 无需先保存模板即可发送单个 PDF。
• 跟进：docuseal_update_submitter 可更正姓名、邮箱或电话，预填值，用 send_email 重新发送邀请，或用 completed 代签署人签署。docuseal_update_submission 可重命名签署请求、修改过期时间、归档和恢复；docuseal_archive_submission 将其归档，签署链接随即失效。
• 模板：docuseal_create_template_from_pdf、docuseal_create_template_from_docx、docuseal_create_template_from_html、docuseal_clone_template、docuseal_update_template（重命名、移到文件夹、重命名角色、归档或取消归档）和 docuseal_archive_template。

所有工具在安装时都已开启，包括发送类工具，而且发送是真实的：除非 send_email 为 false，新的签署请求会给签署人发邮件；completed: true 会代他人签署；归档会让签署链接失效。AI 会先向你展示模板或文档、带角色的签署人和消息，得到明确同意后才发送。

文件和字段：documents[].file 接受公开 URL（由 DocuSeal 下载）或 Base64 内容。字段来自文档中的文本标签，例如 {{Full Name;role=Signer;type=text}}、{{Sign here;role=Signer;type=signature}} 或 {{Date;role=Signer;type=date}}，也可以来自带精确 areas（page、x、y、w、h，按页面比例）的 fields。类型包括 text、signature、initials、date、number、image、checkbox、select、radio、file、stamp、payment 和 phone 等。HTML 模板使用 <signature-field name="Signature" role="Signer"></signature-field> 这样的标签；DOCX 模板可以用 [[variables]] 生成动态文档。

数据格式：ID 是整数。时间为带时区的 ISO 8601。签署请求的 status 为 pending、completed、declined 或 expired；签署人的 status 为 awaiting（因签署顺序尚未邀请）、sent、opened、completed 或 declined。文档 URL 是临时的，请尽快下载。

翻页：列表返回 data 和含 count、next、prev 的 pagination，从新到旧，默认 10 条，用 limit 最多 100 条。AI 把 pagination.next 作为 after 传入以获取下一页（更早的数据），当 next 为 null 时停止。完成事件工具也以同样方式按完成时间（Unix 秒）翻页。

常见错误：401 "Not authenticated" 表示 API 密钥错误或缺失，或者把美国云端的密钥用在了欧盟主机上（反之亦然）。403 表示密钥所属用户无权查看该项目，404 表示 ID 不存在。422 表示输入无效，并附带 error 消息：未知的角色名、缺少邮箱、模板已归档、模板没有字段或文件无法读取。429 表示达到了速率限制。在自托管实例上，如果每次调用都返回 404，说明 DOCUSEAL_API_URL 缺少 /api。

该连接器只归档、从不删除模板和签署请求，也不管理 DocuSeal 用户、账户设置或 Webhook 订阅。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 DocuSeal 的工具。

可用工具

示例提示

• “NDA 模板的哪些签署请求还在等待中？谁还没有签署？”
• “把模板“劳动合同”以 First Party 身份发给 [email protected]，并预填她的姓名和入职日期。发送前先让我看全部内容。”
• “周一以来签署了哪些文件？列出每位签署人及对应文档和完成时间。”
• “获取签署请求 4521 的已签文档，合并为一个 PDF，并附上审计日志链接。”
• “签署人 [email protected] 还没打开邀请：把他的地址改为 [email protected] 并重新发送。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse
• 连接到 Microsoft Copilot