DocSpring

官方

将您的 AI 助手连接到 DocSpring,以设置 PDF、Word、HTML 和页面设计模板,填写模板并发送文档以供签署。使用 OAuth 登录,无需复制 API token。

你可以用 DocSpring MCP 做什么?

  • 查找模板和字段 — 列出你的 DocSpring 模板,并显示特定模板(例如租赁协议)中的字段。
  • 设计和发布模板 — 根据描述或 PDF 创建模板,设置字段、重命名字段,并发布新版本。
  • 生成 PDF — 填写模板并生成测试 PDF(免费,带水印)或使用账户额度的正式 PDF。
  • 设置签名请求 — 按顺序将模板发送给多位签署人,并按你选择的间隔发送提醒。
  • 整理模板 — 将名称符合某种模式的模板移至新文件夹。
  • 管理 Webhook 和电子邮件操作 — 获得完整访问权限后,可创建将提交内容发送到 URL 的 Webhook,以及发送 PDF 的电子邮件操作。

托管 MCP 服务器

npx add-mcp 'https://mcp.docspring.com/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

在 Claude 中打开 在 ChatGPT 中打开

DocSpring 的 MCP 服务器可让 AI 助手在你的 DocSpring 账户中工作。它可以查找模板、填写模板并生成 PDF 和 Word 文档、创建设计页面、编辑字段并发布版本、设置签名请求,以及管理文件夹、webhook 和电子邮件操作。它是一个使用 Model Context Protocol 的远程服务器:将其 URL 添加到助手,然后登录 DocSpring 即可。无需复制 API token。

区域MCP 服务器 URL
美国https://mcp.docspring.com/mcp
欧盟https://mcp-eu.docspring.com/mcp

请使用与你的账户所在区域对应的 URL。如果你在 app-eu.docspring.com 登录 DocSpring,你的账户就在欧盟。以下示例使用美国 URL。对于欧盟,请在命令和配置文件中使用欧盟的 URL,并像 DocSpring 插件一样将服务器命名为 docspring-eu,以免替换名为 docspring 的美国服务器。

对于编程代理(Claude Code、Codex、Copilot、Gemini CLI),DocSpring 插件 会添加 MCP 服务器以及 DocSpring 的代理技能,帮助代理掌握 DocSpring 的工作流程。

连接助手

将 URL 添加到助手,然后在浏览器中登录 DocSpring,并选择助手可以执行的操作(请参阅访问权限)。

还没有 DocSpring 账户?在助手打开的登录页面上使用 Google、GitHub 或电子邮件创建账户,然后从那里连接。接着让助手为你设计第一个模板。

Claude

Claude.ai、Claude Desktop 和 Claude 移动应用使用相同的连接器。点击以下按钮,会打开 Claude 的“添加自定义连接器”对话框,并自动填入 DocSpring 的 URL:

如需手动添加,请前往 自定义 > 连接器,点击 + 添加,然后选择 添加自定义连接器。将 DocSpring 设为名称,并输入 MCP 服务器 URL,然后点击 添加 并登录。在聊天中,从 连接器 下方的 + 菜单启用 DocSpring。

自定义连接器适用于所有 Claude 套餐(免费套餐允许添加一个)。在 Team 和 Enterprise 套餐中,所有者需在 组织设置 > 连接器 中添加连接器,然后每位成员从 自定义 > 连接器 连接它。

Claude Code

claude mcp add --transport http --scope user docspring https://mcp.docspring.com/mcp

然后在 Claude Code 中运行 /mcp,选择 docspring 并登录。--scope user 会为你的所有项目添加服务器。如果你使用 Claude 订阅登录了 Claude Code,那么你在 Claude 中添加的 DocSpring 连接器已经可用。

ChatGPT

向 ChatGPT 添加 MCP 服务器需要 Business、Enterprise 或 Edu 工作区,并且只能在网页端使用。在 Business 工作区中,管理员或所有者负责添加。ChatGPT Pro 可以添加该服务器,但只能使用只读工具。

  1. 打开插件,点击 +,然后选择 添加自定义 MCP 服务器。
  2. 将 DocSpring 设为名称,将 MCP 服务器 URL 设为连接地址,并选择 OAuth 作为身份验证方式。
  3. 确认后,点击 创建为插件,然后登录 DocSpring。

在聊天中输入 @ 并选择 DocSpring。

Codex

codex mcp add docspring --url https://mcp.docspring.com/mcp
codex mcp login docspring

Codex CLI、其 IDE 扩展和 ChatGPT 桌面应用共用此配置。

Cursor

也可以将服务器添加到 ~/.cursor/mcp.json(所有项目)或 .cursor/mcp.json(单个项目):

{
  "mcpServers": {
    "docspring": { "url": "https://mcp.docspring.com/mcp" }
  }
}

添加服务器后,Cursor 会提示你登录。

VS Code

也可以从命令面板运行 MCP: Add Server 并选择 HTTP,或者将服务器添加到 .vscode/mcp.json:

{
  "servers": {
    "docspring": { "type": "http", "url": "https://mcp.docspring.com/mcp" }
  }
}

VS Code 首次连接时会打开浏览器供你登录。

其他助手

任何支持通过 OAuth 登录远程服务器(Streamable HTTP)的 MCP 客户端都可以连接:Gemini CLI、Zed、Goose 等。将 MCP 服务器 URL 添加为远程服务器或 HTTP 服务器,客户端首次连接时会打开 DocSpring 登录页面。例如,在 Gemini CLI 中:

gemini mcp add --scope user --transport http docspring https://mcp.docspring.com/mcp

访问权限

登录时,DocSpring 会让你选择助手可以执行的操作。在你选择其他选项之前,默认选中 读取和写入:

访问权限助手可以执行的操作
只读查看模板、文件夹、提交及其 PDF、电子邮件操作和电子邮件域名,并根据模板检查数据
读取和写入还可以创建和编辑模板及其字段、发布版本、生成 PDF、创建签名请求,以及添加和检查电子邮件域名
完全访问还可以删除模板、版本、文件夹和电子邮件域名,使提交过期,创建将提交及其他事件发送到 URL 的 webhook,以及创建用于发送 PDF 的电子邮件操作

如果助手登录时请求的权限低于完全访问,DocSpring 会列出它实际请求的权限,你可以按该权限连接,也可以取消。

助手只能看到其访问权限允许使用的工具。MCP 服务器工具列出了这些工具。

每个已连接的助手都会显示在 DocSpring 集成页面的 已连接的应用 下。账户中的任何人都可以在那里断开连接,断开后访问权限会立即停止。如需更改助手的访问权限,请断开连接后重新登录。

实时 PDF 会像通过 API 生成 PDF 一样使用账户额度。测试 PDF 免费,但带有水印;除非你要求生成正式文档,否则这些工具会让助手生成测试 PDF。设置新模板的字段会自动使用账户当月的免费 AI 页面额度,额度用完后则使用账户额度,与模板编辑器中的规则相同。

示例提示

在聊天助手中:

  • “设计一个结业证书模板,包含接收者姓名、课程和日期。”
  • “列出我的 DocSpring 模板,并显示租赁协议中的字段。”
  • “根据 https://example.com/form.pdf 创建模板,设置字段,然后给我看第一页。”
  • “将一页发票设计为页面设计,包含明细表和总额,然后给我看预览。”
  • “为 Acme Corp 生成一份发票模板的测试 PDF,包含你选择的三条明细。”
  • “将合同模板中的 name 字段重命名为 full_name,然后发布新版本。”
  • “按顺序将 NDA 模板发送给 Jane 和 Sam 签署,并每隔 3 天提醒一次。”
  • “将名称中包含‘Draft’的所有模板移到一个名为 Drafts 的新文件夹中。”

在编程代理中,在应用的代码仓库中工作时:

  • “根据 forms/application.pdf 创建 DocSpring 模板,设置字段,并为其数据生成 TypeScript 类型。”
  • “使用 DocSpring SDK 编写代码,根据客户记录填写我们的入职模板,然后生成测试 PDF 进行检查。”
  • “为 fixtures/customers.csv 中的每位客户生成租赁模板的测试 PDF。”

支持将 MCP 服务器提示作为命令使用的助手还提供 创建模板,可根据描述或 PDF 与你一起设计新模板。助手拥有写入权限时即可使用。在 Claude Code 中,输入 / 并查找 create_template:如果服务器添加时命名为 docspring,对应的命令就是 /mcp__docspring__create_template。

安全

  • 拥有访问权限的助手可以读取提交数据,其中可能包含个人数据。只连接组织允许处理这些数据的助手。
  • 助手读取的文本(例如来自网络的 PDF 或提交数据)可能包含旨在诱使助手滥用工具的指令。大多数助手在调用会更改内容的工具前会先征求确认;会更改或移除现有内容的工具(编辑模板或其字段、重命名、移动、恢复版本、更改 webhook 或电子邮件操作、删除、使其过期)会标记为具有破坏性,因此客户端会要求你确认每次调用。如果助手只需查看内容,请选择 只读。
  • 拥有完全访问权限时,助手可以管理 webhook(将提交数据发送到 URL)和电子邮件操作(通过电子邮件发送 PDF)。它可以更改所有这些设置,包括你自己设置的项目;即使断开助手连接,它设置的项目仍会继续运行。如果助手不需要这些权限,请选择 读取和写入。
  • 助手永远看不到 webhook 的签名密钥或标头值:请从 DocSpring 中 webhook 的页面(侧边栏中的 Webhooks)复制密钥,并在那里添加标头。

故障排除

助手没有 DocSpring 工具。 仅添加服务器还不够:你还需要登录。在 Claude 中,点击 自定义 > 连接器 中 DocSpring 旁边的 连接,然后从 + 菜单为聊天启用它。在 Claude Code 中,运行 /mcp 并选择 docspring(欧盟请选择 docspring-eu)。在 Codex 中,运行 codex mcp login docspring(或 docspring-eu)。

登录时找不到你的账户,或者看不到你的模板。 你连接的是另一个区域的服务器。如果你在 app-eu.docspring.com 登录,请连接 https://mcp-eu.docspring.com/mcp 并将其命名为 docspring-eu;否则请使用 https://mcp.docspring.com/mcp。

缺少预期的工具。 助手只能使用其访问权限允许的工具:只读不包含任何会更改内容的工具。如需更改访问权限,请在集成页面的已连接的应用下断开助手连接,然后重新登录。无论你选择什么权限,ChatGPT Pro 都只能使用只读工具。

新工具没有显示。 有些助手会保留连接时看到的工具列表。请重新连接 DocSpring,或在助手的连接器设置中刷新。

助手已退出登录。 这可能是因为账户中的某人已在 DocSpring 中断开连接,或者该助手已 90 天未使用。请从助手重新登录:在 Claude 中,点击 自定义 > 连接器 中 DocSpring 旁边的 重新连接。

工具返回了 processing。 PDF 或模板处理时间超过了约 50 秒。请让助手再次检查:它会使用 get_submission 或 get_template。

实时 PDF 因额度错误而失败。 实时 PDF 会使用账户额度。请在 账单 页面添加额度。如果错误提示添加额度后会处理 PDF,那么添加后就会生成,因此不要再次请求。试用期间测试 PDF 免费,但合并 PDF 始终会使用额度。

其他问题:发送电子邮件至 [email protected],或使用联系表单。

MCP 服务器工具 每个工具及其所需的访问权限