フォルダー内のドキュメントに対して、1 回のプロンプトで透かしを付けることができます。AI エージェントがファイルを一覧表示し、ファイルごとに透かしツールを呼び出し、生成された結果を報告します。すべてローカルで実行され、アップロードは行われません。Claude Desktop、Claude Code、Cursor、または Windsurf でのリクエストは次のようになります。

フォルダー内のすべての PDF に対して斜めの DRAFT 透かしを追加し、生成したファイルを一覧表示してください。

設定とトラブルシューティングを含むステップバイステップ版は、ドキュメントにあります: How to batch-watermark a folder of documents with an AI agent.

なぜライフサイクル段階ごとにスタンプを付けるのか？

提案書は一度だけマークされることはほとんどありません。最初は DRAFT として始まり、同僚に回すと FOR REVIEW に変わり、承認されるとマークが外れます。30 ファイルにわたって手作業で行うのは、締め切り前に省かれるような作業です。GroupDocs.Watermark.Mcp を使用すれば、各段階は 1 文で表現でき、エージェントがスクリプトの代わりにループ処理を提供します。エンジンがフォーマットを処理するため、同じプロンプトで PDF、Word、Excel、PowerPoint、画像ファイルを 1 つのフォルダー内でカバーできます。

ステージ 1: すべてのファイルにドラフト透かしを追加する方法

GROUPDOCS_MCP_STORAGE_PATH をフォルダーに設定します。ファイルは名前で解決されるため、エージェントは proposal-01.pdf のようにパスではなく名前だけを渡します。その後:

フォルダー内のすべての PDF に対して斜めの DRAFT 透かしを追加し、生成したファイルを一覧表示してください。

エージェントはファイルごとに add_watermark を呼び出します。各呼び出しは新しい透かし付きコピーを保存し、元のファイルはそのまま残すので、ソースフォルダーは未透かしバージョンの記録として保持されます。

ステージ 2: レビュー用スタンプに切り替える方法

ステージ 1 の後、すべてのファイルに DRAFT が付いているので、マークを入れ替えます。テキストで古い透かしを削除し、結果に新しいスタンプを付けます。

このフォルダー内のすべてのファイルから DRAFT 透かしを削除し、各結果に FOR REVIEW 透かしを追加してください。

エージェントは remove_watermarks を textFilter に DRAFT を設定して呼び出し、続いて各クリーニング済みコピーに add_watermark を実行します。混在状態のフォルダー（一部のファイルに透かしが付いていて、付いていない場合）では、まずエージェントに次のように指示します。

すでに透かしが付いているものを除き、すべてのファイルに FOR REVIEW を付けてください。

エージェントは各ファイルに対して search_watermarks を実行し、透かしが見つかったものはスキップします。フォーマットごとに異なるマークを付けたい場合は、次のように指示します。

スライドデッキにはロゴを、PDF にはテキストマークを付けてください。

ステージ 3: 作業が承認されたときにマークをクリアする方法

承認により要件が逆転します。同じフォルダーで、あなた自身のドキュメントに対して次のように指示します。

このフォルダー内のすべてのファイルから DRAFT 透かしを削除し、残りの透かしはそのままにしてください。

これは remove_watermarks を textFilter に「DRAFT」を指定して実行することに相当します。フィルターは大文字小文字を区別しない部分文字列マッチで、フィルターを指定しない場合はエンジンが識別できるすべての透かしが削除されます。結果は <name>_unwatermarked.<ext> として保存されます。削除前に検索する方法の詳細は、下記の関連記事をご参照ください。

例示セッション（抜粋）

You:    Add a diagonal DRAFT watermark to every PDF in my documents
        folder, then list the files you produced.
Agent:  [add_watermark x 3: text "DRAFT", rotation -45]
        Added text watermark "DRAFT" to "proposal-01.pdf"
        Added text watermark "DRAFT" to "proposal-02.pdf"
        Added text watermark "DRAFT" to "proposal-03.pdf"
        Produced 3 watermarked copies. 0 failures.
        Originals are unchanged.

元のファイルと出力フォルダーはどうなる？

デフォルトでは、入力と出力が同じフォルダーを共有するため、透かし付きコピーは元ファイルの隣に配置されます。クリーンに分離したい場合は、GROUPDOCS_MCP_OUTPUT_PATH を別フォルダーに設定し、そこから配布します。いずれの場合も元ファイルは上書きされないため、ソースファイルが変更された後でもステージを再実行できます。再処理したいファイルを名前で指定してください。

バッチの正確性を保つには？

  • 生成されたファイルのリストを要求する。 「完了」だけの報告では、どのコピーを配布すべきかが不明になります。
  • 失敗を明示的に要求する。 フォルダーにエンジンが透かしを付けられない形式が混在している場合、エージェントはメッセージで失敗を返します。失敗リストを求めてください。
  • メーター制ライセンスに注意する。 メーター制ライセンスでは、ファイルごとに処理料が課金されます。
  • まずライセンスを確認する。 評価モードでのバッチは無駄な実行になります。

制限は何ですか？

評価モードが主な制限です。サーバーのライセンスページには「未ライセンスの出力は評価制限がある」と記載されており、正確な制限はライブラリの licensing page にあります。評価モードのコピーが入ったフォルダーは、配布できないドラフトの集合です。エージェントに get_license_status を実行させ、mode が evaluation、licensed、metered のいずれかであることを確認してください。また、組み込みのスケジューラはありません。サーバーはエージェントの指示で動作するため、定期的なジョブを実行するにはクライアントまたはタスクランナーが必要です。

FAQ

AI は複数の PDF に同時に透かしを付けられますか？
はい。エージェントはフォルダーを走査し、ファイルごとに add_watermark を呼び出し、生成したコピーを一覧します。各ファイルは個別に処理されます。

フォルダー内のすべてのドキュメントに CONFIDENTIAL を付けられますか？
はい。プロンプトで DRAFT を CONFIDENTIAL に置き換えてください。既にマークが付いているファイルをスキップするかどうかも明示してください。

ローカルでアップロードせずに一括透かし付けは可能ですか？
はい。サーバーはクライアントが起動するローカルプロセスであり、設定したフォルダーを読み書きします。

さらに詳しく