要自動為文件加上品牌標記，給 AI 代理一個固定指令，讓它在外發資料夾中的每個檔案本地呼叫影像浮水印工具。使用 GroupDocs.Watermark.Mcp 伺服器時，該指令可以是規則檔中的單行文字、Claude Code 中的專案指令，或是貼到 Cursor 的提示語：

在外發資料夾中的每個檔案的每一頁上放置 logo.png，透明度為 25%，然後列出您產生的檔案。

包含設定與故障排除的逐步說明位於文件中：如何使用 AI 為文件加上標誌浮水印.

為什麼手動加品牌會產生偏差？

手動加品牌的方式因人而異：有的團隊把標誌貼到原始檔案中，有的在 PDF 上以全強度蓋章，還有的會忘記。使用 LLM 透過編輯文件內容「加入標誌」同樣缺乏穩定的放置位置。add_image_watermark 工具會將標誌作為浮水印物件加入，並明確設定 opacity（不透明度）和 rotation（旋轉）值，因此相同的輸入會產生相同的強度與角度。因為它是物件而非貼上的內容，日後品牌變更時可以找到並移除該標誌。

代理決定什麼，引擎執行什麼？

步驟 代理決定 引擎執行
哪些檔案在範圍內 讀取資料夾與您的指令 無
呼叫哪個工具 add_image_watermark 用於標誌，add_watermark 用於狀態 無
強度與角度 從您的標準傳遞 opacity 與 rotation 以完全相同的值繪製標記
輸出 回報產生的檔案 寫入新檔案；原始檔案未被修改

標準寫在您的提示語中。伺服器不會自行排程，也沒有內建的品牌政策；可重複使用的部分是您保存並再次使用的指令。

如何以五個步驟強制執行標準？

  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，並將結果數量與預期值比較。

標記也能顯示狀態嗎？

可以，透過第二個串接呼叫。一次請求即可同時加上品牌與狀態：

在 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），且兩者使用相同的六個工具，因此品牌提示語在兩者之間不會改變。

有哪些限制？

請規劃兩項限制。第一，工具僅支援 opacity 與 rotation：沒有位置、大小或邊距設定。第二，評估模式：伺服器的授權頁面指出未授權的輸出會受到評估限制（具體限制請參閱函式庫的授權頁面），因此未取得授權而產生的品牌副本不可發佈。於品牌推廣前執行 get_license_status。在計量授權下，每處理一個檔案皆會計費；在授權檔案模式下，伺服器可離線運作。亦需記住，浮水印僅為文件加標籤，並不保護其下的內容。

常見問題

AI 能為所有 PDF 加上我們公司的標誌嗎？
可以。以檔名指定標誌並提供不透明度；代理會對每個檔案呼叫一次 add_image_watermark。相同的呼叫同樣適用於 Word、PowerPoint、Excel 以及影像檔案。

我可以在影像與文件上使用相同的標誌嗎？
可以。影像也是有效的目標，因此為產品照片加上品牌標誌的方式與為 PDF 加標誌相同。

品牌變更時會發生什麼？
remove_watermarks 可以移除舊的標誌，因為它是以浮水印物件的形式加入。其 textFilter 只匹配文字浮水印，因此移除影像標誌會同時移除所有浮水印（包括文字標記）。先搜尋以了解現有情況，然後再加入新標誌。

深入了解