Das Budget enthält drei Arbeitsblätter, und die Finanzabteilung möchte zwei Zellen im zweiten ändern. Das gesamte Arbeitsbuch einem KI‑Agenten zu übergeben, um „Q3 zu aktualisieren“, führt dazu, dass er alle drei neu erstellt. Mit dem lokal laufenden GroupDocs.Editor MCP‑Server extrahieren Claude, Cursor oder Copilot nur dieses Arbeitsblatt als editierbares HTML, nehmen die gewünschten Änderungen vor und speichern es in einer Kopie des ursprünglichen Arbeitsbuchs, sodass die anderen Blätter nie das Modell durchlaufen. Folien funktionieren auf dieselbe Weise:
In budget.xlsx, im Arbeitsblatt 2 (Q3), setze Travel auf 12 500 und benenne Training in „Training (external)“ um. Die anderen Blätter unverändert lassen.
Die schrittweise Anleitung findet sich in der Dokumentation: Wie man ein Arbeitsblatt oder eine Folie bearbeitet und wieder in das Original einfügt.
Warum nicht dem Agenten die gesamte Datei übergeben?
Weil ein Modell kein Arbeitsbuch halten kann. Es kann Text halten. Jedes Blatt, das Sie ihm geben, ist ein Blatt, das es „hilfreich“ neu formulieren könnte: Zahlen neu formatiert, eine Formel in ihren Wert umgewandelt, eine Spalte, die es nicht verstand, weggelassen. Selbst wenn nichts schiefgeht, können Sie das nicht aus der Antwort erkennen. Die Lösung ist die Begrenzung des Umfangs: Geben Sie dem Agenten exakt den Teil, den er ändern soll, und halten Sie den Rest außerhalb seiner Reichweite.
HTML ist die richtige Form für diesen Teil. Tabellen, Stile, Schriftarten und Bilder bleiben erhalten, Modelle können damit gut lesen und schreiben, und es lässt sich wieder auf die ursprüngliche Struktur abbilden. Klartext würde die Formatierung verlieren; das rohe .xlsx‑XML ist ein Labyrinth, das kein Agent bearbeiten sollte.
Der Rundweg
budget.xlsx (3 worksheets: Summary, Q3, Q4)
|-- extract_html {"file":{...},"worksheet":2} --> budget_worksheet2.html
| agent edits the HTML: Travel 9000 -> 12500,
| "Training" -> "Training (external)"
'-- save_from_html {"htmlFile":{"filePath":"budget_worksheet2.html"},
"format":"xlsx",
"sourceFile":{"filePath":"budget.xlsx"},
"worksheet":2}
--> budget-q3-revised.xlsx : worksheet 2 replaced, 1 and 3 untouched
evaluation mode: worksheets/slides 1-2 can be edited; the server refuses 3+
Was der Server zurückgab
Erfasst von GroupDocs.Editor.Mcp 26.10.0 gegen ein synthetisches Budget:
-> extract_html {"file":{"filePath":"budget.xlsx"},"worksheet":2}
<- Extracted worksheet 2 of 3 of 'budget.xlsx' as editable HTML
Saved to: …/budget_worksheet2.html
Next: edit the saved .html and call save_from_html to write it back
as DOCX, XLSX, PPTX, PDF or another format.
Preview (plain text): ... Cost centre Planned (EUR) Owner Hosting
57600 IT Support 14400 IT Travel 9000 Sales Training 6000 HR
-> save_from_html {"htmlFile":{"filePath":"budget_worksheet2.html"},
"format":"xlsx","sourceFile":{"filePath":"budget.xlsx"},
"worksheet":2,"outputName":"budget-q3-revised.xlsx"}
<- Saved 'budget_worksheet2.html' into a copy of 'budget.xlsx',
replacing worksheet 2 of 3 (XLSX)
Saved to: …/budget-q3-revised.xlsx
Das Öffnen des Ergebnisses bestätigt den Umfang: In Q3 ist Travel 12 500 und die Zeile lautet „Training (external)“; Hosting und Support sind unverändert; Summary und Q4 bleiben wie zuvor. Die ursprüngliche budget.xlsx wurde nicht verändert.
Die Werkzeuge adressieren Arbeitsblätter und Folien nach Nummer, nicht nach Namen; get_document_info liefert die Anzahl, weshalb die Eingabe „worksheet 2 (Q3)“ lautet. Die Extraktions‑Antwort enthält eine Klartext‑Vorschau, sodass der Agent prüfen kann, ob er das richtige Arbeitsblatt hat, bevor er etwas ändert, sowie eine „Next:“‑Zeile, die angibt, welcher Aufruf als Nächstes kommt. Agenten folgen diesen Hinweisen gut. Bei einer Folie kann die Vorschau mit dem Platzhalter‑Text des Masters beginnen („Click to edit Master title style“), sodass der Agent das HTML selbst prüfen sollte.
Folien und die eine Regel für Präsentationen
Dasselbe Paar funktioniert bei einer Präsentation: extract_html mit "slide": 2, bearbeiten, save_from_html mit "slide": 2 und dem Original als sourceFile. In unserem Durchlauf wurde Folie 2 eines dreifoligen Review‑Decks als HTML ausgegeben, „12 percent“ wurde zu „14 percent“, und sie kam als review-revised.pptx zurück, wobei Folien 1 und 3 intakt blieben.
Für PowerPoint ist sourceFile nicht optional. HTML allein enthält keinen Folien‑Master, und der Server weist darauf hin, anstatt ein defektes Deck zu erzeugen:
-> save_from_html {"htmlFile":{"filePath":"review_slide2.html"},
"format":"pptx"}
<- Save from HTML failed for 'review_slide2.html' (-> pptx): 'pptx' output
cannot be created from HTML alone; pass the original document as
'sourceFile'.
Die Meldung nennt das fehlende Argument, sodass ein Agent den Aufruf eigenständig korrigiert.
Wenn der Rundweg Find‑and‑Replace übertrifft
replace_text ist der kürzere Weg für ein Wort oder einen Namen. Der Rundweg ist für alles andere gedacht: mehrere Zellen gleichzeitig ändern, ein Label und eine Zahl gemeinsam umformulieren, eine Tabelle auf einer Folie neu strukturieren oder eine Phrase, die replace_text nicht erkennt, weil sie über zwei Formatierungs‑Runs verteilt ist. Außerdem liest der Agent so einen Teil, bevor er entscheidet, was geändert werden soll.
Lesen bevor Schreiben
Die erste Hälfte des Rundwegs ist allein schon nützlich. Ein Agent, der gefragt wird „Was ist für Reisen in Q3 geplant und wer ist dafür verantwortlich?“, kann das Q3‑Blatt extrahieren und aus dem HTML antworten, ohne etwas zu berühren, und ein Agent, der gleich bearbeiten will, sollte genau das zuerst tun: den Teil lesen, die beabsichtigte Änderung benennen und dann schreiben. Formulieren Sie diese Reihenfolge in Ihren Projekt‑Anweisungen, damit sie zum Standard wird:
To change a worksheet or slide, use the groupdocs-editor MCP server:
extract_html for that one part, edit the HTML, save_from_html with the
original as sourceFile and the same worksheet/slide number. Never rebuild
the whole workbook or deck. Say which cells or text you changed.
Die letzte Zeile ist am wichtigsten. „Ich habe Travel von 9000 auf 12500 geändert und Training in Q3 umbenannt“ ist eine Antwort, die ein Prüfer in Sekunden mit der Datei abgleichen kann.
Ehrliche Grenzen
- Im Evaluationsmodus können nur die ersten beiden Arbeitsblätter oder Folien bearbeitet werden, und der Server verweigert das dritte mit dem Grund: „Der Evaluationsmodus bearbeitet nur die ersten 2 sichtbaren Arbeitsblätter einer Arbeitsmappe; Arbeitsblatt 3 liegt außerhalb.“
- Unlizenzierte Saves sind Entwürfe: Das bearbeitete Blatt erhält oben eine Banner‑Zeile und die Arbeitsmappe bekommt ein zusätzliches Arbeitsblatt „Evaluation Warning“.
- Das extrahierte HTML eines unlizenzierten Laufs beginnt mit derselben Evaluierungs‑Zeile (die Vorschau oben zeigt sie), sodass der Agent die Zellen bearbeiten sollte, nicht diese Zeile.
- Arbeitsblatt‑ und Folien‑Nummern beginnen bei 1, versteckte werden mitgezählt. Eine versteckte Folie benötigt
showHidden: true; ein verstecktes Arbeitsblatt wird unabhängig vonshowHiddenabgelehnt, daher zuerst im Arbeitsbuch sichtbar machen.
FAQ
Ändert das Bearbeiten eines Blatts die anderen?
Nein. Das bearbeitete HTML ersetzt nur das von Ihnen benannte Arbeitsblatt in einer Kopie des Originals; der Rest wird aus der Quelldatei übernommen.
Kann ich das mit PowerPoint‑Folien machen?
Ja, mit "slide" anstelle von "worksheet" und dem Original, das als sourceFile übergeben wird, was für PowerPoint‑Ausgaben erforderlich ist.
Wohin wird das Ergebnis geschrieben?
In eine neue Datei im Speicherordner, hier budget-q3-revised.xlsx, weil wir outputName angegeben haben; das Original bleibt unverändert.
Weiterführendes
- Dokumentation, kanonische Anleitung: Wie man ein Arbeitsblatt oder eine Folie bearbeitet und wieder in das Original einfügt
- Dokumentations‑Hub: GroupDocs.Editor MCP Server
- GroupDocs.Editor MCP Produktseite — Ein‑Klick‑Installation für VS Code und Cursor, Konfigurationen für alle anderen Clients
- Einstieg: Warum ein KI‑Agent Ihr Dokument nicht komplett neu schreiben sollte, um drei Wörter zu ändern
- Verwandt: Einen Vertragspartner in 40 Verträgen umbenennen, ohne die Formatierung zu berühren
- Verwandt: Word‑Formulare aus einer Tabellenkalkulation mit einem KI‑Agenten ausfüllen, lokal
- Verwandt: Ein PDF mit einem KI‑Agenten bearbeiten? Zuerst in Word umwandeln, lokal
- On‑Premise‑ und Sicherheitsmodell: 3 Architekturen für KI‑Dokumentenverarbeitung und die, die Dateien innerhalb Ihres Netzwerks hält
- Fragen: GroupDocs Editor Forum
- Quelle: GroupDocs.Editor.Mcp auf GitHub · NuGet package