An AI 代理可以在您自己的机器上为文档添加水印,无需上传:您用自然语言提出请求,代理调用 GroupDocs.Watermark.Mcp 服务器,标记后的副本会出现在原文件旁边。这在 Claude Desktop、Claude Code、Cursor、VS Code with GitHub Copilot 和 Windsurf 中均可使用。一个典型的首次请求,本地运行:

在 contract.pdf 上添加一个对角线的 CONFIDENTIAL 水印。

带有配置和故障排除的逐步版本请参见文档: 使用 MCP 的 AI 代理为文档添加水印的方式.

为什么使用 LLM 创建的文档需要带标签?

一旦 LLM 起草、摘要或重新格式化文档,文件就会在没有任何制作方式标记的情况下流通。让模型“在顶部添加注释”会直接更改内容,而重写文档的模型可能会改变的不止注释。水印由引擎作为独立对象添加到已保存的副本上,因此底层文本不会被重新生成。服务器将每个结果写入 新文件;原文件保持不变。标记可以是您选择的纯文本或图像;服务器不会检测文档是否由 AI 生成,也不会嵌入来源元数据。这使得标记可以成为一种只需一句话即可说明的策略:离开此文件夹的每个文档都带有标记。

水印是一种威慑手段,而非访问控制。它使来源可见并让随意再使用变得尴尬。它并不能阻止复制,且可以被想要的人移除。如果需要防篡改证据,请改用数字签名。

方法 1:以文本形式标记状态

当标签是单词或短语时使用 add_watermark:DRAFT、CONFIDENTIAL、日期、“Generated with AI”。

在 summary.docx 上添加一个对角线的 AI-GENERATED 水印。

代理调用 add_watermark,传入 text,可选的 fontSize(默认 36)和 rotation(默认 -45,即经典对角线)。预期结果:形如 Added text watermark "AI-GENERATED" to "summary.docx" 的消息,以及新文件在输出文件夹中的路径。

方法 2:使用图像标记来源

当标签是徽标、印章或扫描签名时使用 add_image_watermark。图像可以是 PNG、JPG、BMP 或 TIFF,并通过与文档相同存储文件夹中的名称来解析。

在 report.pdf 的每一页上放置 approved‑stamp.png,透明度为 30%。

opacity 的取值范围是 0.0 到 1.0,默认值为 0.5。0.2 到 0.4 之间的值通常被视为标签而非遮挡。

方法 3:结合状态和来源标记

当单一标记不足时使用两次调用,例如来源徽标加状态。将它们串联并说明:

以 30% 透明度添加徽标,然后在该结果上添加 DRAFT 文本水印。

每次调用都会写入一个新文件。如果没有“to that result”,第二次调用会从原始文件开始,只有 DRAFT 标记会保留。

如何检查标签是否存在?

使用 search_watermarks 查询文档携带了什么水印。它返回一个包含 count 和 watermarks 数组的 JSON 对象;每个条目包含 type(text 或 image)、text、page、x、y、width、height 和 rotateAngle。

proposal.pdf 已经有水印了吗?如果有,内容是什么?

在标记之前运行它,若文件已经显示 CONFIDENTIAL,则不会在两个角度上重复标记。标记之后运行它,即可获得标记存在的证据。

示例会话(节选)

You:    Add a diagonal CONFIDENTIAL watermark to contract.pdf, then
        check that it is there.
Agent:  [add_watermark: text "CONFIDENTIAL", rotation -45]
        Added text watermark "CONFIDENTIAL" to "contract.pdf"
Agent:  [search_watermarks on the new copy]
        count: 1 - type: text, text: "CONFIDENTIAL", page: 1
        The copy carries one text watermark. contract.pdf is unchanged.

如何设置?

在安装了 .NET 10 SDK 后,服务器只需一条命令即可启动,客户端在注册后会为您启动它:

dnx GroupDocs.Watermark.Mcp --yes

将 GROUPDOCS_MCP_STORAGE_PATH 设置为存放文档的文件夹。Claude Desktop、Claude Code、Cursor、VS Code with GitHub Copilot、Windsurf、Cline 和 Codex CLI 都有相应的注册块;每个的具体配置请参见下面链接的文档中心。

限制是什么?

首要限制是许可。服务器以评估模式启动,根据服务器的许可页面,输出会带有评估限制;具体限制请参见库的 许可页面。对于水印工具而言,这很重要:评估模式下生成的副本是草稿,不能用于分发。先让代理调用 get_license_status;它会返回 mode(evaluation、licensed 或 metered),而不触及文档。

常见问题

Claude 能在不上传的情况下为 PDF 添加水印吗?
是的。服务器作为本地进程运行,由您的客户端启动,数据路径为代理、本地服务器、本地文件系统。模型只看到您的提示和服务器的文本回复;文档文件保持在磁盘上。

AI 代理可以为哪些格式添加水印?
PDF、Word、Excel、PowerPoint、图像以及 50 多种其他文档和图像格式,所有格式均使用同样的两种工具。

如何一次性标记多个文件?
在提示中指定文件夹名称;代理会对每个文件调用工具。完整的操作步骤请参见下面链接的批处理文章。

深入了解