Para marcar documentos automáticamente, dé a un agente de IA una instrucción permanente y permítale llamar a una herramienta de marca de agua de imagen localmente para cada archivo en la carpeta de salida. Con el servidor GroupDocs.Watermark.Mcp esa instrucción puede ser una sola línea en un archivo de reglas, una instrucción de proyecto en Claude Code, o un prompt que pegue en Cursor:

Coloque logo.png en cada página de cada archivo en la carpeta de salida con un 25 % de opacidad, luego enumere los archivos que produjo.

La versión paso a paso con configuración y solución de problemas está en la documentación: Cómo marcar documentos con una marca de agua de logotipo usando IA.

¿Por qué la marca manual se desvía?

La marca aplicada a mano varía según la persona: un equipo pega el logotipo en el archivo fuente, otro estampa el PDF a máxima intensidad, un tercero se olvida. Un LLM que “añade un logotipo” editando el contenido del documento tampoco tiene una ubicación estable. La herramienta add_image_watermark aplica el logotipo como un objeto de marca de agua, con valores explícitos de opacity y rotation, de modo que las mismas entradas dan la misma intensidad y ángulo. Como es un objeto y no contenido pegado, el logotipo puede encontrarse y eliminarse más tarde cuando la marca cambie.

¿Qué decide el agente y qué hace el motor?

Paso Lo que decide el agente Lo que hace el motor
Qué archivos están en alcance Lee la carpeta y su instrucción Nada
Qué herramienta llamar add_image_watermark para un logotipo, add_watermark para un estado Nada
Intensidad y ángulo Pasa opacity y rotation de su estándar Dibuja la marca con exactamente esos valores
Salida Informa los archivos producidos Escribe un nuevo archivo; el original no se modifica

El estándar vive en su prompt. El servidor no se programa a sí mismo y no tiene una política de marca incorporada; la parte repetible es la instrucción que guarda y reutiliza.

¿Cómo aplicar el estándar en cinco pasos?

  1. Mantenga el logotipo junto a los documentos. Tanto el documento como la imagen se resuelven por nombre desde la carpeta de almacenamiento (GROUPDOCS_MCP_STORAGE_PATH). Use un PNG transparente; un logotipo sobre un rectángulo blanco muestra ese rectángulo sobre la página.
  2. Separe los archivos de salida. Establezca GROUPDOCS_MCP_OUTPUT_PATH a una carpeta diferente si desea que las copias marcadas se mantengan separadas de los orígenes. Si no se establece, la salida va a la carpeta de almacenamiento.
  3. Verifique la licencia. Pregunte: “¿Cuál es el estado de la licencia del servidor de marca de agua?” El agente llama a get_license_status.
  4. Ejecute el prompt estándar. La opacidad entre 0.2 y 0.4 es el rango que la documentación recomienda para la marca; por encima de 0.6 el logotipo domina la página.
  5. Verifique. Solicite una pasada de search_watermarks en cada archivo producido y compare el recuento con lo que espera.

¿Puede la marca también indicar un estado?

Sí, con una segunda llamada encadenada. Marque y indique el estado en una sola solicitud:

Añada el logotipo con 25 % de opacidad, luego añada una marca de agua de texto CONFIDENTIAL a ese resultado.

Cada llamada escribe un nuevo archivo, por lo que “a ese resultado” es lo que mantiene ambas marcas.

Sesión de ejemplo (abreviada)

You:    Put logo.png on report.pdf at 30% opacity.
Agent:  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        Added image watermark from "logo.png" to "report.pdf"
You:    That is too strong - redo it at 0.2.
Agent:  [add_image_watermark: opacity 0.2, from the original report.pdf]
        Added image watermark from "logo.png" to "report.pdf"
        Two branded copies exist. Delete the 0.3 copy if you do not need it.

Iterar de esta manera es seguro porque cada intento es un nuevo archivo. Elimine los rechazados después.

¿Qué canal de entrega se adapta a un despliegue en equipo?

Para una configuración compartida, la imagen Docker evita instalar cualquier otra cosa en cada máquina, porque el tiempo de ejecución y las dependencias nativas están dentro de ella:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

El canal NuGet (dnx GroupDocs.Watermark.Mcp --yes) necesita el SDK .NET 10. Ambos se ejecutan en Windows, Linux y macOS (dnx en Linux/macOS también necesita libgdiplus), y ambos usan las mismas seis herramientas, por lo que el prompt de marca no cambia entre ellos.

¿Cuáles son los límites?

Planifique alrededor de dos limitaciones. Primero, la herramienta solo expone opacity y rotation: no hay configuración de posición, tamaño o margen. Segundo, modo de evaluación: la página de licencias del servidor indica que la salida sin licencia lleva limitaciones de evaluación (los límites exactos están en la página de licencias de la biblioteca), por lo que las copias marcadas producidas sin una licencia no son distribuibles. Ejecute get_license_status antes de un despliegue de marca. Con licenciamiento por consumo cada archivo procesado se factura, y con una licencia de archivo el servidor funciona sin conexión. También tenga en cuenta que una marca de agua etiqueta un documento; no protege el contenido bajo ella.

Preguntas frecuentes

¿Puede la IA añadir el logotipo de nuestra empresa a todos los PDF?
Sí. Solicite el logotipo por nombre de archivo y proporcione una opacidad; el agente llama a add_image_watermark una vez por archivo. La misma llamada también funciona en Word, PowerPoint, Excel y archivos de imagen.

¿Puedo usar el mismo logotipo en imágenes y documentos?
Sí. Las imágenes son objetivos válidos, por lo que marcar fotos de productos funciona como marcar un PDF.

¿Qué ocurre cuando la marca cambia?
remove_watermarks puede eliminar el logotipo antiguo, porque se aplicó como un objeto de marca de agua. Su textFilter coincide solo con texto de marca de agua, por lo que eliminar un logotipo de imagen implica eliminar todas las marcas de agua, incluidas las marcas de texto. Busque primero para saber qué hay, luego añada el nuevo logotipo.

Profundizar