You can have an AI agent put its review comments inside the document instead of in the chat. The GroupDocs.Annotation.Mcp server lets an LLM in Claude, Cursor or GitHub Copilot add highlights, notes and strikeouts to a PDF, Word, Excel or PowerPoint file, and it writes them locally on your machine:

Highlight the payment clause on page 2 and add a note asking legal to confirm.

The step-by-step version with config and troubleshooting is in the documentation: AIエージェントを使用したMCPでの文書への注釈付け方法.

チャットウィンドウでのAIフィードバックが失われるのはなぜですか？

アシスタントに契約書のレビューを依頼すると、次のようなリストが得られます。「第4条は責任を移転し、第7条は未確定の日付がある」このリストは会話の中に残ります。来週契約書を開く同僚は何も見えず、各ポイントを手作業で該当段落に戻さなければなりません。

エージェント自体が問題ではありません。ファイルに書き込む手段がないだけです。レビューは、読者がテキストの横で目にする場所にあるときに初めて有用です。

間違ったアプローチはどのようなものですか？

一般的な回避策は、文書のテキストをチャットに貼り付けてコメントを求めることです。次の3つの問題が発生し、実際の文書で確認できます。

  • コメントに位置情報がありません。「2ページ目の2段落目」は自分で解決しなければならない説明です。
  • 結果はトランスクリプトであり、納品物ではありません。次のレビュアーに送れるのはスクリーンショットか貼り付けたブロックだけです。
  • 文書自体は変更されないため、レビューをフィルタリングしたり、数えたり、次のドラフトに引き継いだりできません。

正しいアプローチ：AIエージェントで文書に注釈を付ける方法は？

それぞれの得意分野で作業を分担します。エージェントは「リスクを我々に転嫁するものをすべてフラグする」という指示を理解します。エンジンは実際のファイルに実際の注釈を書き込みます。書き込みを行うツールは add_annotation です。7種類の注釈タイプを受け付けます：textfield、area、point、arrow、highlight、underline、strikeout。引数はファイル、タイプ、テキスト、1ベースのページ番号、x/y の文書座標です。

結果は元のファイルの隣に <name>_annotated.<ext> として保存されます。元のファイルは一切変更されません。同じ呼び出しはエンジンが対応する50以上のフォーマットで動作するため、Word のドラフトでも PDF でも同様にマークアップできます。

どのツールが配置を正しくしますか？

ページを見ることができないエージェントにとって座標は弱点であり、ドキュメントでも明言されています。次の3つのツールで推測作業を減らせます。

  • get_document_info はファイルタイプ、ページ数、サイズに加えて、エンジンが報告できる場合はページごとの幅と高さを返します。これによりエージェントはページボックスを基に座標を算出できます。
  • get_annotations は既存の注釈とそのバウンディングボックスを返し、エージェントはそれをアンカーとして利用できます。
  • generate_pages_preview はページを画像としてレンダリングし、視覚モデルがテキスト位置を特定してから注釈を付けられるようにします。現在 Linux 上の PDF では失敗します。制限は下記をご参照ください。

連鎖的な注釈での唯一の罠は何ですか？

すべての書き込みツールは新しいファイルを保存します。2回目の注釈は、最初の呼び出しが生成したファイルに対して適用しなければなりません。元のファイルに対して行うと、最初の注釈は誰も再度開かないファイルに残ってしまいます。プロンプトに明示しましょう。

支払条項をハイライトし、結果として得られたファイルで古い納期を取り消す。

例示セッション（抜粋）

以下はツールの documented な動作を基にしたイラストであり、実際のスクリーンショットではありません。

You:   Highlight the payment clause on page 2 of contract.pdf and add a note
       asking legal to confirm.

Agent: [calls get_document_info on contract.pdf]
       contract.pdf is a PDF with 6 pages.
       [calls add_annotation: type=highlight, page=2, x=100, y=250,
        text="Legal to confirm these payment terms"]
       Added highlight annotation to contract.pdf on page 2.
       The annotated copy is contract_annotated.pdf. Your original is unchanged.

AIクライアントで注釈サーバーを起動するには？

コンテナとして実行する場合、文書が入ったフォルダーを /data にマウントします。

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

コンテナを使いたくない場合は .NET 10 SDK をインストールし、dnx GroupDocs.Annotation.Mcp --yes を起動します。Windows では PDF ページプレビューにもこのチャネルが使用されます。ハブページには Claude Desktop、Claude Code、VS Code with GitHub Copilot、Cursor、Windsurf などのクライアント向けに用意された登録スニペットがあります。編集チェーンを行う前に、GROUPDOCS_MCP_OUTPUT_PATH をストレージフォルダー以外に設定してください。デフォルト（出力がストレージフォルダーに入る）では、2回目の書き込みが being used by another process エラーで失敗しますが、別の出力フォルダーを指定すれば add_reply、update_annotation、remove_annotations がすべて成功します。Docker イメージを使用する場合は -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output を渡してください。登録後、クライアントはサーバーを自動で起動し stdio 経由で通信するため、ネットワークポートは開かれず、サーバーがクラウドサービスに文書内容を送信することもありません。

正直な制限

  • 評価モード。 ライセンスがない場合、すべてのページ上部に試用バッジがスタンプされるため、注釈付き出力は配布できません。最初に「注釈サーバーのライセンス状態は？」と尋ねてください。エージェントは get_license_status を呼び出します。
  • ヘルプなしでは配置が概算になる。 プロンプトだけで x/y を推測するエージェントは area や point 注釈を概算で配置します。正確な配置が必要な場合は、先にテキストを読むか、画像をレンダリングしてください。
  • Linux 上のプレビュー。 generate_pages_preview は現在 Linux の PDF で失敗します。Docker イメージでも同様です（TypeInitializationException for Gdip: System.Drawing.Common は非 Windows プラットフォームでサポートされていません）。Word やその他の Office 文書はレンダリング可能で、Windows の dnx ではすべてのフォーマットがレンダリングできます。他の10個のツールは影響を受けません。

よくある質問

Claude は PDF にコメントを追加できますか？
はい、MCP サーバーが注釈ツールを公開しているので可能です。GroupDocs.Annotation.Mcp を使用するとエージェントは add_annotation を呼び出し、コメントは <name>_annotated.pdf に書き込まれます。

AI が文書に注釈を付けるためにアップロードする必要がありますか？
いいえ、サーバー経由ではアップロードしません。エージェントはマウントされたフォルダー内のファイルを開き、注釈付きコピーを隣に保存します。モデルプロバイダーに送られるのは、貼り付けたテキストやエージェントが閲覧したページ画像など、モデルが直接見るものだけです。

PDF だけでなく Word や Excel でも動作しますか？
はい。同じ注釈タイプは PDF、DOCX、XLSX、PPTX、画像など 50 以上のフォーマットで利用可能です。詳細はドキュメントをご参照ください。

さらに深掘り