Puoi far sì che un agente IA inserisca i suoi commenti di revisione all’interno del documento invece che nella chat. Il server GroupDocs.Annotation.Mcp consente a un LLM in Claude, Cursor o GitHub Copilot di aggiungere evidenziazioni, note e cancellature a un file PDF, Word, Excel o PowerPoint, e lo scrive localmente sul tuo computer:

Evidenzia la clausola di pagamento a pagina 2 e aggiungi una nota chiedendo al legale di confermare.

Perché il feedback dell’IA in una finestra di chat si perde?

Chiedi a un assistente di revisionare un contratto e ottieni un elenco: “La clausola 4 sposta la responsabilità, la clausola 7 ha una data aperta.” L’elenco vive in una conversazione. Il collega che apre il contratto la settimana successiva non vede nulla, e devi copiare manualmente ogni punto nel paragrafo corretto.

L’agente non è il problema. Manca di un modo per scrivere nel file. Una revisione è utile solo dove il lettore la incontrerà, cioè accanto al testo a cui si riferisce.

Come appare l’approccio sbagliato?

Il rimedio comune è incollare il testo del documento in una chat e chiedere commenti. Tre cose vanno storte, e puoi verificare ciascuna su un tuo documento:

  • I commenti non hanno posizione. “Pagina 2, secondo paragrafo” è una descrizione che devi risolvere da solo.
  • Il risultato è una trascrizione, non un prodotto finito. Nulla può essere inviato al revisore successivo se non uno screenshot o un blocco incollato.
  • Il documento rimane invariato, quindi la revisione non può essere filtrata, conteggiata o portata alla bozza successiva.

Qual è l’approccio corretto: annotare i documenti con un agente IA?

Dividi il lavoro in base a ciò in cui ciascuna parte è brava. L’agente comprende l’istruzione “segnala tutto ciò che sposta il rischio su di noi”. Il motore scrive una vera annotazione nel vero file. Lo strumento che effettua la scrittura è add_annotation. Accetta sette tipi di annotazione: textfield, area, point, arrow, highlight, underline e strikeout. I suoi argomenti sono il file, il tipo, il testo, un numero di pagina basato su 1 e le coordinate del documento x/y.

Il risultato viene salvato come <name>_annotated.<ext> accanto all’originale. L’originale non viene mai modificato. La stessa chiamata funziona su oltre 50 formati gestiti dal motore, quindi una bozza Word e un PDF vengono annotati allo stesso modo.

Quali strumenti garantiscono il posizionamento corretto?

Le coordinate sono il punto debole di qualsiasi agente che non può vedere la pagina, e la documentazione lo afferma chiaramente. Tre strumenti riducono le ipotesi:

  • get_document_info restituisce il tipo di file, il numero di pagine e le dimensioni, più larghezza e altezza per pagina quando il motore le segnala, fornendo all’agente una casella di pagina su cui ragionare.
  • get_annotations restituisce le annotazioni esistenti con le loro bounding box, che l’agente può usare come ancore.
  • generate_pages_preview rende una pagina come immagine così un modello con capacità visive può individuare il testo prima di annotarlo. Attualmente fallisce per i file PDF su Linux; vedi i limiti sotto.

Qual è l’unica trappola nelle annotazioni concatenate?

Ogni strumento di scrittura salva un nuovo file. Una seconda annotazione deve essere applicata al file prodotto dalla prima chiamata, non all’originale, altrimenti la prima annotazione rimane in un file che nessuno riapre. Dillo nel prompt:

Evidenzia la clausola di pagamento, poi sul file risultante cancella la vecchia data di consegna.

Sessione di esempio (abbreviata)

Questa è un’illustrazione costruita dal comportamento documentato degli strumenti, non uno screenshot catturato.

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 è un PDF con 6 pagine.
       [calls add_annotation: type=highlight, page=2, x=100, y=250,
        text="Legal to confirm these payment terms"]
       Aggiunta annotazione di evidenziazione a contract.pdf a pagina 2.
       La copia annotata è contract_annotated.pdf. L'originale non è stato modificato.

Come avvio il server di annotazione nel mio client IA?

Per eseguirlo come container, monta la cartella con i tuoi documenti in /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 preferisci non usare un container, installa il .NET 10 SDK e avvia dnx GroupDocs.Annotation.Mcp --yes; su Windows questo è anche il canale da usare per le anteprime delle pagine PDF. La pagina hub contiene snippet di registrazione pronti per Claude Desktop, Claude Code, VS Code con GitHub Copilot, Cursor, Windsurf e altri client. Imposta GROUPDOCS_MCP_OUTPUT_PATH su una cartella diversa dalla cartella di archiviazione prima di concatenare modifiche su un file prodotto. Con l’impostazione predefinita (gli output atterrano nella cartella di archiviazione) la seconda scrittura fallisce con being used by another process; con una cartella di output separata add_reply, update_annotation e remove_annotations sul file prodotto hanno tutti successo. Con l’immagine Docker, passa -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output. Dopo la registrazione il client avvia il server da solo e comunica con esso tramite stdio, quindi nulla ascolta su una porta di rete e il server non invia contenuti di documenti a un servizio cloud.

Limiti onesti

  • Modalità di valutazione. Senza licenza, un badge di prova è stampato in cima a ogni pagina, quindi l’output annotato non è distribuibile. Chiedi prima “Qual è lo stato della licenza del server di annotazione?”; l’agente chiama get_license_status.
  • Il posizionamento è approssimativo senza aiuto. Un agente che indovina x/y da un prompt posiziona un’annotazione area o point in modo approssimativo. Leggi prima o rendi prima per un posizionamento preciso.
  • Anteprima su Linux. generate_pages_preview attualmente fallisce per i file PDF su Linux, inclusa l’immagine Docker (TypeInitializationException per Gdip: System.Drawing.Common non è supportato su piattaforme non Windows); Word e altri documenti Office vengono renderizzati, e su Windows con dnx ogni formato viene renderizzato. Gli altri dieci strumenti non sono influenzati.

Domande frequenti

Claude può aggiungere commenti a un PDF? Sì, tramite un server MCP che espone uno strumento di annotazione. Con GroupDocs.Annotation.Mcp l’agente chiama add_annotation e il commento viene scritto in <name>_annotated.pdf.

L’IA deve caricare il mio documento per annotarlo? No, non attraverso il server: apre il file nella tua cartella montata e salva la copia annotata accanto ad esso. Solo ciò che il modello stesso vede, come il testo che incolli o le immagini delle pagine che l’agente visualizza, viene inviato al tuo provider di modello.

Funziona su Word e Excel, non solo su PDF? Sì. Gli stessi tipi di annotazione funzionano su PDF, DOCX, XLSX, PPTX e immagini, con i più di 50 formati elencati nella documentazione.

Approfondisci