An AI‑агент має вибирати, який файл конвертувати і у який формат, а конвертаційний движок виконує саме перетворення. За допомогою сервера GroupDocs.Conversion.Mcp Claude, Cursor або GitHub Copilot викликають цей движок локально, на вашій машині, одним реченням:

Convert contract.docx to PDF

Покрокова інструкція з налаштуванням і усуненням проблем знаходиться в документації: How to convert documents with AI agents using MCP. У цьому дописі пояснюється, чому важливо розділити процес і де агент має залишатися поза шляхом.

Що йде не так, коли агент сам конвертує файл?

Модель, яка «конвертує» 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 повідомляє, чи працює сервер у режимі оцінки, з ліцензійним файлом чи у метричному режимі.

Відкриті підказки працюють, бо агент ланцюжить їх:

What formats can I turn this Visio file into? Then convert it to PDF.

Check the page count of whitepaper.pdf first, then convert it to 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.

Для повного циклу перегляньте the n8n walkthrough, який показує той самий движок, керований робочим процесом замість чату, а announcement охоплює сервер загалом.

Які існують обмеження?

  • Режим оцінки. Без ліцензії сервер додає водяний знак «evaluation» до конвертованого виходу і обмежує кожен процес сервера 15 відкритими документами; перезапуск сервера скидає лічильник. Спочатку запитайте у агента «what is the license status of the conversion server?», 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 для отримання точного списку для конкретного файлу.

Детальніше