Un agente de IA puede aplicar marcas de agua a documentos en tu propia máquina, sin subirlos: le pides en lenguaje natural, el agente llama al servidor GroupDocs.Watermark.Mcp, y una copia marcada aparece junto al original. Esto funciona en Claude Desktop, Claude Code, Cursor, VS Code con GitHub Copilot y Windsurf. Una solicitud típica inicial, ejecutada localmente:
Agregar una marca de agua diagonal CONFIDENTIAL a contract.pdf.
La versión paso a paso con configuración y solución de problemas está en la documentación: Cómo aplicar marcas de agua a documentos con agentes de IA usando MCP.
¿Por qué los documentos creados con un LLM deberían llevar una etiqueta?
Una vez que un LLM redacta, resume o reformatea documentos, los archivos circulan sin ninguna señal de cómo fueron producidos. Pedir al modelo que “agregue una nota en la parte superior” cambia el contenido mismo, y un modelo que reescribe un documento puede cambiar más que la nota. Una marca de agua es aplicada por el motor como un objeto separado en una copia guardada, de modo que el texto subyacente no se regenera. El servidor escribe cada resultado como un nuevo archivo; el original queda intacto. La marca es texto plano o una imagen que elijas; el servidor no detecta si un documento fue generado por IA y no inserta metadatos de procedencia. Eso convierte el etiquetado en una política que puedes expresar en una frase: cada documento que salga de esta carpeta lleva una marca.
Una marca de agua es un elemento disuasorio, no un control de acceso. Hace visible la procedencia y dificulta el reuso casual. No impide la copia y puede ser eliminada por quien lo desee. Si necesitas evidencia de manipulación, usa una firma digital en su lugar.
Forma 1: Estampar un estado como texto
Utiliza add_watermark cuando la etiqueta es una palabra o una frase corta: DRAFT, CONFIDENTIAL, una fecha, “Generated with AI”.
Agregar una marca de agua diagonal AI-GENERATED a summary.docx.
El agente llama a add_watermark con text, un fontSize opcional (predeterminado 36) y rotation (predeterminado -45, la diagonal clásica). Resultado esperado: un mensaje del tipo Added text watermark "AI-GENERATED" to "summary.docx" y la ruta del nuevo archivo en tu carpeta de salida.
Forma 2: Marcar la fuente con una imagen
Utiliza add_image_watermark cuando la etiqueta es un logotipo, un sello o una firma escaneada. La imagen puede ser PNG, JPG, BMP o TIFF y se resuelve por nombre desde la misma carpeta de almacenamiento que el documento.
Colocar approved-stamp.png en cada página de report.pdf al 30% de opacidad.
opacity varía de 0.0 a 1.0 con un valor predeterminado de 0.5. Los valores entre 0.2 y 0.4 suelen leerse como una etiqueta más que como una obstrucción.
Forma 3: Combinar un estado y una marca de origen
Utiliza dos llamadas cuando una sola marca no es suficiente, por ejemplo el logotipo de origen más un estado. Encadena las llamadas y dilo así:
Agregar el logo al 30% de opacidad, luego agregar una marca de agua de texto DRAFT a ese resultado.
Cada llamada escribe un nuevo archivo. Sin “a ese resultado” la segunda llamada parte del original y solo sobrevive la marca DRAFT.
¿Cómo comprobar que la etiqueta está presente?
Utiliza search_watermarks para preguntar qué lleva un documento. Devuelve un objeto JSON con count y un arreglo watermarks; cada entrada tiene type (text o image), text, page, x, y, width, height y rotateAngle.
¿Tiene proposal.pdf ya una marca de agua, y qué dice?
Ejecuta la búsqueda antes de una pasada de etiquetado y un archivo que ya muestra CONFIDENTIAL no se estampará dos veces en ángulos diferentes. Ejecuta la búsqueda después de la pasada y tendrás evidencia de que la marca está presente.
Sesión de ejemplo (abreviada)
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.
¿Cómo configurarlo?
Con el SDK .NET 10 instalado, el servidor se inicia con un solo comando, y tu cliente lo lanza por ti una vez registrado:
dnx GroupDocs.Watermark.Mcp --yes
Establece GROUPDOCS_MCP_STORAGE_PATH a la carpeta que contiene tus documentos. Existen bloques de registro para Claude Desktop, Claude Code, Cursor, VS Code con GitHub Copilot, Windsurf, Cline y Codex CLI; la configuración exacta para cada uno está en el centro de documentación enlazado a continuación.
¿Cuáles son los límites?
El primer límite es la licencia. El servidor inicia en modo de evaluación, donde, según la página de licencias del servidor, la salida lleva limitaciones de evaluación; los límites exactos están en la página de licencias de la biblioteca. Para una herramienta de marcas de agua esto importa: una copia producida en modo de evaluación es un borrador, no algo para distribuir. Pide al agente que llame primero a get_license_status; devuelve mode (evaluation, licensed o metered) sin tocar ningún documento.
Preguntas frecuentes
¿Puede Claude aplicar una marca de agua a un PDF sin subirlo?
Sí. El servidor se ejecuta como un proceso local que tu cliente inicia, y la ruta de datos es agente, servidor local, sistema de archivos local. El modelo ve tu solicitud y las respuestas de texto del servidor; los archivos del documento permanecen en disco.
¿Qué formatos puede marcar un agente de IA?
PDF, Word, Excel, PowerPoint, imágenes y más de 50 formatos de documentos e imágenes, con las mismas dos herramientas para todos ellos.
¿Cómo etiqueto muchos archivos a la vez?
Indica la carpeta en la solicitud; el agente llama a la herramienta por archivo. Un recorrido completo está en la publicación por lotes enlazada a continuación.
Profundizar
- Documentación, guía canónica: Cómo aplicar marcas de agua a documentos con agentes de IA usando MCP
- Centro de documentación: GroupDocs.Watermark MCP Server
- Siguiente: Aplicar directrices de marca a documentos salientes con flujos de trabajo de IA automatizados usando MCP
- Siguiente: Aplicar marca de agua a una carpeta completa en una sola solicitud
- Siguiente: Por qué auditar las marcas de agua en tus propios documentos antes de eliminar cualquiera
- En local y modelo de seguridad: 3 arquitecturas para el procesamiento de documentos con IA, y la que mantiene los archivos dentro de tu red
- Preguntas: GroupDocs Watermark forum
- Fuente: GroupDocs.Watermark.Mcp on GitHub