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 多种其他文档和图像格式,所有格式均使用同样的两种工具。
如何一次性标记多个文件?
在提示中指定文件夹名称;代理会对每个文件调用工具。完整的操作步骤请参见下面链接的批处理文章。
深入了解
- 文档,标准操作指南: 使用 MCP 的 AI 代理为文档添加水印的方式
- 文档中心: GroupDocs.Watermark MCP 服务器
- 下一步: 使用 MCP 的自动化 AI 工作流在外发文档上强制执行品牌指南
- 下一步: 一次提示为整个文件夹添加水印
- 下一步: 在删除任何水印之前,为什么要审计您自己的文档中的水印
- 本地部署和安全模型: AI 文档处理的三种架构,以及保持文件在网络内部的方案
- 问题: GroupDocs Watermark 论坛
- 来源: GitHub 上的 GroupDocs.Watermark.Mcp