Para marcar documentos automaticamente, dê a um agente de IA uma instrução permanente e deixe‑lo chamar uma ferramenta de marca‑d’água de imagem localmente para cada arquivo na pasta de saída. Com o servidor GroupDocs.Watermark.Mcp essa instrução pode ser uma única linha em um arquivo de regras, uma instrução de projeto no Claude Code ou um prompt que você cola no Cursor:

Coloque logo.png em cada página de cada arquivo na pasta de saída com 25% de opacidade, então liste os arquivos que você produziu.

A versão passo a passo com configuração e solução de problemas está na documentação: Como marcar documentos com uma marca‑d’água de logotipo usando IA.

Por que a marca manual diverge?

A marca aplicada manualmente varia de pessoa para pessoa: uma equipe cola o logotipo no arquivo fonte, outra carimba o PDF com força total, uma terceira esquece. Um LLM que “adiciona um logotipo” editando o conteúdo do documento também não tem um posicionamento estável. A ferramenta add_image_watermark aplica o logotipo como um objeto de marca‑d’água, com valores explícitos de opacity e rotation, de modo que as mesmas entradas produzem a mesma intensidade e ângulo. Como é um objeto e não conteúdo colado, o logotipo pode ser encontrado e removido posteriormente quando a marca mudar.

O que o agente decide e o que o mecanismo faz?

Etapa O agente decide O mecanismo faz
Quais arquivos estão no escopo Lê a pasta e sua instrução Nada
Qual ferramenta chamar add_image_watermark para um logotipo, add_watermark para um status Nada
Intensidade e ângulo Passa opacity e rotation do seu padrão Desenha a marca exatamente com esses valores
Saída Relata os arquivos produzidos Escreve um novo arquivo; o original não é modificado

O padrão vive no seu prompt. O servidor não agenda a si mesmo e não tem política de marca incorporada; a parte repetível é a instrução que você salva e reutiliza.

Como aplicar o padrão em cinco etapas?

  1. Mantenha o logotipo ao lado dos documentos. Tanto o documento quanto a imagem são resolvidos por nome a partir da pasta de armazenamento (GROUPDOCS_MCP_STORAGE_PATH). Use um PNG transparente; um logotipo em um retângulo branco mostra esse retângulo sobre a página.
  2. Separe os arquivos de saída. Defina GROUPDOCS_MCP_OUTPUT_PATH para uma pasta diferente se quiser que as cópias marcadas fiquem separadas das originais. Se não definido, a saída vai para a pasta de armazenamento.
  3. Verifique a licença. Pergunte: “Qual é o status da licença do servidor de marca‑d’água?” O agente chama get_license_status.
  4. Execute o prompt padrão. Opacidade entre 0,2 e 0,4 é a faixa que a documentação recomenda para marcação; acima de 0,6 o logotipo domina a página.
  5. Verifique. Solicite uma passagem search_watermarks em cada arquivo produzido e compare a contagem com o que você espera.

A marca pode também indicar um status?

Sim, com uma segunda chamada encadeada. Marque e indique o status em uma única solicitação:

Adicione o logotipo com 25% de opacidade, então adicione uma marca‑d’água de texto CONFIDENCIAL ao resultado.

Cada chamada grava um novo arquivo, portanto “ao resultado” é o que mantém ambas as marcas.

Exemplo de sessão (abreviado)

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 dessa forma é seguro porque cada tentativa gera um novo arquivo. Exclua os rejeitados depois.

Qual canal de entrega é adequado para um lançamento em equipe?

Para uma configuração compartilhada, a imagem Docker evita instalar qualquer outra coisa em cada máquina, pois o runtime e as dependências nativas estão dentro dela:

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

O canal NuGet (dnx GroupDocs.Watermark.Mcp --yes) requer o SDK .NET 10. Ambos rodam no Windows, Linux e macOS (dnx no Linux/macOS também precisa de libgdiplus), e ambos utilizam as mesmas seis ferramentas, portanto o prompt de marca não muda entre eles.

Quais são os limites?

Planeje em torno de dois limites. Primeiro, a ferramenta expõe apenas opacity e rotation: não há configuração de posição, tamanho ou margem. Segundo, modo de avaliação: a página de licenciamento do servidor indica que a saída não licenciada possui limitações de avaliação (os limites exatos estão na página de licenciamento), portanto cópias marcadas produzidas sem licença não podem ser distribuídas. Execute get_license_status antes de um lançamento de marca. Sob licenciamento por medição cada arquivo processado é cobrado, e sob uma licença o servidor funciona offline. Também lembre‑se de que uma marca‑d’água rotula um documento; ela não protege o conteúdo abaixo dela.

Perguntas Frequentes

A IA pode adicionar o logotipo da nossa empresa a todos os PDFs?
Sim. Solicite o logotipo pelo nome do arquivo e forneça uma opacidade; o agente chama add_image_watermark uma vez por arquivo. A mesma chamada também funciona em arquivos Word, PowerPoint, Excel e imagens.

Posso usar o mesmo logotipo em imagens e documentos?
Sim. Imagens são alvos válidos, portanto marcar fotos de produtos funciona como marcar um PDF.

O que acontece quando a marca muda?
remove_watermarks pode remover o logotipo antigo, pois ele foi aplicado como um objeto de marca‑d’água. Seu textFilter corresponde apenas ao texto da marca‑d’água, portanto remover um logotipo de imagem significa remover todas as marcas‑d’água, incluindo as de texto. Primeiro faça uma busca para saber o que está presente, depois adicione o novo logotipo.

Aprofunde-se