あなたのサプライヤーが買収され、“ACME Corp” はすべての契約書、スケジュール、予算書、スライドデッキで “Globex Ltd” に置き換わっています。GroupDocs.Editor MCP サーバーをローカルで実行し、Claude Desktop、Cursor、または Copilot がバッチ処理として実行します:フォルダー内の各ファイルに対して replace_text を呼び出し、書式を保持し、変更した出現回数を報告し、古い名前が一度も記載されていないファイルには何も書き込みません。何もアップロードされず、元のファイルは上書きされません:
contracts フォルダー内のすべてのドキュメントで ACME Corp を Globex Ltd に名前変更し、書式を保持し、ファイルごとの件数を教えてください。
The step-by-step version is in the documentation: フォルダー内のドキュメント全体で書式を崩さずにテキストを検索・置換する方法.
なぜこれはモデルではなくツールの仕事なのか
結果は検証可能である必要があります。40 件のドキュメントを目視で差分確認するのは多すぎますし、すべての契約書を「更新した」モデルからは検証できるものが何も得られません。検索置換ツールはファイルごとの件数を提供します。その件数が監査証跡となり、どのファイルが変更されたか、どれだけ変更されたか、変更が不要だったファイルがどれかが分かります。
また、正しく「退屈」である必要があります。太字のパーティ名は太字のまま、料金表はグリッドを保ち、見出しはスタイルを保持します。モデルはドキュメントを再入力しません。エンジンが開いて単語を置換し、コピーを書き出します。サーバー 26.10.0 の一つの注意点として、そのコピーはエンジンの HTML 編集モデルから書き出されるため、Word の footer が反映されません。フッターにサプライヤー名が記載された契約書は、ページングされた HTML ラウンドトリップが必要です;FAQ では Word ドキュメントが保持するものが一覧されています。
エージェントが見るもの
GroupDocs.Editor.Mcp 26.10.0 を小規模な合成データセット(サービス契約書、NDA、歓迎状、3枚の予算シート、3枚のレビュー用スライドデッキ)に対して取得したものです。
-> replace_text {"file":{"filePath":"contracts/msa-northwind.docx"},
"find":"ACME Corp","replace":"Globex Ltd","wholeWord":true}
<- Replaced 6 occurrence(s) of 'ACME Corp' in 'msa-northwind.docx'
Saved to: …/msa-northwind_edited.docx
-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"}, ...}
<- Replaced 1 occurrence(s) of 'ACME Corp' in 'nda-northwind.docx'
-> replace_text {"file":{"filePath":"contracts/welcome-letter.docx"}, ...}
<- Text replacement found no matches for 'ACME Corp' in
'welcome-letter.docx'. No file was written.
-> replace_text {"file":{"filePath":"budget.xlsx"}, ..., "worksheet":1}
<- Replaced 1 occurrence(s) of 'ACME Corp' in worksheet 1 of 3 of
'budget.xlsx'
-> replace_text {"file":{"filePath":"review.pptx"}, ..., "slide":1}
<- Replaced 1 occurrence(s) of 'ACME Corp' in slide 1 of 3 of
'review.pptx'
エージェントのレポートは自動的に生成されます:契約書で 6 件、NDA で 1 件、歓迎状では 0 件、予算サマリーで 1 件、最初のスライドで 1 件です。
ループ
contracts/ + budget.xlsx + review.pptx
|
+-- for each file:
| replace_text {"find":"ACME Corp","replace":"Globex Ltd",
| "wholeWord":true} (+ "worksheet"/"slide")
| -> "Replaced N occurrence(s) ..." -> <name>_edited.<ext>
| -> "found no matches ... No file was written."
|
'-- report: file -> count; files with 0 listed separately
ループを確実にするための2つの習慣があります。名前には wholeWord: true を使用し、“ACME Corp” が “ACME Corporation Holdings” の内部でマッチしないようにします。また、エージェントに一致が0件のファイルを一覧させてください。変更が期待されたファイルで0件だった場合は、再確認すべき重要なポイントです。
置換前にバッチをチェックする
編集されたコピーは元のファイルと同じ場所に置かれ、別の処置を決めるまでそこに残ります。これがチェックのタイミングです。3つの簡易チェックでほぼすべての問題を捕捉できます。ファイルごとの件数を期待値と比較してください:すべてのページにサプライヤー名が記載された契約書が1件だけと報告されるべきではありません。同じ置換を再度実行することに依存しないでください:書式を跨いだフレーズは2回目でも見逃され、“found no matches” が全てクリアされたように見えます。エージェントに各編集コピーに対して extract_html を実行させてください。そのプレーンテキストプレビューは書式ランを結合するため、残っている “ACME Corp” がそこに表示されます。バリエーション表記(“Acme Corp.” のように句点付き、“ACME Corporation”)は matchCase: false または正規表現で別途処理してください。また、各タイプ(契約書、ワークブック、デッキ)から1つずつ編集ファイルを開き、書式とフッターが保持されていることを確認します。その後で _edited ファイルを元のファイルに上書きするか、ドキュメントシステムでバージョン管理してください。
同一呼び出しでパターン、ケース、フォーマットを指定する
名前変更は一般的なケースですが、同じツールで「表現を統一する」ファミリーの他のケースもカバーできます。同一テスト実行で:
-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"},
"find":"v2\\.3\\b","replace":"v2.4","regex":true,
"outputName":"nda-northwind-v2.4.docx"}
<- Replaced 1 occurrence(s) of 'v2\.3\b' in 'nda-northwind.docx'
-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"},
"find":"acme corp","replace":"Globex Ltd","matchCase":false,
"format":"pdf"}
<- Replaced 1 occurrence(s) of 'acme corp' in 'nda-northwind.docx'
Saved to: …/nda-northwind_edited.pdf
regex: true は .NET の正規表現を使用します。これによりバージョン番号の更新や日付フォーマットの変更をフォルダー全体に適用できます。matchCase: false は大文字小文字の不統一を検出します。format: "pdf" は編集と変換を同時に行い、相手側に渡すコピーを生成します。
コーディングエージェントへの余談
同じパターンはリポジトリでも機能します。DOCX のリリースノートや XLSX の仕様書は sed では見えませんが、このサーバーを使った Claude Code でバージョン文字列を両方同時に更新できます。プロジェクトの指示にこのルールを入れ、エージェントが手作業で Office ファイルを書き換えるのではなくツールを使用するようにしてください:
To change wording in .docx/.xlsx/.pptx/.pdf files in this repo, use the
groupdocs-editor MCP server's replace_text (wholeWord for names, regex for
versions). Report the count per file. Never rewrite an Office file by hand.
正直な制限事項
- マッチングは単一の書式ラン内でのみ行われます。契約書では、イタリック体の「ACME」を含む7番目の「ACME Corp」は置換されず、件数が6件であることから分かります。スタイルを跨いだフレーズは HTML ラウンドトリップが必要です。
- すべての結果は出力フォルダーのルートに
<name>_edited.<ext>として保存されます。元ファイルがサブフォルダーにあっても同様です。上書きは行われません。名前が衝突した場合は番号が付与されます(例:msa-northwind_edited (1).docx)。衝突が予想される場合はoutputNameを指定してください。 - サーバー 26.10.0 では、Word ドキュメントの編集コピーからフッターが失われ、コンテンツコントロールはプレーンテキストにフラット化されます。フッターに旧名称が含まれるドキュメントは必ず確認してください。
- スプレッドシートやプレゼンテーションは、呼び出しごとに1つのワークシートまたはスライドだけが編集されます。評価モードでは最初の2つだけが編集可能で、サーバーは次のように通知します:“Evaluation mode edits only the first 2 slides of a presentation; slide 3 is beyond them.”
- 評価モードではすべての出力にバナ―行が追加され、2ページを超える PDF は受け付けられません。
FAQ
Word、Excel、PowerPoint のテキストを一括で置換できますか?
はい。エージェントはファイルごとに同じツールを呼び出し、ワークブックには worksheet、デッキには slide を付加します。
どのファイルが変更されたかはどうやって知りますか?
各呼び出しは件数を返し、一致がなかったファイルは全く書き込まれません。エージェントにファイルごとの表を作成させてください。
元のファイルは上書きされますか?
いいえ。各編集は新しいファイルとして書き出され、元のファイルは自分で置き換えるまでそのまま残ります。
さらに深掘り
- Documentation, canonical how-to: フォルダー内のドキュメント全体で書式を崩さずにテキストを検索・置換する方法
- Documentation hub: GroupDocs.Editor MCP Server
- GroupDocs.Editor MCP 製品ページ — VS Code と Cursor 用のワンクリックインストール、他のすべてのクライアント用設定
- Start here: AI エージェントが文書を書き換えて3語だけ変更すべきでない理由
- Related: スプレッドシートから Word フォームをローカルで AI エージェントで埋める
- Related: 1つのワークシートだけ編集し、ブック全体は保持:HTML ラウンドトリップによる外科的編集
- Related: PDF を AI エージェントで編集しますか?まずローカルで Word に変換
- On-premise and security model: AI 文書処理の3つのアーキテクチャと、ファイルをネットワーク内に保持できるもの
- Questions: GroupDocs Editor forum
- Source: GroupDocs.Editor.Mcp on GitHub · NuGet package