An AI agent should choose which file to convert and which format to convert it to, and a conversion engine should do the converting. With the GroupDocs.Conversion.Mcp server, Claude, Cursor or GitHub Copilot call that engine locally, on your machine, from one sentence:

Convert contract.docx to PDF

The step‑by‑step version with config and troubleshooting is in the documentation: Как конвертировать документы с помощью ИИ‑агентов, используя MCP. This post explains why the split matters and where the agent should stay out of the way.

Что происходит, когда агент конвертирует файл самостоятельно?

Языковая модель, которая «конвертирует» PDF в Word, ничего не конвертирует. Она читает полученный контент и пишет новый контент в целевом формате. Всё, чего модель не видела, она не может воспроизвести: точный шрифт, геометрию колонок, разрыв страницы перед таблицей, имена стилей, от которых зависит шаблон Word. Полученный результат выглядит как конверсия, но представляет собой перепечатку.

Это и есть режим отказа, о котором речь в этой статье. Он тихий: вывод открывается без ошибок, поэтому никто не проверяет его, пока таблица не сместится или заголовок не потеряет стиль. Точность рендеринга — детерминированная работа движка, а не генерация.

Что должен решать агент, а что должна делать система?

Разделите задачу по линии между суждением и исполнением.

Вопрос Решает агент Система делает
Какие файлы находятся в области действия? Читает ваш запрос и папку хранилища Ничего
Какой целевой формат? Сопоставляет «сделать редактируемым» с DOCX, «архивировать» с PDF Ничего
Можно ли вообще конвертировать файл? Вызывает get_supported_formats и читает ответ Сообщает допустимые целевые форматы
Какой размер файла? Вызывает get_document_info и читает количество страниц Читает тип, количество страниц, свойства
Сам процесс конвертации Вызывает convert Создаёт вывод с помощью движка GroupDocs.Conversion
Что делать при ошибке Повторяет попытку, спрашивает вас или пропускает файл Возвращает причину в виде текста

Как подключить агент к системе локально?

Зарегистрируйте сервер один раз в вашем клиенте. Claude Desktop использует claude_desktop_config.json, Claude Code — claude mcp add, VS Code с GitHub Copilot — mcp.json, а Cursor — ~/.cursor/mcp.json. Сервер также поддерживает Visual Studio 2022, Windsurf, Cline, Codex CLI и JetBrains Rider. Пример записи для Claude Desktop:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

dnx требует .NET 10 SDK. Если предпочитаете Docker, самодостаточный образ — ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, запускается командой docker run --rm -i -v $(pwd)/documents:/data. Клиент общается с сервером через stdio: путь — агент, локальный сервер, локальная файловая система. Перезапустите клиент после регистрации.

Какой инструмент вызывается каждым запросом?

Сервер предоставляет четыре инструмента. Их названия буквальны; агенты ищут их, когда что‑то ломается.

  • convert конвертирует документ в другой формат и сохраняет результат в вашей папке хранения или вывода. Принимает file, format (например pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) и необязательный password.
  • get_supported_formats выводит список целевых форматов, в которые может быть преобразован данный исходный файл.
  • get_document_info возвращает тип файла, количество страниц и базовые свойства без конвертации.
  • get_license_status сообщает, работает ли сервер в режиме оценки, с файлом лицензии или в метered‑режиме.

Открытые подсказки работают, потому что агент цепляет их:

Какие форматы я могу получить из этого файла Visio? Затем конвертировать его в PDF.

Сначала проверь количество страниц в whitepaper.pdf, затем конвертировать его в DOCX.

Существующие файлы никогда не перезаписываются. Вторая конверсия того же файла получает отдельное имя, например report (1).pdf.

Пример сеанса

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

You:    Convert contract-draft.pdf to DOCX so I can edit it.
Agent:  [calls convert with file.filePath = "contract-draft.pdf", format = "docx"]
Agent:  Done. The converted file is saved as contract-draft.docx in your output folder.

Для полного цикла, пошаговое руководство n8n показывает тот же движок, управляемый рабочим процессом вместо чата, а анонс охватывает сервер в целом.

Каковы ограничения?

  • Режим оценки. Без лицензии сервер добавляет водяной знак оценки к конвертированному выводу и ограничивает каждый процесс сервера 15 открытыми документами; перезапуск сервера сбрасывает счётчик. Сначала спросите у агента «каков статус лицензии сервера конвертации?», get_license_status отвечает без обработки документа.
  • Отсутствие OCR. Сервер конвертирует документы, имеющие текстовый слой. Скан, сохранённый как PDF только с изображениями, не будет преобразован в редактируемый текст.
  • Конверсия, а не извлечение. Этот сервер преобразует целые документы. Для извлечения данных на уровне полей лучше использовать сопутствующий сервер GroupDocs.Parser.Mcp (доступный только как Docker‑образ), и многие конвейеры используют оба инструмента.

Вопросы и ответы

Может ли Claude конвертировать docx в pdf?
Да, при подключённом сервере конвертации. Claude вызывает convert с format: "pdf", и движок GroupDocs создаёт файл на вашей машине.

Загружаются ли мои файлы, когда агент их конвертирует?
Нет, с этим сервером этого не происходит. Он работает локально через stdio, и документы остаются в вашей папке хранения. Файл лицензии также читается с локального диска.

Какие форматы может конвертировать сервер?
Более 100 форматов документов, таблиц, презентаций, изображений, электронных писем, CAD и веб‑форматов — тот же набор, что и в библиотеке GroupDocs.Conversion .NET. Запросите get_supported_formats для получения точного списка для конкретного файла.

Углубиться