“Rename ACME Corp to Globex in this contract” ist ein dreisekündiger Job für einen Menschen und eine Falle für einen KI‑Agenten. Der offensichtliche Weg, das Dokument zu lesen und ein neues zu schreiben, verwirft die Stile, die Tabellenränder, die Kopfzeilen und das Vertrauen des Prüfers, dass sich sonst nichts verschoben hat. Mit dem GroupDocs.Editor MCP‑Server, der lokal läuft, bearbeiten Claude, Cursor oder Copilot die Datei, anstatt sie neu zu tippen: Sie finden die Wörter, ersetzen sie an Ort und Stelle, behalten die Formatierung bei und sagen Ihnen, wie viele sie geändert haben:

Rename ACME Corp to Globex Ltd in contract.docx und behalte die Formatierung bei.

Die schrittweise Version mit Einrichtung, Eingabeaufforderungen und Fehlersuche finden Sie in der Dokumentation: Wie man Dokumente mit KI‑Agenten mithilfe von MCP bearbeitet.

Was geht schief, wenn das Modell die Datei neu schreibt?

Ein Sprachmodell besitzt keine .docx. Es besitzt Text. Wenn Sie es bitten, „den Vertrag zu aktualisieren“, ist der natürliche Weg, die Wörter herauszulesen, zu ändern und ein neues Dokument aus seiner eigenen Kopie zu erzeugen. Drei Dinge gehen dabei verloren.

Formatierung. Fettdruck von Parteinamen, nummerierte Überschriften, Tabellenrasterlinien, Spaltenbreiten der Gebühren‑Tabelle, Fußzeile mit Seitenzahlen: nichts davon ist Teil des Textes, den das Modell liest, also überlebt es die Reise nicht, sofern nichts es wiederherstellt.

Alles, was das Modell nicht ändern sollte. Regeneration bedeutet, dass jeder Satz erneut durch das Modell läuft. Eine Klausel kann „aufgeräumt“ werden, eine Zahl neu formatiert, ein Satz weggelassen, weil das Kontextfenster voll ist. Der Prüfer muss nun das gesamte Dokument vergleichen, um einer dreibuchstabigen Änderung zu vertrauen.

Die Prüfspur. „Ich habe den Vertrag aktualisiert“ ist dieselbe Antwort, egal ob das Modell einen Namen oder sieben geändert hat. Es gibt keine Zählung und keinen Weg, eine sorgfältige Bearbeitung von einer selbstsicheren zu unterscheiden.

Die bereits existierenden DOCX‑nur‑Bearbeitungs‑Server lösten das erste Problem für Word. Die anderen beiden und jedes Format, das nicht Word ist, bleiben offen.

Wie sieht eine zielgerichtete Bearbeitung aus?

Zwei Aufrufe. Aufgezeichnet von GroupDocs.Editor.Mcp 26.10.0 gegen einen synthetischen Dienstleistungsvertrag, in dem „ACME Corp“ siebenmal vorkommt:

-> 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.

Die bearbeitete Kopie behält den fettgedruckten Parteinamen, die Überschriftsstile und die Gebühren‑Tabelle. Das Original bleibt unverändert; das Ergebnis ist eine neue Datei, contract_edited.docx, im Speicherordner.

Warum sechs und nicht sieben?

Das ist das Detail, das man zweimal lesen sollte. Das siebte „ACME Corp“ befindet sich in der Hinweis‑Klausel, wobei „ACME“ kursiv und „ Corp“ nicht kursiv ist. In der Datei sind das zwei Format‑Runs, und replace_text greift nur innerhalb eines Runs. Es hat nicht geraten und die Stile nicht zusammengeführt, um einen Treffer zu erzwingen; es meldete sechs, und das siebte bleibt „ACME Corp“.

Das ist das Verhalten, das Sie von einem Werkzeug erwarten, das Verträge bearbeitet. Eine niedrigere Zählung als erwartet ist ein Hinweis, nachzusehen; ein stillschweigendes „komplettes“ Umschreiben ist es nicht. Der Agent kann den anderen Pfad des Servers nutzen: den betreffenden Teil als HTML extrahieren, bearbeiten und wieder zurückspeichern. Der dazugehörige Round‑Trip‑Beitrag behandelt das.

Die Aufrufe, in Reihenfolge

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.')

Warum das mehr ist als ein Word‑Trick

Der gleiche Aufruf funktioniert auf einem Arbeitsblatt, einer Folie, einer PDF‑ oder einer Textdatei. In unserem Test hat "worksheet": 1 den Lieferanten im Zusammenfassungs‑Blatt des Budgets umbenannt und die anderen beiden Blätter unverändert gelassen; "slide": 1 tat dasselbe in einem Review‑Deck. "format": "pdf" bearbeitet und konvertiert in einem Aufruf, sodass „Namen korrigieren und mir ein PDF schicken“ ein Schritt ist. "regex": true verarbeitet Muster wie Versions‑Strings.

Vor der Bearbeitung teilt get_document_info dem Agenten mit, womit er es zu tun hat: Familie, Seiten‑, Arbeitsblatt‑ oder Folienzahl, ob die Datei passwortgeschützt ist und in welche Formate sie gespeichert werden kann. Ein vorsichtiger Agent ruft das zuerst auf, und Sie können ihn dazu auffordern.

Einrichtung

dnx GroupDocs.Editor.Mcp --yes

mit GROUPDOCS_MCP_STORAGE_PATH, das auf den Ordner zeigt, den der Agent bearbeiten darf, oder dem Docker‑Image ghcr.io/groupdocs-editor/editor-net-mcp. Pro‑Kunden‑Konfiguration finden Sie im Dokumentations‑Hub. Was sich in der Engine selbst geändert hat, steht in den GroupDocs.Editor for .NET 26.6 Release‑Notes.

Ehrliche Grenzen

  • replace_text greift nur innerhalb eines Format‑Runs; ein über mehrere Stile verteilter Ausdruck wird nicht gefunden, und die Zählung zeigt das.
  • Keine Nachverfolgung von Änderungen und keine Kommentare: Das Ergebnis ist eine bearbeitete Kopie, kein Rot‑Linien‑Dokument.
  • Evaluierungs‑Modus: Jede Ausgabe beginnt mit einer Evaluierungs‑Banner‑Zeile, gespeicherte Arbeitsmappen erhalten ein zusätzliches Arbeitsblatt, und nur die ersten beiden Arbeitsblätter bzw. Folien können bearbeitet werden. Der Server verweigert die dritte und gibt den Grund an.
  • PDF‑Bearbeitung ist eine Konvertierung zu editierbarem HTML oder Word und zurück; es ist keine In‑Place‑PDF‑Bearbeitung.

FAQ

Wird der Agent meine Originaldatei überschreiben?
Nein. Jede Bearbeitung schreibt eine neue Datei, <name>_edited.<ext> standardmäßig oder den von Ihnen angegebenen outputName, in den Speicherordner.

Was passiert, wenn der Text nicht im Dokument vorkommt?
Es wird nichts geschrieben. Der Server antwortet „found no matches … No file was written.“, sodass der Agent Ihnen das mitteilen kann, anstatt eine unveränderte Kopie zurückzugeben.

Funktioniert das ohne installierte Word‑Version?
Ja. Der Server läuft lokal mit der GroupDocs.Editor‑Engine; keine Office‑Installation und kein Upload nötig.

Tiefer einsteigen