“Rename ACME Corp to Globex in this contract” is een taak van drie seconden voor een persoon en een valstrik voor een AI‑agent. De voor de hand liggende route, het document lezen en een nieuw document schrijven, gooit de stijlen, de tabelranden, de kopteksten en het vertrouwen van de reviewer dat er niets anders is verplaatst, weg. Met de GroupDocs.Editor MCP‑server die lokaal draait, bewerken Claude, Cursor of Copilot het bestand in plaats van het opnieuw te typen: ze vinden de woorden, vervangen ze, behouden de opmaak, schrijven een bewerkte kopie, en vertellen je hoeveel er zijn gewijzigd:

Hernoem ACME Corp naar Globex Ltd in contract.docx en behoud de opmaak.

De stapsgewijze versie met installatie, prompts en probleemoplossing staat in de documentatie: Hoe documenten bewerken met AI‑agents via MCP.

Wat gaat er mis wanneer het model het bestand herschrijft?

Een taalmodel bezit geen .docx. Het bezit tekst. Wanneer je het vraagt om “het contract bij te werken”, is de natuurlijke route om de woorden uit te lezen, ze te wijzigen en een nieuw document te produceren vanuit zijn eigen kopie. Drie dingen gaan daarbij verloren.

Opmaak. Vetgedrukte partijnamen, genummerde koppen, tabelrasterlijnen, de kolombreedtes van de kosten‑tabel, de lopende koptekst: niets daarvan maakt deel uit van de tekst die het model heeft gelezen, dus niets overleeft de reis tenzij iets het opnieuw opbouwt.

Alles wat het model niet gevraagd kreeg aan te raken. Regeneratie betekent dat elke zin opnieuw door het model gaat. Een clausule kan “opgeruimd” worden, een getal opnieuw geformatteerd, een zin weggelaten omdat het contextvenster vol is. De reviewer moet nu het hele document vergelijken om een wijziging van drie woorden te vertrouwen.

Het auditspoor. “Ik heb het contract bijgewerkt” is hetzelfde antwoord of het model één naam of zeven heeft gewijzigd. Er is geen telling en geen manier om een zorgvuldige bewerking van een zelfverzekerde te onderscheiden.

Hoe ziet een gerichte bewerking eruit?

Twee oproepen. Vastgelegd vanuit GroupDocs.Editor.Mcp 26.10.0 tegen een synthetische service‑overeenkomst waarin “ACME Corp” zeven keer voorkomt:

-> get_document_info {"file":{"filePath":"contract.docx"}}
<- { "family": "WordProcessing", "pageCount": 1, "canEdit": true,
     "canSaveTo": [ "docx", "doc", "rtf", "odt", "pdf", "md", ... ] }

-> replace_text {"file":{"filePath":"contract.docx"},
                 "find":"ACME Corp","replace":"Globex Ltd","wholeWord":true}
<- Replaced 6 occurrence(s) of 'ACME Corp' in 'contract.docx'
   Saved to: …/contract_edited.docx

-> replace_text {"file":{"filePath":"contract.docx"},
                 "find":"Initech","replace":"Globex Ltd"}
<- Text replacement found no matches for 'Initech' in 'contract.docx'.
   No file was written.

De bewerkte kopie behoudt de vetgedrukte partijnaam, de kopstijlen en de kosten‑tabel. Het origineel blijft onaangeroerd; het resultaat is een nieuw bestand, contract_edited.docx, in de opslagmap.

Die kopie wordt geschreven door de engine, niet byte‑voor‑byte gepatcht: de server opent het document in zijn HTML‑bewerkingsmodel, vervangt de tekst daar en slaat een nieuw bestand op. We hebben getest wat een Word‑document behoudt. Stijlen, tabellen, afbeeldingen, hyperlinks, bladwijzers, de koptekst, voetnoten en opmerkingen komen door. Op server 26.10.0 houdt de voettekst het niet, een content‑control wordt afgevlakt tot platte tekst, en een tracked change verliest zijn auteur. De volledige lijst, en de oplossing voor voetteksten, staat in de FAQ.

Waarom zes en niet zeven?

Dit is het detail dat je twee keer moet lezen. De zevende “ACME Corp” zit in de kennisgevingsclausule, waar “ACME” cursief is en “ Corp” niet. In het bestand zijn dat twee opmaak‑runs, en replace_text matcht binnen één run. Het raadde niet, en het voegde de stijlen niet samen om een match af te dwingen; het rapporteerde zes, en de zevende blijft “ACME Corp”.

Dat is het gedrag dat je wilt van een tool die contracten bewerkt. Een telling die lager is dan je verwacht, is een signaal om te controleren; een stilzwijgende “volledige” herschrijving is dat niet. De agent kan de andere route volgen die de server biedt: dat deel als HTML extraheren, bewerken en terug opslaan. De round‑trip‑post behandelt dit.

De oproepen, in volgorde

user              agent                        Editor MCP server
 |  "Rename ACME Corp to Globex Ltd in contract.docx"          |
 |---------------->|                                           |
 |                 |-- get_document_info {"file":...} -------->|
 |                 |<- WordProcessing, 1 page, canEdit --------|
 |                 |-- replace_text {"find":"ACME Corp",       |
 |                 |     "replace":"Globex Ltd",               |
 |                 |     "wholeWord":true} ------------------->|
 |                 |<- "Replaced 6 occurrence(s) ...           |
 |                 |    Saved to: .../contract_edited.docx" ---|
 |<- "6 changed; one more is split across formatting - check  |
 |    the notices clause. The original is kept."               |
      (a find that matches nothing: 'No file was written.')

Waarom dit meer is dan een Word‑truc

Dezelfde oproep werkt op een werkblad, een dia, een PDF of een tekstbestand. In onze test hernoemde "worksheet": 1 de leverancier op het samenvattingsblad van het budget en liet de andere twee bladen onaangeroerd; "slide": 1 deed hetzelfde op een beoordelingsdeck. "format": "pdf" bewerkt en converteert in één oproep, dus “fix de naam en stuur me een PDF” is één stap. "regex": true verwerkt patronen zoals versienummers.

Voor het bewerken vertelt get_document_info de agent waar hij mee te maken heeft: de familie, het aantal pagina’s, werkbladen of dia’s, of het bestand met een wachtwoord beschermd is, en naar welke formaten het kan opslaan. Een voorzichtige agent roept dit eerst op, en je kunt hem erom vragen.

Installatie

dnx GroupDocs.Editor.Mcp --yes

met GROUPDOCS_MCP_STORAGE_PATH dat wijst naar de map die de agent mag bewerken, of de Docker‑image ghcr.io/groupdocs-editor/editor-net-mcp (op Linux, voer het uit met --user "$(id -u):$(id -g)" zodat hij in jouw map kan schrijven). Per‑client configuratie staat in de documentatie‑hub. Wat er in de engine zelf is veranderd, staat in de GroupDocs.Editor for .NET 26.6 release notes.

Eerlijke beperkingen

  • replace_text matcht binnen één opmaak‑run; een frase die over stijlen is verdeeld wordt niet gevonden, en de telling laat dat zien.
  • Op server 26.10.0 laat replace_text de voettekst van een Word‑document weg in de bewerkte kopie, en vlakt content‑controls af. Gebruik de gepagineerde HTML‑round‑trip voor documenten waarvan de voettekst belangrijk is (details).
  • Geen redline: nieuwe bewerkingen worden niet bijgehouden. Bestaande opmerkingen en tracked changes blijven in de kopie.
  • Evaluatiemodus: elke output begint met een evaluatie‑bannerregel, opgeslagen werkboeken krijgen een extra werkblad, en alleen de eerste twee werkbladen of dia’s kunnen bewerkt worden; de server weigert de derde en legt uit waarom. Een PDF wordt twee pagina’s per oproep bewerkt.
  • PDF‑bewerking is een conversie naar bewerkbare HTML of Word en terug; het is geen in‑place PDF‑bewerking.

Veelgestelde vragen

Zal de agent mijn originele bestand overschrijven?
Nee. Elke bewerking schrijft een nieuw bestand, <name>_edited.<ext> standaard of de outputName die je opgeeft, naar de output‑map. Een naam die al bestaat krijgt een nummer, contract_edited (1).docx; er wordt niets overschreven.

Wat gebeurt er als de tekst niet in het document staat?
Er wordt niets geschreven. De server antwoordt “found no matches … No file was written.”, zodat de agent je kan informeren in plaats van een ongewijzigde kopie terug te geven.

Werkt het zonder Word geïnstalleerd?
Ja. De server draait lokaal met de GroupDocs.Editor‑engine; geen Office‑installatie en geen upload nodig.

Dieper duiken