ドキュメントに自動でブランドを付けるには、AI エージェントに 1 つの常駐指示を与え、アウトゴーイング フォルダー内のすべてのファイルに対してローカルで画像透かしツールを呼び出させます。GroupDocs.Watermark.Mcp サーバーを使用すれば、その指示はルール ファイルの 1 行、Claude Code のプロジェクト指示、または Cursor に貼り付けるプロンプトのいずれかにできます。

logo.png をアウトゴーイング フォルダー内の各ファイルのすべてのページに 25% の不透明度で配置し、生成したファイルを一覧表示してください。

設定とトラブルシューティングを含むステップバイステップ版はドキュメントにあります: AI を使用したロゴ透かしでドキュメントにブランドを付ける方法.

手動でのブランディングがずれる理由は？

手作業で適用されるブランディングは人によって異なります。あるチームはロゴをソース ファイルに貼り付け、別のチームは PDF にフル強度でスタンプを押し、さらに別のチームは忘れます。「ロゴを追加する」LLM はドキュメント内容を編集しますが、安定した配置はありません。add_image_watermark ツールはロゴを透かしオブジェクトとして適用し、明示的な opacity と rotation の値を持つため、同じ入力で同じ強度と角度が得られます。貼り付けたコンテンツではなくオブジェクトとして扱われるため、ブランドが変わったときにロゴを後から見つけて削除できます。

エージェントは何を決定し、エンジンは何を実行するのか？

ステップ エージェントの決定 エンジンの動作
対象となるファイルはどれか フォルダーと指示を読み取る なし
呼び出すツールはどれか add_image_watermark はロゴ用、add_watermark はステータス用 なし
強度と角度 標準から opacity と rotation を渡す その値で透かしを描画する
出力 生成されたファイルを報告する 新しいファイルを書き込み、元のファイルは変更しない

標準はプロンプト内にあります。サーバーは自らスケジュールせず、組み込みのブランドポリシーもありません。繰り返し可能なのは保存して再利用する指示だけです。

標準を5つのステップで徹底する方法は？

  1. ロゴをドキュメントの横に置く。 ドキュメントと画像はストレージ フォルダー (GROUPDOCS_MCP_STORAGE_PATH) から名前で解決されます。透過 PNG を使用してください。白い矩形上のロゴはページ上にその矩形が表示されます。
  2. アウトゴーイング ファイルを分離する。 ブランド化されたコピーをソースと分けて保存したい場合は GROUPDOCS_MCP_OUTPUT_PATH を別フォルダーに設定します。未設定の場合、出力はストレージ フォルダーに行きます。
  3. ライセンスを確認する。 「透かしサーバーのライセンス状態は何ですか？」と尋ねます。エージェントは get_license_status を呼び出します。
  4. 標準プロンプトを実行する。 不透明度は 0.2〜0.4 がドキュメントでのブランド推奨範囲です。0.6 を超えるとロゴがページを支配します。
  5. 検証する。 各生成ファイルに対して search_watermarks を実行し、期待する数と比較してください。

透かしにステータスも付加できますか？

はい、2 回目のチェーン呼び出しで可能です。1 回のリクエストでブランドとステータスを設定します。

ロゴを 25% の不透明度で追加し、次にその結果に CONFIDENTIAL テキスト透かしを追加してください。

各呼び出しは新しいファイルを書き込むため、「その結果に」 が両方の透かしを保持するポイントになります。

例示セッション（抜粋）

You:    Put logo.png on report.pdf at 30% opacity.
Agent:  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        Added image watermark from "logo.png" to "report.pdf"
You:    That is too strong - redo it at 0.2.
Agent:  [add_image_watermark: opacity 0.2, from the original report.pdf]
        Added image watermark from "logo.png" to "report.pdf"
        Two branded copies exist. Delete the 0.3 copy if you do not need it.

このように繰り返すのは安全です。各試行が新しいファイルになるため、不要になったものは後で削除してください。

チーム展開に適した配信チャネルはどれか？

共有セットアップの場合、Docker イメージを使用すると各マシンに何もインストールする必要がなく、ランタイムとネイティブ依存関係がすべて内部に含まれます。

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

NuGet チャネル (dnx GroupDocs.Watermark.Mcp --yes) は .NET 10 SDK が必要です。両方とも Windows、Linux、macOS 上で動作し（Linux/macOS の dnx には libgdiplus も必要）、同じ 6 つのツールを使用するため、ブランドプロンプトはどちらでも変わりません。

制限事項は何ですか？

2 つの制限を念頭に置いて計画してください。まず、ツールが公開するのは opacity と rotation のみで、位置、サイズ、余白の設定はありません。次に、評価モードです。サーバーのライセンスページでは、未ライセンスの出力には評価制限があると記載されています（正確な制限はライブラリの ライセンスページ にあります）。そのため、ライセンスなしで生成されたブランド化コピーは配布できません。ブランド展開の前に get_license_status を実行してください。従量課金ライセンスでは処理したファイルごとに課金され、ライセンスファイルを使用すればサーバーはオフラインで動作します。また、透かしはドキュメントにラベルを付けるだけで、下のコンテンツを保護するものではないことを覚えておいてください。

よくある質問

AI はすべての PDF に会社のロゴを追加できますか？
はい。ファイル名でロゴを指定し、不透明度を与えてください。エージェントはファイルごとに add_image_watermark を呼び出します。同じ呼び出しは Word、PowerPoint、Excel、画像ファイルでも機能します。

画像とドキュメントの両方で同じロゴを使用できますか？
はい。画像も有効な対象なので、製品写真へのブランド付けは PDF へのブランド付けと同様に行えます。

ブランドが変更された場合はどうなりますか？
remove_watermarks で古いロゴを除去できます。ロゴは透かしオブジェクトとして適用されているためです。textFilter はテキスト透かしのみを対象とするので、画像ロゴを除去するとすべての透かし（テキスト透かしも含む）が削除されます。まず検索して現状を把握し、次に新しいロゴを追加してください。

さらに詳しく