You kunt een AI‑agent zijn beoordelingscommentaren in het document laten plaatsen in plaats van in de chat. De GroupDocs.Annotation.Mcp‑server laat een LLM in Claude, Cursor of GitHub Copilot highlights, notities en doorhalingen toevoegen aan een PDF‑, Word‑, Excel‑ of PowerPoint‑bestand, en schrijft deze lokaal op uw machine:

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

De stap‑voor‑stap‑versie met configuratie en foutopsporing staat in de documentatie: How to annotate documents with AI agents using MCP.

Waarom gaat AI‑feedback in een chatvenster verloren?

Vraag een assistent een contract te beoordelen en u krijgt een lijst: “Clausule 4 verschuift aansprakelijkheid, clausule 7 heeft een open datum.” Die lijst leeft in een gesprek. De collega die het contract volgende week opent, ziet er niets van, en u moet elk punt handmatig terugkopiëren naar de juiste alinea.

De agent is niet het probleem. Hij mist een manier om in het bestand te schrijven. Een beoordeling is alleen nuttig waar de lezer het tegenkomt, namelijk naast de tekst waarnaar wordt verwezen.

Hoe ziet de verkeerde aanpak eruit?

De gangbare omweg is om de documenttekst in een chat te plakken en om commentaren te vragen. Drie dingen gaan mis, en u kunt elk punt controleren op een eigen document:

  • De commentaren hebben geen positie. “Pagina 2, tweede alinea” is een beschrijving die u zelf moet oplossen.
  • Het resultaat is een transcript, geen leverbaar product. Er kan niets naar de volgende reviewer worden gestuurd behalve een screenshot of een geplakte bloktekst.
  • Het document blijft ongewijzigd, waardoor de review niet gefilterd, geteld of meegenomen kan worden naar de volgende versie.

Wat is de juiste aanpak: documenten annoteren met een AI‑agent?

Verdeel het werk naar waar elke partij goed in is. De agent begrijpt de instructie “markeer alles wat risico naar ons verschuift”. De engine schrijft een echte annotatie in het echte bestand. Het hulpmiddel dat het schrijven uitvoert is add_annotation. Het accepteert zeven annotatietypen: textfield, area, point, arrow, highlight, underline en strikeout. De argumenten zijn het bestand, het type, de tekst, een paginanummer (beginnend bij 1) en de x/y‑documentcoördinaten.

Het resultaat wordt opgeslagen als <name>_annotated.<ext> naast uw origineel. Het origineel wordt nooit aangepast. dezelfde aanroep werkt voor de meer dan 50 formaten die de engine ondersteunt, zodat een Word‑concept en een PDF op dezelfde manier worden gemarkeerd.

Welke tools zorgen voor correcte plaatsing?

Coördinaten zijn het zwakke punt van elke agent die de pagina niet kan zien, en de documentatie stelt dit duidelijk. Drie tools verminderen het giswerk:

  • get_document_info geeft het bestandstype, het aantal pagina’s en de grootte terug, plus per‑pagina breedte en hoogte wanneer de engine deze rapporteert, waardoor de agent een paginabox krijgt om over na te denken.
  • get_annotations levert bestaande annotaties met hun begrenzingsvakjes, die de agent als ankers kan gebruiken.
  • generate_pages_preview rendert een pagina als afbeelding zodat een vision‑capabel model de tekst kan lokaliseren voordat het annoteert. Het faalt momenteel voor PDF‑bestanden op Linux; zie de beperkingen hieronder.

Wat is de ene valkuil bij aaneengeschakelde annotaties?

Elke schrijfhulpmiddel slaat een nieuw bestand op. Een tweede annotatie moet worden toegepast op het bestand dat de eerste aanroep heeft geproduceerd, niet op het origineel, anders blijft de eerste annotatie achter in een bestand dat niemand opnieuw opent. Formuleer dit in de prompt:

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

Voorbeeldsessie (verkort)

Dit is een illustratie opgebouwd uit het gedocumenteerde gedrag van de tools, geen vastgelegde screenshot.

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.

Hoe start ik de annotatieserver in mijn AI‑client?

Om het als container te draaien, mount de map met uw documenten op /data:

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

Als u liever geen container gebruikt, installeer de .NET 10 SDK en start dnx GroupDocs.Annotation.Mcp --yes; op Windows is dit tevens het kanaal voor PDF‑paginapreviews. De hub‑pagina bevat kant‑klaar registratiesnippets voor Claude Desktop, Claude Code, VS Code met GitHub Copilot, Cursor, Windsurf en andere clients. Stel GROUPDOCS_MCP_OUTPUT_PATH in op een map anders dan de opslagmap voordat u bewerkingen op een geproduceerd bestand aaneenschakelt. Met de standaardinstelling (output landt in de opslagmap) faalt de tweede schrijfopdracht met being used by another process; met een aparte output‑map slagen add_reply, update_annotation en remove_annotations op het geproduceerde bestand allemaal. Met de Docker‑image geeft u -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output mee. Na registratie start de client zelf de server en communiceert via stdio, zodat er niets luistert op een netwerkpoort en de server geen documentinhoud naar een cloud‑service stuurt.

Eerlijke beperkingen

  • Evaluatiemodus. Zonder licentie wordt een proefbadge bovenaan elke pagina geplaatst, waardoor geannoteerde output niet verspreid mag worden. Vraag eerst “What is the license status of the annotation server?”; de agent roept get_license_status aan.
  • Plaatsing is benaderend zonder hulp. Een agent die x/y uit een prompt gokt, plaatst een area‑ of point‑annotatie benaderend. Lees eerst of render eerst voor precieze plaatsing.
  • Preview op Linux. generate_pages_preview faalt momenteel voor PDF‑bestanden op Linux, inclusief de Docker‑image (TypeInitializationException voor Gdip: System.Drawing.Common wordt niet ondersteund op niet‑Windows platforms); Word‑ en andere Office‑documenten renderen wel, en op Windows met dnx rendert elk formaat. De andere tien tools blijven onaangetast.

Veelgestelde vragen

Kan Claude commentaren toevoegen aan een PDF? Ja, via een MCP‑server die een annotatietool blootlegt. Met GroupDocs.Annotation.Mcp roept de agent add_annotation aan en wordt het commentaar geschreven in <name>_annotated.pdf.

Moet de AI mijn document uploaden om het te annoteren? Nee, niet via de server: hij opent het bestand in uw gemonteerde map en slaat de geannoteerde kopie ernaast op. Alleen wat het model zelf ziet, zoals tekst die u plakt of paginabeelden die de agent bekijkt, gaat naar uw modelprovider.

Werkt het ook voor Word en Excel, niet alleen PDF? Ja. Dezelfde annotatietypen werken voor PDF, DOCX, XLSX, PPTX en afbeeldingen, met de meer dan 50 formaten die in de documentatie staan.

Ga dieper