AIエージェントに平易な言葉で指示するだけで、ドキュメントから機密データをマスク（赤字）できます。マスク処理はローカルで、ファイル内部で、あなたのマシン上で実行されます。GroupDocs.Redaction.Mcp を Claude Desktop、Claude Code、Cursor、または GitHub Copilot に接続すれば、1つのプロンプトで十分です。

case-file.pdf のすべてのメールアドレスをマスクし、保存したファイル名を教えてください。

設定やトラブルシューティングを含むステップバイステップのバージョンはドキュメントにあります: AIエージェントでドキュメントから機密データをマスクする方法.

なぜチャットモデルだけでドキュメントをマスクできないのか？

ドキュメントを読み取り新しいものを書き出す言語モデルは、書き換え（リライト）を行っているだけで、マスク（リダクション）ではありません。書き換えは出現を見逃したり、指示していない表現を変更したりし、元のファイルには一切触れません。PDF ビューアで黒い矩形を描くことも同様の欠陥があります。矩形の下のテキストはファイル内に残り、コピー可能です。エージェントは削除自体を行うべきではなく、パターンを提案してツールを呼び出し、エンジンがドキュメント内の該当テキストを置換すべきです。

これが GroupDocs.Redaction.Mcp における役割分担です。エージェントはパターンを提案し呼び出しを指示します。エンジンはそれらを正確に適用します。機密性を判断する分類器は存在しないため、動作はレビュー可能で、何が機密とみなすかの判断はすべてユーザーに委ねられます。

方法 1: パターンでテキストを置換

正規表現で記述できるものすべてに使用します：メールアドレス、国民識別番号、電話番号、口座番号、クライアント名など。エージェントは redact_text を呼び出し、パターンにマッチするテキストをドキュメント内で置換し、マスク済みのコピーを保存します。元のファイルはそのままです。

case-file.pdf の中で \b\d{3}-\d{2}-\d{4}\b にマッチするすべての文字列（米国の社会保障番号）をマスクしてください。実行する前にパターンを見せてください。

最初にパターンを確認させることは余分なやり取りの価値があります。読んだ正規表現は防御可能なマスクであり、緩い正規表現は意図以上に削除し、厳しい正規表現はデータを残す可能性があります。replacement パラメータのデフォルトは [REDACTED] で、出力のレビューが容易です。

期待結果: 出力フォルダーにマスク済みコピーが作成され、エージェントから保存されたファイル名が通知されます。

方法 2: テキストパターンが届かない場所をクリア

本文テキストをクリーンにしても、余白のコメントや作成者フィールドに人物名が残っていると、マスクが失敗する最も一般的なケースです。機密データは 4 つの場所に存在し、それぞれに専用ツールがあります。

データの所在場所 ツール
本文テキスト redact_text
スキャン、写真、署名 redact_image_area
コメントと付箋 redact_annotations
プロパティの作成者、会社、日付 erase_metadata

case-file.docx のすべての注釈を削除し、次に作成者、会社、日付のプロパティを消去してください。各ステップは前のステップで生成されたファイルに適用してください。

redact_annotations は注釈テキストを置換でき、deleteAll を指定すれば注釈を完全に削除します。erase_metadata は Author,Company,CreatedTime のようなカンマ区切りのフィールドリストを受け取り、デフォルトは All です。チェーン指示は重要で、各呼び出しは新しいファイルを書き出すため、元のファイルをステップ 2 に渡すエージェントはステップ 1 の成果を失います。

期待結果: チェーンの最終ステップで生成された最終ファイルが得られ、途中のすべてのファイル名がトランスクリプトに表示されます。

方法 3: プロンプト前にマスクし、会話に値を残さない

事前 LLM マスクとは、機密文字列が最初からホスト型モデルに届かないようにすることです。ドキュメントはマシン上に残りますが、会話は残りません。クラウドホスト型モデルを使用すると、エージェントの発言がモデルプロバイダーに送られ、マスク作業中に削除対象の文字列が含まれる可能性があります。「I redacted jane.smith@example.com」と言うだけで、保護したいアドレスが送信されてしまいます。

標準パターンを使用してクライアント名をマスクしてください。返信にマッチしたテキストを繰り返さないでください。

マスクツールは保存されたファイル名を返すだけで、マッチ件数は返しません。エージェントの返信に数値が含まれる場合は、たとえばマスク前に検索した結果など、ツール出力ではなくクロスチェックとして扱ってください。最も安全な設定はローカルモデルを実行し、情報が外部に出ないようにすることです。これにより、エンドツーエンドでローカルに完結するドキュメントマスク自動化が実現します。

期待結果: 返信に保存されたファイル名が示され、トランスクリプトに機密文字列は一切含まれません。

例示セッション（抜粋）

You:    Redact every email address in case-file.pdf and tell me which file you saved.
Agent:  I will use this pattern: [\w.+-]+@[\w-]+\.[\w.]+
        -> redact_text(file: case-file.pdf, pattern: ..., replacement: "[REDACTED]")
Agent:  Saved case-file_redacted.pdf.
You:    For case-file.docx, delete all annotations and clear the document properties.
Agent:  -> redact_annotations(file: case-file.docx, deleteAll: true)
        Saved the output file.
        -> erase_metadata(file: the file saved by the previous step, fields: "All")
        Saved the output file.

評価モードの制限は何ですか？

重要な実行の前に、これをはっきり述べておきます。ライセンスがない場合、サーバーは評価モードで動作します：プロセスあたり 1 文書、1 回のマスク、最大 4 回の置換、さらにトライアルバッジが付与されます。10 回出現するパターンは 4 回だけマスクされ、残りの 6 回はそのまま残りますが、出力はきれいに見えることがあります。この上限はデモ用のみです。未ライセンス実行の出力を決して配布せず、まず get_license_status を呼び出して確認してください: 「マスクサーバーのライセンス状態は何ですか？」

GDPR などの規制に結果が適合するかどうかは、最終的にユーザーが判断します。サーバーは指示された通りに削除し、提供されたファイル内で処理を行います。

  • PDF on Linux. Linux（Docker イメージを含む）では現在 redact_image_area と erase_metadata が PDF ファイルで失敗します（PDF エンジンの画像処理が System.Drawing に依存しており、.NET は Windows のみでサポート）。これらは Word 文書で動作し、redact_text は PDF で動作します。PDF の領域マスクとメタデータ消去は Windows 上で dnx を使用してください。

FAQ

Can Claude redact PII from a PDF without uploading it?
はい。MCP サーバーは AI クライアントの子プロセスとしてローカルの stdio で動作し、設定したフォルダー内のファイルを読み書きします。ただし、エージェントのチャット内容は依然としてクラウドモデルプロバイダーに送信される点に注意してください。

Does the agent decide what is sensitive?
いいえ。エージェントはパターンを提案し、ユーザーがレビューします。エンジンは提供されたパターンを正確に適用します。

How do I install it?
.NET 10 SDK を使用し、dnx GroupDocs.Redaction.Mcp --yes を実行してインストールし、GROUPDOCS_MCP_STORAGE_PATH をドキュメントが格納されたフォルダーに設定します。Docker を利用する場合は ghcr.io/groupdocs-redaction/redaction-net-mcp を使用します。

さらに深く