Você pode fazer com que um agente de IA coloque seus comentários de revisão dentro do documento em vez de no chat. O servidor GroupDocs.Annotation.Mcp permite que um LLM no Claude, Cursor ou GitHub Copilot adicione realces, notas e tachados a um arquivo PDF, Word, Excel ou PowerPoint, e grava-os localmente na sua máquina:

Highlight the payment clause on page 2 and add a note asking legal to confirm.

A versão passo‑a‑passo com configuração e solução de problemas está na documentação: How to annotate documents with AI agents using MCP.

Por que o feedback de IA em uma janela de chat se perde?

Peça a um assistente para revisar um contrato e você recebe uma lista: “A cláusula 4 transfere responsabilidade, a cláusula 7 tem uma data aberta.” A lista vive em uma conversa. O colega que abrir o contrato na semana seguinte não vê nada disso, e você tem que copiar cada ponto de volta para o parágrafo correto manualmente.

O agente não é o problema. Ele não tem como escrever no arquivo. Uma revisão só é útil onde o leitor a encontrará, ou seja, ao lado do texto ao qual se refere.

Como é a abordagem errada?

A solução improvisada mais comum é colar o texto do documento em um chat e pedir comentários. Três coisas dão errado, e você pode verificar cada uma em um documento seu:

  • Os comentários não têm posição. “Página 2, segundo parágrafo” é uma descrição que você deve resolver por conta própria.
  • O resultado é uma transcrição, não um entregável. Nada pode ser enviado ao próximo revisor exceto uma captura de tela ou um bloco colado.
  • O documento permanece inalterado, portanto a revisão não pode ser filtrada, contada ou levada ao próximo rascunho.

Qual é a abordagem correta: anotar documentos com um agente de IA?

Divida o trabalho pelo que cada parte faz melhor. O agente entende a instrução “marcar tudo que transfere risco para nós”. O motor grava uma anotação real no arquivo real. A ferramenta que faz a gravação é add_annotation. Ela aceita sete tipos de anotação: textfield, area, point, arrow, highlight, underline e strikeout. Seus argumentos são o arquivo, o tipo, o texto, o número da página (baseado em 1) e as coordenadas do documento x/y.

O resultado é salvo como <name>_annotated.<ext> ao lado do seu original. O original nunca é modificado. A mesma chamada funciona nos mais de 50 formatos que o motor manipula, de modo que um rascunho Word e um PDF são marcados da mesma forma.

Quais ferramentas garantem o posicionamento correto?

As coordenadas são o ponto fraco de qualquer agente que não pode ver a página, e a documentação afirma isso claramente. Três ferramentas reduzem a adivinhação:

  • get_document_info devolve o tipo de arquivo, número de páginas e tamanho, além da largura e altura por página quando o motor as relata, o que fornece ao agente uma caixa de página para raciocinar.
  • get_annotations devolve as anotações existentes com suas caixas delimitadoras, que o agente pode usar como âncoras.
  • generate_pages_preview renderiza uma página como imagem para que um modelo com capacidade de visão localize o texto antes de anotá‑lo. Atualmente falha para arquivos PDF no Linux; veja os limites abaixo.

Qual é a armadilha nas anotações encadeadas?

Todo ferramenta de escrita salva um novo arquivo. Uma segunda anotação deve ser aplicada ao arquivo que a primeira chamada produziu, não ao original, caso contrário a primeira anotação fica presa em um arquivo que ninguém abre novamente. Diga isso no prompt:

Highlight the payment clause, then on the resulting file strike out the old delivery date.

Sessão de exemplo (abreviada)

Esta é uma ilustração construída a partir do comportamento documentado das ferramentas, não uma captura de tela.

You:   Highlight the payment clause on page 2 of contract.pdf and add a note
       asking legal to confirm.

Agent: [calls get_document_info on contract.pdf]
       contract.pdf is a PDF with 6 pages.
       [calls add_annotation: type=highlight, page=2, x=100, y=250,
        text="Legal to confirm these payment terms"]
       Added highlight annotation to contract.pdf on page 2.
       The annotated copy is contract_annotated.pdf. Your original is unchanged.

Como iniciar o servidor de anotação no meu cliente de IA?

Para executá‑lo como contêiner, monte a pasta com seus documentos em /data:

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

Se preferir não usar um contêiner, instale o SDK .NET 10 e inicie dnx GroupDocs.Annotation.Mcp --yes; no Windows isso também é o canal a ser usado para pré‑visualizações de páginas PDF. A página hub contém trechos de registro prontos para Claude Desktop, Claude Code, VS Code com GitHub Copilot, Cursor, Windsurf e outros clientes. Defina GROUPDOCS_MCP_OUTPUT_PATH para uma pasta diferente da pasta de armazenamento antes de encadear edições em um arquivo produzido. Com o padrão (saídas vão para a pasta de armazenamento) a segunda gravação falha com being used by another process; com uma pasta de saída separada add_reply, update_annotation e remove_annotations no arquivo produzido funcionam todas. Com a imagem Docker, passe -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output. Após o registro o cliente inicia o servidor por conta própria e se comunica com ele via stdio, de modo que nada escuta em uma porta de rede e o servidor não envia conteúdo de documento a um serviço de nuvem.

Limites honestos

  • Modo de avaliação. Sem licença, um selo de teste é estampado no topo de cada página, portanto a saída anotada não pode ser distribuída. Pergunte primeiro “What is the license status of the annotation server?”; o agente chama get_license_status.
  • Posicionamento é aproximado sem ajuda. Um agente que adivinha x/y a partir de um prompt coloca uma anotação area ou point de forma aproximada. Leia primeiro ou renderize primeiro para posicionamento preciso.
  • Pré‑visualização no Linux. generate_pages_preview atualmente falha para arquivos PDF no Linux, inclusive na imagem Docker (TypeInitializationException para Gdip: System.Drawing.Common não é suportado em plataformas não‑Windows); documentos Word e outros Office são renderizados, e no Windows com dnx todos os formatos são renderizados. As outras dez ferramentas não são afetadas.

Perguntas Frequentes

Claude pode adicionar comentários a um PDF? Sim, por meio de um servidor MCP que expõe uma ferramenta de anotação. Com GroupDocs.Annotation.Mcp o agente chama add_annotation e o comentário é escrito em <name>_annotated.pdf.

A IA precisa fazer upload do meu documento para anotá‑lo? Não, não através do servidor: ele abre o arquivo na sua pasta montada e salva a cópia anotada ao lado. Apenas o que o modelo próprio vê, como texto que você cola ou imagens de página que o agente visualiza, vai para o provedor do seu modelo.

Funciona em Word e Excel, não apenas em PDF? Sim. Os mesmos tipos de anotação funcionam em PDF, DOCX, XLSX, PPTX e imagens, com os mais de 50 formatos listados na documentação.

Aprofunde-se