Чтобы автоматически брендинговать документы, дайте AI‑агенту одну постоянную инструкцию и позвольте ему вызывать локальный инструмент наложения изображений‑водяных знаков для каждого файла в папке исходящих. С сервером GroupDocs.Watermark.Mcp эта инструкция может быть одной строкой в файле правил, инструкцией проекта в Claude Code или подсказкой, которую вы вставляете в Cursor:
Разместите logo.png на каждой странице каждого файла в папке исходящих с непрозрачностью 25 %, затем перечислите полученные файлы.
Пошаговая версия с настройкой и устранением неполадок находится в документации: Как брендинговать документы с помощью логотипа‑водяного знака с использованием ИИ.
Почему ручной брендинг со временем отклоняется?
Брендинг, выполненный вручную, различается в зависимости от человека: одна команда вставляет логотип в исходный файл, другая ставит печать в PDF с полной интенсивностью, третья забывает. LLM, который «добавляет логотип», редактируя содержимое документа, также не имеет стабильного размещения. Инструмент add_image_watermark применяет логотип как объект водяного знака с явными значениями opacity и rotation, поэтому одинаковые входные данные дают одинаковую интенсивность и угол. Поскольку это объект, а не вставленное содержимое, логотип можно позже найти и удалить, когда бренд меняется.
Что решает агент, а что делает движок?
| Шаг | Решает агент | Делает движок |
|---|---|---|
| Какие файлы находятся в области | Читает папку и вашу инструкцию | Ничего |
| Какой инструмент вызвать | add_image_watermark для логотипа, add_watermark для статуса |
Ничего |
| Интенсивность и угол | Передаёт opacity и rotation из вашего стандарта |
Рисует знак точно с этими значениями |
| Вывод | Отчитывается о созданных файлах | Записывает новый файл; оригинал не изменяется |
Стандарт хранится в вашей подсказке. Сервер не планирует задачи сам и не имеет встроенной политики бренда; повторяемой частью является инструкция, которую вы сохраняете и повторно используете.
Как обеспечить соблюдение стандарта в пять шагов?
- Храните логотип рядом с документами. И документ, и изображение разрешаются по имени из папки хранилища (
GROUPDOCS_MCP_STORAGE_PATH). Используйте прозрачный PNG; логотип на белом прямоугольнике будет отображать этот прямоугольник на странице. - Разделяйте файлы исходящих. Установите
GROUPDOCS_MCP_OUTPUT_PATHв другую папку, если хотите хранить брендированные копии отдельно от исходных. Если не задано, вывод попадает в папку хранилища. - Проверьте лицензию. Спросите: «Каков статус лицензии сервера водяных знаков?» Агент вызывает
get_license_status. - Запустите стандартную подсказку. Непрозрачность от 0.2 до 0.4 — диапазон, который документация рекомендует для брендинга; выше 0.6 логотип доминирует на странице.
- Проверьте. Запросите проход
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 (dnx на Linux/macOS также требует libgdiplus), и оба используют одни и те же шесть инструментов, поэтому подсказка бренда не меняется между ними.
Каковы ограничения?
Планируйте с учётом двух ограничений. Во‑первых, инструмент предоставляет только opacity и rotation: нет настройки позиции, размера или отступов. Во‑вторых, режим оценки: страница лицензирования сервера указывает, что вывод без лицензии имеет ограничения оценки (точные ограничения указаны на странице лицензирования), поэтому брендированные копии, созданные без лицензии, не подлежат распространению. Выполните get_license_status перед развертыванием бренда. При почасовой лицензии каждый обработанный файл оплачивается, а при лицензии‑файле сервер работает офлайн. Также помните, что водяной знак лишь помечает документ; он не защищает содержимое под ним.
Часто задаваемые вопросы
Может ли ИИ добавить логотип нашей компании ко всем PDF?
Да. Запросите логотип по имени файла и укажите непрозрачность; агент вызывает add_image_watermark один раз для каждого файла. Тот же вызов работает и с Word, PowerPoint, Excel и файловыми изображениями.
Могу ли я использовать один и тот же логотип для изображений и документов?
Да. Изображения являются допустимыми целями, поэтому брендинг фотографий продукта работает так же, как брендинг PDF.
Что происходит, когда бренд меняется?
remove_watermarks может удалить старый логотип, поскольку он был применён как объект водяного знака. Его textFilter сопоставляет только текст водяного знака, поэтому удаление логотипа‑изображения приводит к удалению всех водяных знаков, включая текстовые. Сначала выполните поиск, чтобы узнать, что есть, затем добавьте новый логотип.
Углубиться
- Документация, каноническое руководство: Как брендинговать документы с помощью логотипа‑водяного знака с использованием ИИ
- Центр документации: GroupDocs.Watermark MCP Server
- Начните здесь: 3 способа пометить документы, сгенерированные ИИ, водяными знаками через MCP
- Связано: Наложить водяной знак на всю папку одной подсказкой
- Связано: Зачем проверять водяные знаки в своих документах перед их удалением
- On-premise и модель безопасности: 3 архитектуры обработки документов ИИ и та, которая хранит файлы внутри вашей сети
- Вопросы: форум GroupDocs Watermark
- Исходный код: GroupDocs.Watermark.Mcp на GitHub