“Rename ACME Corp to Globex in this contract” は人間にとっては 3 秒でできる作業であり、AI エージェントにとっては罠です。明らかな方法は文書を読み取り新しいものを書き出すことですが、スタイルや表の枠線、ヘッダー、そして他に何も変わっていないというレビュアーの確信が失われます。GroupDocs.Editor MCP サーバーをローカルで実行すると、Claude、Cursor、または Copilot が再入力せずにファイルを編集します:単語を見つけて置換し、書式を保持し、編集されたコピーを書き出し、何件変更したかを教えてくれます:

contract.docx の ACME Corp を Globex Ltd に変更し、書式を保持してください。

セットアップ、プロンプト、トラブルシューティングを含むステップバイステップバージョンはドキュメントにあります: MCP を使用した AI エージェントによるドキュメント編集方法

モデルがファイルを書き換えるときに起こる問題

言語モデルは .docx を保持しているわけではなく、テキストを保持しています。「契約書を更新して」と依頼すると、自然な流れは単語を読み取り、変更し、モデル自身のコピーから新しい文書を生成することです。その過程で 3 つの要素が失われます。

書式設定。 太字の当事者名、番号付き見出し、表のグリッド線、料金表の列幅、ランニングヘッダーなど、モデルが読んだテキストの一部ではないため、何も再構築しなければ旅路の途中で失われます。

モデルが触れるよう指示されていなかったすべて。 再生成はすべての文が再びモデルを通過することを意味します。句が「整形」されたり、数値が再フォーマットされたり、コンテキストウィンドウが埋まって文が削除されたりします。レビュアーは 3 語の変更だけを信頼するために文書全体の差分を取らなければなりません。

監査トレイル。 「契約書を更新した」という返答は、モデルが 1 つの名前を変更したのか 7 つ変更したのかを区別しません。件数もなく、慎重な編集と自信に満ちた編集を区別する方法もありません。

ターゲット編集はどのように見えるか

2 回の呼び出し。合成サービス契約書(「ACME Corp」が7回出現する)に対して GroupDocs.Editor.Mcp 26.10.0 から取得したものです:

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

編集されたコピーは太字の当事者名、見出しスタイル、料金表を保持します。元のファイルは変更されず、結果として contract_edited.docx という新しいファイルがストレージフォルダーに作成されます。

そのコピーはエンジンによって書き出され、バイト単位でパッチされるわけではありません。サーバーは文書を HTML 編集モデルで開き、テキストを置換して新しいファイルとして保存します。私たちは Word 文書が何を保持するかをテストしました。スタイル、テーブル、画像、ハイパーリンク、ブックマーク、ヘッダー、脚注、コメントはすべて引き継がれます。サーバー 26.10.0 では フッターは保持されず、コンテンツコントロールはプレーンテキストにフラット化され、トラッキングされた変更は作者情報を失います。完全なリストとフッターの回避策は FAQ にあります。

なぜ6件で7件ではないのか

これは二度読む価値のある詳細です。7 番目の “ACME Corp” は通知条項にあり、“ACME” がイタリック体で " Corp" が通常体です。ファイル内ではこれらは 2 つの書式ランとして扱われ、replace_text は 1 つのラン内でのみ一致します。推測もせず、スタイルをマージして強制的に一致させることもせず、6 件と報告し、7 番目は依然として “ACME Corp” のままです。

これは契約書を編集するツールに求められる動作です。期待した数より少ないカウントは調査のきっかけとなり、黙って「完了」した書き換えではありません。エージェントはサーバーが提供する別のパス、すなわち該当部分を HTML として抽出し、編集して再保存することができます。詳細は round‑trip post を参照してください。

呼び出しの順序

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

これが単なる Word のトリック以上である理由

同じ呼び出しはワークシート、スライド、PDF、テキストファイルでも機能します。テストでは、"worksheet": 1 が予算のサマリーシートのサプライヤー名を変更し、他の 2 シートはそのままにしました。"slide": 1 もレビュー用デッキで同様に動作しました。"format": "pdf" は編集と変換を一度の呼び出しで行うため、“名前を修正して PDF を送って” という操作が一ステップで完了します。"regex": true はバージョン文字列などのパターンを処理します。

編集前に get_document_info はエージェントに対象の情報(ファミリ、ページ数、ワークシートまたはスライド数、ファイルがパスワード保護されているか、保存可能なフォーマット)を伝えます。慎重なエージェントはまずこれを呼び出し、必要に応じて指示を求めます。

セットアップ

dnx GroupDocs.Editor.Mcp --yes

GROUPDOCS_MCP_STORAGE_PATH をエージェントが編集できるフォルダーに設定するか、Docker イメージ ghcr.io/groupdocs-editor/editor-net-mcp(Linux の場合は --user "$(id -u):$(id -g)" を付けてフォルダーに書き込めるように実行)を使用します。クライアントごとの設定は ドキュメントハブ にあります。エンジン自体の変更点は GroupDocs.Editor for .NET 26.6 リリースノート に記載されています。

正直な制限事項

  • replace_text は 1 つの書式ラン内でのみ一致します。スタイルが分割されたフレーズは見つからず、カウントに反映されます。
  • サーバー 26.10.0 では、replace_text は Word 文書のフッターを編集コピーから除去し、コンテンツコントロールをフラット化します。フッターが重要な文書はページングされた HTML ラウンドトリップを使用してください(詳細)。
  • 赤字(変更履歴)はありません:新しい編集はトラッキングされません。既存のコメントや変更履歴はコピーに残ります。
  • 評価モード:すべての出力は評価バナーメッセージで始まり、保存されたワークブックには余分なシートが追加され、最初の 2 シートまたはスライドしか編集できません。3 枚目はサーバーが拒否し理由を返します。PDF は呼び出しごとに 2 ページずつ編集されます。
  • PDF 編集は編集可能な HTML または Word への変換と戻すプロセスであり、インプレースでの PDF 編集ではありません。

FAQ

エージェントは元のファイルを上書きしますか?
いいえ。すべての編集は新しいファイル <name>_edited.<ext>(デフォルト)または指定した outputName として出力フォルダーに保存されます。既に同名が存在する場合は contract_edited (1).docx のように番号が付けられ、上書きはされません。

テキストが文書に存在しない場合はどうなりますか?
何も書き込まれません。サーバーは “found no matches … No file was written.” と返すので、エージェントは変更がなかったことを通知できます。

Word がインストールされていなくても動作しますか?
はい。サーバーはローカルで GroupDocs.Editor エンジンを使用して動作するため、Office のインストールやアップロードは不要です。

さらに深掘り