您可以请求 AI 代理（例如 Claude、Cursor 或 GitHub Copilot）对文档进行签名，并在本地、您的机器上完成，文件和证书始终不离开本机。代理决定签署什么以及如何签署；GroupDocs.Signature.Mcp 服务器通过其 sign 工具应用签名。以下内容均从类似的提示开始：

签署 contract.pdf，使用 signing-cert.pfx 进行数字签名。

带有配置和故障排除的逐步版本请参阅文档：使用 AI 代理通过 MCP 签署文档的方式.

当您请求 AI 代理进行“签名”时，这是什么意思？

它可以指视觉标记或加密签名，在任何自动化之前，这一区别非常重要。sign 工具接受四种 type 值：text、qrcode、barcode 和 digital。前三种在页面上放置视觉标记。只有 digital 才会应用基于证书的加密签名，记录签署者并让任何人能够检测文件后续的更改。

语言模型本身不会自行区分。如果提示仅说“签名”，代理必须猜测您指的是哪种签名，因此请指明类型。下面的三种方式按标记轻重顺序排列，从最轻到最强。

方法 1：使用文本签名在页面上盖章

当人员或流程只需要看到文档已被处理时使用文本签名：姓名、日期、批准标签等。

在 report.docx 中添加包含我的姓名和今天日期的文本签名。

代理使用 type: "text" 和您提供的文本调用 sign。服务器将签名后的副本写入输出文件夹，原始文件保持不变。这是一种标记，而非证据：它在页面上显示标签，但并未说明是谁放置的，也不表明文件随后是否被更改。

方法 2：添加携带引用的二维码或条形码

当机器而非人员将在后续读取签名时使用代码。二维码可以容纳结构化文本，条形码（如 Code39、Code128 和 EAN 系列）适用于扫描线工作流。

使用包含 ORDER-2026-0418 的二维码签署 contract.pdf。

代理使用 type: "qrcode" 和 text: "ORDER-2026-0418" 调用 sign。在每个请求代码的提示中请明确提供文本，并在依赖之前使用 search_qr_codes 读取该值。与文本盖章类似，代码是一种视觉标记：它证明标记存在，但不说明是谁应用的。

方法 3：应用基于证书的数字签名

当您需要显示签署者身份并确保文件自签署后未被更改时使用数字签名。代理将证书文件及其密码传递给 sign：

使用 signing-cert.pfx 对 contract.pdf 进行数字签名。

调用使用 type: "digital"、certificate 和 certificatePassword。这两者由本地服务器进程从本地磁盘读取，签名在进程内完成。没有涉及签名服务，因此密钥和密码均不会被传输。请将密码保存在环境变量中，而不是写入已提交的客户端配置。

顺序在此非常重要。视觉标记会重写文件，因此在数字签名之后添加任何文本盖章或代码都会使其失效。请先应用所有视觉标记，最后再进行数字签名，并在代理链式签名时的提示中说明这一点。

示例会话（节选）

您：    使用包含 ORDER-2026-0418 的二维码签署 contract.pdf。

代理：  [sign] file=contract.pdf, type=qrcode, text="ORDER-2026-0418"
        -> 已使用二维码签名签署 contract.pdf
        已将签名副本保存到输出文件夹。
        原始 contract.pdf 未被修改。

示例输出：文件名和二维码值为虚构。工具返回上述字段。

AI 代理不能为您签署什么？

代理可以应用签名；但它无法使该签名具备法律约束力。此服务器不是托管的电子签名服务或合格的信任服务提供商。它在单台机器上、针对单个客户端进程使用您提供的证书应用签名。

结果是否符合特定法律体系（例如 eIDAS 合格签名），取决于证书及其相关流程，而非此服务器本身。如果可能出现争议，请在自动化之前询问使用哪种证书和流程。

您应了解的评估模式限制

未获取许可证时，服务器以评估模式运行：仅处理前 2 页，并在每页加上试用徽章。针对合同第 5 页的签名将不会被放置，且不会有错误提示。在任何重要的签名操作之前，请询问：

签名服务器的许可证状态是什么？

代理调用 get_license_status，该方法报告模式（评估、已授权或计量），且不涉及文档。

常见问题

AI 能为我签署文档吗？
代理可以通过 sign 工具在本地对文档应用文本、二维码、条形码或基于证书的签名。该签名是否具备法律效力取决于证书和您所在的司法管辖区，而非代理本身。

Claude 能在不上传 PDF 的情况下进行签名吗？
可以。MCP 服务器作为客户端的子进程通过 stdio 运行，没有入站端口、外部端点，也没有遥测。路径为：代理 → 本地服务器 → 本地文件系统。

此功能适用于哪些客户端？
Claude Desktop、Claude Code、带 GitHub Copilot 的 VS Code、Visual Studio 2022（17.14+）、Cursor、Windsurf、Cline、Codex CLI 和 JetBrains Rider。使用 dnx GroupDocs.Signature.Mcp --yes 或 Docker 镜像 ghcr.io/groupdocs-signature/signature-net-mcp 安装。

深入了解