“Rename ACME Corp to Globex in this contract” adalah pekerjaan tiga detik bagi seorang manusia dan jebakan bagi agen AI. Jalur yang jelas, membaca dokumen dan menulis yang baru, membuang gaya, batas tabel, header, dan keyakinan peninjau bahwa tidak ada yang lain yang berubah. Dengan server GroupDocs.Editor MCP yang berjalan secara lokal, Claude, Cursor, atau Copilot mengedit file alih‑alih mengetiknya kembali: mereka menemukan kata‑kata, menggantinya di tempat, mempertahankan format, dan memberi tahu berapa banyak yang diubah:

Ganti ACME Corp menjadi Globex Ltd dalam contract.docx dan pertahankan formatnya.

Versi langkah‑demi‑langkah dengan penyiapan, prompt, dan pemecahan masalah ada di dokumentasi: How to edit documents with AI agents using MCP.

Apa yang salah ketika model menulis ulang file?

Model bahasa tidak menyimpan sebuah .docx. Ia menyimpan teks. Ketika Anda memintanya untuk “memperbarui kontrak”, jalur alami adalah membaca kata‑kata, mengubahnya, dan menghasilkan dokumen baru dari salinannya sendiri. Tiga hal hilang dalam proses ini.

Pemformatan. Nama pihak yang ditebalkan, heading bernomor, garis kisi tabel, lebar kolom tabel biaya, footer dengan nomor halaman: tidak ada yang termasuk dalam teks yang dibaca model, sehingga tidak ada yang bertahan kecuali sesuatu yang membangunnya kembali.

Semua yang tidak diminta model untuk disentuh. Regenerasi berarti setiap kalimat melewati model lagi. Sebuah klausa dapat “dibersihkan”, sebuah angka diformat ulang, sebuah kalimat dihilangkan karena jendela konteks penuh. Peninjau kini harus membandingkan seluruh dokumen untuk mempercayai perubahan tiga kata.

Jejak audit. “Saya memperbarui kontrak” adalah balasan yang sama apakah model mengubah satu nama atau tujuh. Tidak ada hitungan, dan tidak ada cara membedakan edit yang hati‑hati dari yang yakin.

Server penyuntingan DOCX‑only yang sudah ada menyelesaikan masalah pertama untuk Word. Dua masalah lainnya, serta setiap format yang bukan Word, masih terbuka.

Seperti apa penyuntingan yang terarah?

Dua panggilan. Diambil dari GroupDocs.Editor.Mcp 26.10.0 terhadap perjanjian layanan sintetis di mana “ACME Corp” muncul tujuh kali:

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

Salinan yang disunting mempertahankan nama pihak yang ditebalkan, gaya heading, dan tabel biaya. Aslinya tidak tersentuh; hasilnya adalah file baru, contract_edited.docx, di folder penyimpanan.

Mengapa enam dan bukan tujuh?

Inilah detail yang layak dibaca dua kali. Kemunculan ketujuh “ACME Corp” berada di klausa pemberitahuan, di mana “ACME” dicetak miring dan " Corp" tidak. Di dalam file itu menjadi dua run pemformatan, dan replace_text hanya mencocokkan dalam satu run. Ia tidak menebak, dan tidak menggabungkan gaya untuk memaksa kecocokan; ia melaporkan enam, dan yang ketujuh tetap “ACME Corp”.

Itulah perilaku yang Anda inginkan dari alat yang menyunting kontrak. Hitungan yang lebih rendah dari yang Anda harapkan menjadi isyarat untuk memeriksa; penulisan ulang yang “lengkap” secara diam‑diam bukanlah yang diinginkan. Agen dapat melanjutkan dengan jalur lain yang ditawarkan server: mengekstrak bagian itu sebagai HTML, menyuntingnya, dan menyimpannya kembali. Postingan round‑trip membahasnya.

Panggilan‑panggilan, berurutan

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

Mengapa ini lebih dari sekadar trik Word

Panggilan yang sama bekerja pada worksheet, slide, PDF, atau file teks. Dalam pengujian kami, "worksheet": 1 mengganti nama pemasok pada lembar ringkasan anggaran dan membiarkan dua lembar lainnya tidak berubah; "slide": 1 melakukan hal yang sama pada deck presentasi. "format": "pdf" menyunting dan mengonversi dalam satu panggilan, sehingga “perbaiki nama dan kirimkan PDF” menjadi satu langkah. "regex": true menangani pola seperti string versi.

Sebelum menyunting, get_document_info memberi tahu agen apa yang sedang dihadapi: keluarga, jumlah halaman, worksheet atau slide, apakah file diproteksi kata sandi, dan format apa yang dapat disimpan. Agen yang hati‑hati memanggilnya terlebih dahulu, dan Anda dapat memintanya melakukannya.

Penyiapan

dnx GroupDocs.Editor.Mcp --yes

dengan GROUPDOCS_MCP_STORAGE_PATH mengarah ke folder yang dapat disunting agen, atau gambar Docker ghcr.io/groupdocs-editor/editor-net-mcp. Konfigurasi per‑klien ada di documentation hub. Apa yang berubah dalam mesin itu sendiri ada di GroupDocs.Editor for .NET 26.6 release notes.

Batasan jujur

  • replace_text mencocokkan dalam satu run pemformatan; frasa yang terpecah lintas gaya tidak ditemukan, dan hitungannya memperlihatkannya.
  • Tidak ada perubahan yang dilacak dan tidak ada komentar: hasilnya adalah salinan yang disunting, bukan redline.
  • Mode evaluasi: setiap output dimulai dengan baris banner evaluasi, workbook yang disimpan mendapat lembar kerja tambahan, dan hanya dua lembar kerja atau slide pertama yang dapat disunting. Server menolak yang ketiga dan menjelaskan alasannya.
  • Penyuntingan PDF adalah konversi ke HTML atau Word yang dapat disunting dan kembali; bukan penyuntingan PDF di tempat.

FAQ

Apakah agen akan menimpa file asli saya?
Tidak. Setiap penyuntingan menulis file baru, <name>_edited.<ext> secara default atau outputName yang Anda berikan, ke dalam folder penyimpanan.

Apa yang terjadi jika teks tidak ada dalam dokumen?
Tidak ada yang ditulis. Server membalas “found no matches … No file was written.”, sehingga agen dapat memberi tahu Anda alih‑alih mengembalikan salinan yang tidak berubah.

Apakah ini berfungsi tanpa Word terpasang?
Ya. Server berjalan secara lokal dengan mesin GroupDocs.Editor; tidak memerlukan instalasi Office dan tidak memerlukan unggahan.

Selami lebih dalam