Вы можете позволить ИИ‑агенту помещать свои комментарии‑рецензии непосредственно в документ, а не в чат. Сервер GroupDocs.Annotation.Mcp позволяет LLM в Claude, Cursor или GitHub Copilot добавлять выделения, заметки и зачеркивания в файлы PDF, Word, Excel или PowerPoint и сохранять их локально на вашем компьютере:

Выделите пункт об оплате на странице 2 и добавьте заметку с просьбой юридическому отделу подтвердить.

Пошаговая версия с настройками и устранением неполадок находится в документации: How to annotate documents with AI agents using MCP.

Почему обратная связь ИИ в окне чата теряется?

Попросите помощника проверить договор, и вы получите список: «Пункт 4 переносит ответственность, пункт 7 содержит открытое дата». Список живёт в разговоре. Коллега, открывающий договор на следующей неделе, ничего не видит, и вам придётся вручную копировать каждый пункт в нужный абзац.

Агент не является проблемой. У него нет способа записать изменения в файл. Рецензия полезна только там, где её увидит читатель, то есть рядом с соответствующим текстом.

Как выглядит неправильный подход?

Распространённый обходной путь — вставить текст документа в чат и попросить дать комментарии. Происходит три ошибки, которые вы можете проверить на собственном документе:

  • Комментарии не имеют позиции. «Страница 2, второй абзац» — это описание, которое вам придётся разрешать самостоятельно.
  • Результат — транскрипт, а не готовый материал. Нельзя передать следующему рецензенту ничего, кроме скриншота или вставленного блока.
  • Документ остаётся неизменным, поэтому рецензию нельзя отфильтровать, подсчитать или перенести в следующую редакцию.

Каков правильный подход: аннотировать документы с помощью ИИ‑агента?

Разделите работу по тем областям, где каждая сторона сильна. Агент понимает инструкцию «отметьте всё, что переносит риск на нас». Движок записывает реальную аннотацию в реальный файл. Инструмент, который делает запись, — add_annotation. Он принимает семь типов аннотаций: textfield, area, point, arrow, highlight, underline и strikeout. Его аргументы — файл, тип, текст, номер страницы (нумерация с 1) и координаты x/y в документе.

Результат сохраняется как <name>_annotated.<ext> рядом с оригиналом. Оригинал никогда не изменяется. Один и тот же вызов работает со всеми более чем 50 форматами, поддерживаемыми движком, поэтому черновик Word и PDF аннотируются одинаково.

Какие инструменты обеспечивают правильное размещение?

Координаты — слабое место любого агента, который не видит страницу, и документация говорит об этом открыто. Три инструмента уменьшают догадки:

  • get_document_info возвращает тип файла, количество страниц и размер, а также ширину и высоту каждой страницы, если движок их сообщает, что даёт агенту «коробку» страницы для рассуждений.
  • get_annotations возвращает существующие аннотации с их ограничивающими рамками, которые агент может использовать как якоря.
  • generate_pages_preview рендерит страницу в виде изображения, чтобы модель с визуальными возможностями могла найти текст перед аннотированием. В данный момент она не работает для PDF‑файлов в Linux; см. ограничения ниже.

В чем одна ловушка при цепочечных аннотациях?

Каждый инструмент записи сохраняет новый файл. Вторая аннотация должна применяться к файлу, полученному после первого вызова, а не к оригиналу, иначе первая аннотация останется в файле, который никто больше не откроет. Укажите это в подсказке:

Выделите пункт об оплате, затем в полученном файле зачерните старую дату поставки.

Пример сеанса (сокращённый)

Это иллюстрация, построенная на задокументированном поведении инструментов, а не захваченный скриншот.

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 с GitHub Copilot, Cursor, Windsurf и других клиентов. Установите GROUPDOCS_MCP_OUTPUT_PATH в папку, отличную от папки хранилища, перед цепочкой правок над полученным файлом. При значении по умолчанию (вывод попадает в папку хранилища) вторая запись завершается ошибкой being used by another process; при отдельной папке вывода add_reply, update_annotation и remove_annotations над полученным файлом выполняются успешно. В образе Docker передайте -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output. После регистрации клиент сам запускает сервер и общается с ним через stdio, поэтому ни один процесс не слушает сетевой порт, и сервер не отправляет содержимое документа в облачный сервис.

Честные ограничения

  • Режим оценки. Без лицензии на каждой странице ставится значок «trial», поэтому аннотированный вывод нельзя распространять. Сначала спросите «What is the license status of the annotation server?», агент вызовет get_license_status.
  • Размещение приблизительно без помощи. Агент, который угадывает x/y из подсказки, размещает аннотацию area или point приблизительно. Сначала прочитайте или отрендерите для точного размещения.
  • Предпросмотр в Linux. generate_pages_preview в данный момент не работает для PDF‑файлов в Linux, включая образ Docker (TypeInitializationException для Gdip: System.Drawing.Common не поддерживается на платформах, отличных от Windows); Word и другие офисные документы рендерятся, а в Windows с dnx рендерится каждый формат. Остальные десять инструментов не затронуты.

ЧаВо

Может ли Claude добавлять комментарии в PDF? Да, через сервер MCP, который предоставляет инструмент аннотации. С GroupDocs.Annotation.Mcp агент вызывает add_annotation, и комментарий записывается в <name>_annotated.pdf.

Нуждается ли ИИ в загрузке моего документа для аннотирования? Нет, не через сервер: он открывает файл в вашей смонтированной папке и сохраняет аннотированную копию рядом. Только то, что видит сама модель (например, вставленный вами текст или изображения страниц, которые агент просматривает), отправляется провайдеру модели.

Работает ли это с Word и Excel, а не только с PDF? Да. Те же типы аннотаций работают с PDF, DOCX, XLSX, PPTX и изображениями, охватывая более 50 форматов, перечисленных в документации.

Углубиться