AIエージェントにスキャンしたページの赤字処理を依頼し、テキスト赤字が置き換えるものを見つけられない場合、そのページはクリーンではなく、検索できるテキスト層がありません。スキャンをローカルで赤字処理するには、エージェントは単語をマッチさせる代わりに redact_image_area で座標指定の領域を覆います。GroupDocs.Redaction.Mcp を Claude Desktop または Cursor に接続すると、リクエストは次のようになります:

scan.png の下部 3 分の 1 を黒いボックスで覆ってください。

設定とトラブルシューティングを含むステップバイステップ版はドキュメントにあります: AIエージェントでスキャンした文書と画像を赤字処理する方法.

スキャンでテキスト赤字が何も見つからないのはなぜですか？

スキャンは文書の画像です。その上の文字はピクセルで構成されているため、正規表現でマッチさせるものがありません。redact_text はスキャンされたページで置き換えるものを見つけられず、何も見つからないことは機密情報がないことと同じではありません。画像のみのファイルで結果が空の場合は「テキスト層がない」とみなし、ツールを切り替えてください。同様のことは写真、スタンプ、デジタル契約書の裏面にあるスキャンされた署名ページにも当てはまります。

ページの領域を覆うツールはどれですか？

redact_image_area はページの矩形領域を単色のボックスで覆い、顔や署名、スタンプなどの画像コンテンツを永久に隠します。ページ左上隅から測定したピクセル単位の x、y、width、height を受け取り、オプションで color（デフォルトは Black、または #FF0000 のような十六進値）を指定します。このツールはページ引数を取らず、ファイルと矩形だけを受け取るので、出力を開いてボックスがどこに配置されたか確認してください。数値がピクセルであるため、矩形を選ぶ前に画像またはページのサイズが必要です。

座標はどうやって取得しますか？

まずページサイズを取得します。get_document_info はファイルタイプ、ページ数、ページごとの幅と高さを返し、これにより「下部 3 分の 1」を実際の数値に変換できます。

scan.png のサイズはどれくらいですか？

次にエージェントに領域を指示します:

scan.png の下部 3 分の 1 を黒いボックスで覆ってください。

署名や顔など特定の要素の位置が必要な場合は、その座標が必要です。実用的な方法は2つあります。任意のビューアでページを開き、自分で座標を確認するか、エージェントにページ画像を返すサーバでページをレンダリングさせます。GroupDocs.Viewer.Mcp の render_page ツールは単一ページを PNG としてレンダリングし、インラインで返します。また、GroupDocs.Annotation.Mcp サーバはページプレビューを返すことができます（現在、Linux と Docker 上の PDF ファイルではプレビュー機能が失敗しますが、Word や他の Office 文書はレンダリングされ、Windows で dnx を使用すればすべての形式がレンダリングされます）。視覚対応モデルはその後ボックスを推定し、赤字処理を実行する前にあなたが確認します。

テキストとスキャンが混在した文書はどう扱いますか？

スキャンされた署名ページを含むデジタル生まれの契約書では両方のツールが必要で、redact_image_area は引数で特定のページを指定できません。作業を分けて行い、まずテキストを赤字処理し、スキャンされたページは画像として別個に領域赤字処理を行います。

contract.docx のメールアドレスを赤字処理し、次のステップで使用すべき保存ファイルを教えてください。

その後、最終出力のすべてのページを目視で確認してください。

典型的なスキャンワークフローはどのようなものですか？

有効な手順は次の通りです：ページサイズを読み取り、領域を決定し、覆い、結果を確認します。領域が明確でない場合は、まずページをレンダリングし、視覚対応モデルにボックスを提案させます。提案と最終座標をトランスクリプトに残すことで、ケースファイルをレビューする人が何が覆われ、なぜかを確認できます。領域による赤字処理は意図的に単純で、矩形だけを覆い、他は何も行いません。

このサーバは画像内のテキストを読み取りますか（OCR）？

いいえ。GroupDocs.Redaction.Mcp は赤字処理を行いますが、画像内のテキストを認識しません。これにより動作が予測可能になり、ぼやけた名前が名前でないと静かに判断するような信頼度閾値が介在しません。ワークフローでスキャンからテキストが必要な場合は、まずそれに特化したツールで抽出し、機密情報を判断した上で領域赤字処理を行ってください。サーバは画像内の名前の位置を教えることはできません。

例のセッション（抜粋）

You:    How big is scan.png?
Agent:  -> get_document_info(file: scan.png)
        The image is 1200 x 1600 pixels.
You:    Cover the bottom third of scan.png with a black box.
Agent:  -> redact_image_area(file: scan.png, x: 0, y: 1067, width: 1200, height: 533, color: Black)
        Saved the output file. Please open it and check that the box covers the area.

領域赤字処理はどうやって確認しますか？

出力のすべてのページを確認してください。対象としたページだけでなく、すべてです。20 ピクセル足りない領域赤字処理は失敗した赤字であり、応答テキストで知らせることはありません。これはパターンを再実行して自動化できない唯一のケースで、チェックは目視またはエージェントが見ることのできるレンダリングプレビューです。検証については別記事 Trust no redaction you haven’t verified で取り上げています。

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

ライセンスがない場合、サーバはプロセスごとに 1 文書と 1 回の赤字処理のみを許可し、置換は最大 4 回、さらにトライアルバッジが付与されます。スキャンの場合は 1 つのボックスのみということになり、3 つの領域が必要なページでも 1 つだけが処理され、処理済みのように見えます。まず get_license_status を実行してください。この上限はツールを試すためのもので、実務向けではありません。

  • PDF on Linux. Linux（Docker イメージを含む）では、redact_image_area と erase_metadata は現在 PDF ファイルで失敗します（PDF エンジンの画像処理は System.Drawing に依存しており、.NET は Windows のみでサポート）。Word 文書では両方とも動作し、redact_text は PDF で動作します。PDF の領域赤字処理とメタデータ削除は Windows で dnx を使用して実行してください。

FAQ

AI エージェントはスキャンした文書を赤字処理できますか？ はい、領域指定で可能です。redact_image_area で定義した矩形を覆うため、パターンマッチング用のテキストが存在しません。

Claude はスキャン画像から署名を削除できますか？ 署名の位置がビューアやレンダリングされたページプレビューで分かれば、Claude が赤字処理を指示できます。その後サーバはその矩形を単色のボックスで覆います。

スキャンや画像の領域を自動的に黒くするにはどうすればよいですか？ エージェントにファイルと矩形を渡すと、redact_image_area が呼び出されます。このツールはページ引数を持たないため、結果のすべてのページを目視で確認してください。

テキスト赤字がスキャンで何も変えないのはなぜですか？ スキャンや画像はテキストではなくピクセルで構成されているため、置換するものがありません。領域赤字処理を使用し、結果を目視で確認してください。

さらに深掘り