Vous pouvez faire en sorte qu’un agent IA place ses commentaires de révision à l’intérieur du document au lieu de les mettre dans le chat. Le serveur GroupDocs.Annotation.Mcp permet à un LLM dans Claude, Cursor ou GitHub Copilot d’ajouter des surlignages, des notes et des rayures à un fichier PDF, Word, Excel ou PowerPoint, et il les écrit localement sur votre machine :

Surligner la clause de paiement à la page 2 et ajouter une note demandant au service juridique de confirmer.

La version étape par étape avec configuration et dépannage se trouve dans la documentation : Comment annoter des documents avec des agents IA en utilisant MCP.

Pourquoi les retours d’IA dans une fenêtre de chat se perdent-ils ?

Demandez à un assistant de réviser un contrat et vous obtenez une liste : « La clause 4 transfère la responsabilité, la clause 7 a une date ouverte. » La liste vit dans une conversation. Le collègue qui ouvre le contrat la semaine suivante ne voit rien de tout cela, et vous devez copier chaque point dans le paragraphe approprié à la main.

L’agent n’est pas le problème. Il ne dispose pas d’un moyen d’écrire dans le fichier. Une révision n’est utile que là où le lecteur la rencontrera, c’est-à-dire à côté du texte auquel elle se réfère.

À quoi ressemble la mauvaise approche ?

La solution de contournement courante consiste à coller le texte du document dans un chat et à demander des commentaires. Trois choses tournent mal, et vous pouvez vérifier chacune sur un document qui vous appartient :

  • Les commentaires n’ont aucune position. « Page 2, deuxième paragraphe » est une description que vous devez résoudre vous-même.
  • Le résultat est une transcription, pas un livrable. Rien ne peut être envoyé au prochain relecteur sauf une capture d’écran ou un bloc collé.
  • Le document reste inchangé, donc la révision ne peut pas être filtrée, comptée ou reportée au prochain brouillon.

Quelle est la bonne approche : annoter des documents avec un agent IA ?

Divisez le travail selon les points forts de chaque partie. L’agent comprend l’instruction « marquer tout ce qui transfère le risque vers nous ». Le moteur écrit une vraie annotation dans le vrai fichier. L’outil qui effectue l’écriture est add_annotation. Il accepte sept types d’annotation : textfield, area, point, arrow, highlight, underline et strikeout. Ses arguments sont le fichier, le type, le texte, un numéro de page indexé à 1 et les coordonnées du document x/y.

Le résultat est enregistré sous <name>_annotated.<ext> à côté de votre original. L’original n’est jamais modifié. Le même appel fonctionne sur les plus de 50 formats que le moteur gère, ainsi un brouillon Word et un PDF sont annotés de la même manière.

Quels outils assurent un placement correct ?

Les coordonnées sont le point faible de tout agent qui ne peut pas voir la page, et la documentation le dit clairement. Trois outils réduisent les approximations :

  • get_document_info renvoie le type de fichier, le nombre de pages et la taille, ainsi que la largeur et la hauteur par page lorsque le moteur les rapporte, ce qui donne à l’agent une boîte de page pour raisonner.
  • get_annotations renvoie les annotations existantes avec leurs boîtes englobantes, que l’agent peut utiliser comme ancres.
  • generate_pages_preview rend une page sous forme d’image afin qu’un modèle capable de vision puisse localiser le texte avant d’annoter. Il échoue actuellement pour les fichiers PDF sous Linux ; voir les limites ci‑dessous.

Quel est le piège unique dans les annotations en chaîne ?

Chaque outil d’écriture enregistre un nouveau fichier. Une deuxième annotation doit être appliquée au fichier produit par le premier appel, pas à l’original, sinon la première annotation reste dans un fichier que personne n’ouvre à nouveau. Indiquez‑le dans l’invite :

Surligner la clause de paiement, puis sur le fichier résultant rayer la date de livraison ancienne.

Exemple de session (abrégé)

Il s’agit d’une illustration construite à partir du comportement documenté des outils, et non d’une capture d’écran.

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.

Comment démarrer le serveur d’annotation dans mon client IA ?

Pour l’exécuter en tant que conteneur, montez le dossier contenant vos documents à /data :

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

Si vous préférez ne pas utiliser de conteneur, installez le SDK .NET 10 et lancez dnx GroupDocs.Annotation.Mcp --yes ; sous Windows, c’est également le canal à utiliser pour les aperçus de pages PDF. La page hub propose des extraits d’enregistrement prêts à l’emploi pour Claude Desktop, Claude Code, VS Code avec GitHub Copilot, Cursor, Windsurf et d’autres clients. Définissez GROUPDOCS_MCP_OUTPUT_PATH sur un dossier différent de celui de stockage avant d’enchaîner les modifications sur un fichier produit. Avec la valeur par défaut (les sorties atterrissent dans le dossier de stockage) la deuxième écriture échoue avec being used by another process ; avec un dossier de sortie séparé, add_reply, update_annotation et remove_annotations sur le fichier produit réussissent tous. Avec l’image Docker, passez -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output. Après l’enregistrement, le client lance le serveur lui‑même et communique avec lui via stdio, ainsi rien n’écoute sur un port réseau et le serveur n’envoie aucun contenu de document à un service cloud.

Limites honnêtes

  • Mode d’évaluation. Sans licence, un badge d’essai est apposé en haut de chaque page, de sorte que la sortie annotée n’est pas distribuable. Demandez d’abord « What is the license status of the annotation server? » ; l’agent appelle get_license_status.
  • Le placement est approximatif sans aide. Un agent qui devine x/y à partir d’une invite place une annotation area ou point de façon approximative. Lisez d’abord ou rendez d’abord pour un placement précis.
  • Aperçu sous Linux. generate_pages_preview échoue actuellement pour les fichiers PDF sous Linux, y compris l’image Docker (TypeInitializationException pour Gdip : System.Drawing.Common n’est pas pris en charge sur les plateformes non Windows) ; les documents Word et autres Office sont rendus, et sous Windows avec dnx chaque format est rendu. Les dix autres outils ne sont pas affectés.

FAQ

Claude peut‑il ajouter des commentaires à un PDF ? Oui, via un serveur MCP qui expose un outil d’annotation. Avec GroupDocs.Annotation.Mcp l’agent appelle add_annotation et le commentaire est écrit dans <name>_annotated.pdf.

L’IA doit‑elle télécharger mon document pour l’annoter ? Non, pas via le serveur : il ouvre le fichier dans votre dossier monté et enregistre la copie annotée à côté. Seul ce que le modèle voit lui‑même, comme le texte que vous collez ou les images de pages que l’agent consulte, est envoyé à votre fournisseur de modèle.

Fonctionne‑t‑il sur Word et Excel, pas seulement sur PDF ? Oui. Les mêmes types d’annotation fonctionnent sur PDF, DOCX, XLSX, PPTX et les images, avec les plus de 50 formats listés dans la documentation.

Approfondir