Um agente de IA pode aplicar marcas d’água em documentos na sua própria máquina, sem upload: você solicita em linguagem natural, o agente chama o servidor GroupDocs.Watermark.Mcp, e uma cópia marcada aparece ao lado do original. Isso funciona no Claude Desktop, Claude Code, Cursor, VS Code com GitHub Copilot e Windsurf. Uma solicitação típica inicial, executada localmente:

Adicionar uma marca d’água diagonal CONFIDENTIAL ao contract.pdf.

A versão passo a passo com configuração e solução de problemas está na documentação: Como aplicar marcas d’água em documentos com agentes de IA usando MCP.

Por que documentos criados com um LLM devem ter um rótulo?

Depois que um LLM redige, resume ou reformata documentos, os arquivos circulam sem nenhum indício de como foram produzidos. Pedir ao modelo para “adicionar uma nota no topo” altera o próprio conteúdo, e um modelo que reescreve um documento pode mudar mais do que a nota. Uma marca d’água é aplicada pelo mecanismo como um objeto separado em uma cópia salva, de modo que o texto subjacente não é regenerado. O servidor grava cada resultado como um novo arquivo; o original permanece intacto. A marca pode ser texto simples ou uma imagem que você escolher; o servidor não detecta se um documento foi gerado por IA e não incorpora metadados de proveniência. Isso torna a rotulagem uma política que pode ser declarada em uma frase: todo documento que sai desta pasta carrega uma marca.

Uma marca d’água é um elemento dissuasório, não um controle de acesso. Ela torna a proveniência visível e o reuso casual incômodo. Não impede a cópia e pode ser removida por quem quiser. Se precisar de evidência de adulteração, use uma assinatura digital em vez disso.

Forma 1: Marcar um status como texto

Use add_watermark quando o rótulo for uma palavra ou uma frase curta: DRAFT, CONFIDENTIAL, uma data, “Generated with AI”.

Adicionar uma marca d’água diagonal AI-GENERATED ao summary.docx.

O agente chama add_watermark com text, um fontSize opcional (padrão 36) e rotation (padrão -45, a diagonal clássica). Resultado esperado: uma mensagem no formato Added text watermark "AI-GENERATED" to "summary.docx" e o caminho do novo arquivo na sua pasta de saída.

Forma 2: Marcar a origem com uma imagem

Use add_image_watermark quando o rótulo for um logotipo, um selo ou uma assinatura escaneada. A imagem pode ser PNG, JPG, BMP ou TIFF e é resolvida por nome a partir da mesma pasta de armazenamento do documento.

Colocar approved-stamp.png em cada página de report.pdf com 30% de opacidade.

opacity varia de 0.0 a 1.0 com padrão 0.5. Valores entre 0.2 e 0.4 geralmente são lidos como um rótulo em vez de uma obstrução.

Forma 3: Combinar um status e uma marca de origem

Use duas chamadas quando uma marca não for suficiente, por exemplo o logotipo da fonte mais um status. Encadeie-as e indique isso:

Adicionar o logotipo com 30% de opacidade, então adicionar uma marca d’água de texto DRAFT ao resultado.

Cada chamada grava um novo arquivo. Sem “ao resultado” a segunda chamada parte do original e apenas a marca DRAFT sobrevive.

Como verificar se o rótulo está presente?

Use search_watermarks para perguntar o que um documento contém. Ele devolve um objeto JSON com count e um array watermarks; cada entrada tem type (text ou image), text, page, x, y, width, height e rotateAngle.

O proposal.pdf já tem uma marca d’água, e o que ela diz?

Execute antes de uma passagem de rotulagem e um arquivo que já mostra CONFIDENTIAL não será marcado duas vezes em ângulos diferentes. Execute depois de uma passagem e você terá evidência de que a marca está presente.

Sessão de exemplo (abreviada)

Você:    Adicionar uma marca d'água diagonal CONFIDENTIAL ao contract.pdf, então
        verificar se está lá.
Agente:  [add_watermark: text "CONFIDENTIAL", rotation -45]
        Marca d'água de texto "CONFIDENTIAL" adicionada a "contract.pdf"
Agente:  [search_watermarks on the new copy]
        contagem: 1 - tipo: texto, texto: "CONFIDENTIAL", página: 1
        A cópia contém uma marca d'água de texto. contract.pdf permanece inalterado.

Como configurá-lo?

Com o SDK .NET 10 instalado, o servidor inicia com um único comando, e seu cliente o lança para você assim que ele estiver registrado:

dnx GroupDocs.Watermark.Mcp --yes

Defina GROUPDOCS_MCP_STORAGE_PATH para a pasta que contém seus documentos. Blocos de registro existem para Claude Desktop, Claude Code, Cursor, VS Code com GitHub Copilot, Windsurf, Cline e Codex CLI; a configuração exata de cada um está no hub de documentação vinculado abaixo.

Quais são os limites?

O primeiro limite é a licença. O servidor inicia em modo de avaliação, onde, conforme a página de licenciamento do servidor, a saída possui limitações de avaliação; os limites exatos estão na página de licenciamento da biblioteca. Para uma ferramenta de marca d’água isso importa: uma cópia produzida em modo de avaliação é um rascunho, não algo para distribuir. Peça ao agente para chamar get_license_status primeiro; ele devolve mode (evaluation, licensed ou metered) sem tocar no documento.

FAQ

Claude pode aplicar marca d’água em um PDF sem enviá-lo?
Sim. O servidor roda como um processo local que seu cliente inicia, e o caminho dos dados é agente, servidor local, sistema de arquivos local. O modelo vê seu prompt e as respostas de texto do servidor; os arquivos do documento permanecem no disco.

Quais formatos um agente de IA pode aplicar marca d’água?
PDF, Word, Excel, PowerPoint, imagens e mais de 50 formatos de documentos e imagens, com as mesmas duas ferramentas para todos eles.

Como rotular muitos arquivos de uma vez?
Nomeie a pasta no prompt; o agente chama a ferramenta por arquivo. Um tutorial completo está no post em lote vinculado abaixo.

Ir mais fundo