To batch convert a folder with an AI agent, point the GroupDocs.Conversion.Mcp server at the folder and describe the job in one sentence. The agent works through the files, calls the conversion engine once per document, and reports what it produced, all locally in Claude, Cursor or GitHub Copilot. It is batch processing driven by a sentence:

Перетворити всі DOCX у моїй папці документів у PDF, зберігши оригінали

З чого почати: папка сховища чи запит?

Почніть з папки сховища. Пакетна задача успішна або ні залежить від прив’язки папки, і ця прив’язка задається один раз у записі сервера, а не в кожному запиті. Два змінних середовища керують цим:

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

GROUPDOCS_MCP_STORAGE_PATH — це папка, яку агент може читати. GROUPDOCS_MCP_OUTPUT_PATH — це місце, куди потрапляють перетворені файли. При встановлених обох шляхах вихідна папка залишається недоторканою, а кожен результат потрапляє у converted. Це найчистіший варіант розташування для пакету. Команда dnx потребує .NET 10 SDK; Docker‑образ ghcr.io/groupdocs-conversion/conversion-net-mcp:latest монтує папку як /data. Перезапустіть Claude Desktop, Claude Code, VS Code або Cursor після реєстрації сервера.

Що робить перший запит?

Спочатку дайте агенту простий випадок:

Перетворити все у цій папці з DOCX у PDF.

Агент перебирає файли у папці та викликає інструмент convert для кожного файлу з параметром format: "pdf". Кожний виклик бере ім’я файлу зі сховища і повертає збережене ім’я файлу. Запустіть його двічі, і другий запуск створить нові, чітко названі файли поруч із першими.

Як додати фільтр або правило?

Запит — це шар оркестрації. Фільтрація, послідовність і політика помилок формулюються простою мовою:

Перетворити всі PDF у Markdown; пропустити файли, які вже перетворені.

Перетворити рахунки у PDF/A для архівування і перелічити будь‑який файл, який не вдався.

Створити PNG‑попередні перегляди кожної презентації.

Для послідовності агент може спочатку викликати get_document_info, який повертає тип файлу, кількість сторінок і базові властивості без конвертації:

Спочатку перевірити кількість сторінок у кожному PDF і конвертувати лише ті, у яких більше 10 сторінок.

Рішення «більше 10 сторінок» приймає агент; конвертація залишається завданням движка.

Що трапляється, коли один файл не вдається?

Коли движок не може конвертувати файл (наприклад, через непідтримуваний формат джерела або неправильний пароль), текст відповіді для цього файлу починається з операції та причини. Ім’я файлу, якого не існує, повертає список файлів, які сервер бачить, щоб агент міг виправити себе. Для захищених файлів convert приймає необов’язковий параметр password.

Ось чому політика помилок має бути в запиті: «перелічити будь‑який файл, який не вдався» змушує агента надати звіт в кінці виконання, тому помилка не проходить непоміченою. Прочитайте звіт і повторно запустіть лише невдалі файли.

Приклад сеансу

Це скорочений, ілюстративний сеанс. Імена файлів вигадані, а відповідь сформована на основі задокументованої поведінки, а не скріншоту.

You:    Convert the invoices to PDF/A for archiving, and list any file that failed.
Agent:  [enumerates the invoice files]
Agent:  [calls convert for each file, one at a time]
Agent:  Converted 11 files to the output folder.
        Failed: invoice-0412.docx (password-protected, no password given).

Як відстежувати прогрес у великій папці?

Агент зазвичай обробляє файли один за іншим, тому час виконання зростає разом із кількістю файлів і їх розміром. Для звітування про прогрес попросіть про це у запиті: «повідомляй мене після кожних десяти файлів» або «підведи підсумок в кінці». Кілька сотень документів працюють без проблем, а фінальний звіт розповідає, що сталося. Почніть з копії невеликої підмножини, перевірте два‑три результати візуально, а потім запустіть повну папку.

Що робити, якщо пакет повинен працювати без нагляду?

Сеанс агента потребує людини для запуску. Для запланованих конвеєрів n8n walkthrough демонструє інструмент робочих процесів, який керує тим самим сервером, а движок також можна скриптувати через бібліотеку GroupDocs.Conversion .NET. Використовуйте чат для ад‑хок пакетів, коли потрібно переглянути звіт.

Які обмеження?

  • Evaluation mode caps a batch at 15 documents. Без ліцензії один процес сервера може відкрити максимум 15 документів, а вихід містить водяний знак оцінки. Після цього подальші виклики завершуються помилкою, доки сервер не перезапуститься. Перевірте режим за допомогою get_license_status перед запуском реального пакету або запитайте «what is the license status of the conversion server?».
  • Metered licensing needs outbound access. При використанні метерних ключів використання повідомляється серверам GroupDocs, тому машина за фаєрволом повинна використовувати файл ліцензії. Вміст документів ніколи не надсилається.
  • Scans stay images. OCR не входить до складу сервера, тому пакет PDF‑файлів, що містять лише зображення, не отримає текстовий шар.

FAQ

How do I convert all DOCX files in a folder to PDF with AI?
Встановіть папку сховища, а потім попросіть агента виконати саме це в одному реченні. Він конвертує файли один за одним через локальний сервер, і нічого не завантажується.

Can an AI agent process an entire folder locally?
Так. Агент і сервер конвертації працюють на вашій машині, а файли читаються з ваших папок і записуються в них.

What is the best way to automate a document conversion pipeline?
Використовуйте чат для ад‑хок пакетів, які ви хочете переглянути. Для конвеєра, що запускається за розкладом, керуйте тим самим сервером через інструмент робочих процесів, наприклад n8n, або скриптуйте .NET‑бібліотеку.

Поглибити