Каждая организация работает с документами — и со хрупкими скриптами, которые перемещают их между форматами. Отчёты Word превращаются в PDF, таблицы — в CSV, сканы — в файлы с возможностью поиска. Каждый новый формат или правило требует переписывания конвейера. Есть более гибкий способ: позволить AI‑агенту выполнять конвертации на вашей собственной инфраструктуре, используя предоставленные им инструменты. В этой статье показано, как построить именно это с помощью n8n, Model Context Protocol (MCP) и GroupDocs.Conversion MCP server — при этом ваши документы (и, при желании, ваша AI‑модель) полностью находятся в вашем дата‑центре.

From hardcoded pipelines to agentic automation

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

Agentic‑рабочий процесс кодирует что вам нужно. Вы формулируете цель — «конвертировать эти отчёты в PDF, но сначала проверить количество страниц» — и предоставляете набор инструментов. AI‑агент решает, какие инструменты вызвать и в каком порядке, и адаптируется к результату. Добавляете инструмент — и агент может сразу им пользоваться без переписывания кода. Эта адаптивность и есть главная идея.

What is MCP, and why it matters here

Сложная часть агентов, использующих инструменты, всегда была в интеграции — каждый агент общался с каждым инструментом по‑разному. Model Context Protocol — это открытый, нейтральный к поставщикам стандарт, который решает эту проблему: любой MCP‑совместимый агент может обнаружить и вызвать любые возможности MCP‑сервера. Можно сравнить с «USB‑C для AI‑инструментов».

GroupDocs публикует операции с документами как MCP‑серверы. GroupDocs.Conversion сервер предоставляет три инструмента, которые может вызвать агент:

Инструмент Что делает
convert Конвертировать документ в другой формат (PDF, DOCX, XLSX, PPTX, HTML, PNG, CSV… более 70 форматов)
get_document_info Просмотреть файл — тип, количество страниц, свойства — перед выполнением действия
get_supported_formats Узнать, какие конвертации возможны

Поскольку сервер работает по MCP, вашему агенту не нужна кастомная интеграция с GroupDocs. Он просто видит инструменты.

The architecture (all open-source, bring your own LLM)

Слой Компонент Роль
Оркестрация n8n (self‑hosted) триггеры, узел AI‑Agent, маршрутизация файлов
Рассуждение Your LLM, через узел Chat Model в n8n решает, какие инструменты вызвать — полностью заменяемый
Инструменты GroupDocs.Conversion MCP (stdio) за supergateway convert, get_document_info, get_supported_formats
Хранилище общий Docker‑том как файлы поступают и выходят

Ключевой выбор дизайна: LLM заменяемый. Узел Chat Model в n8n не привязан к провайдеру, поэтому агент и MCP‑инструменты не меняются при замене модели. В примере ниже используется OpenAI, но тот же рабочий процесс работает с Azure OpenAI, Anthropic, AWS Bedrock — или полностью самохостинговой моделью (Ollama, vLLM), когда требуется полностью изолированное развертывание, где документы и AI находятся внутри вашей сети.

Один момент интеграции: Conversion MCP — это лёгкий stdio‑сервер (по умолчанию безопасный, без сети). Поскольку n8n подключается к MCP‑инструментам по URL, небольшой открытый stdio‑to‑SSE мост (supergateway) делает его доступным на порту. Сам сервер остаётся без изменений.

How the workflow runs

  1. Trigger — веб‑хук, входящее письмо, загрузка формы или наблюдаемая папка получает документ.
  2. Stage — n8n записывает файл в общую папку, откуда его читает MCP‑сервер.
  3. Reason — узел AI Agent в n8n (ваш Chat Model + Conversion MCP как инструмент) получает инструкцию вроде «Конвертировать report.docx в PDF и сообщить количество страниц». Он автономно вызывает get_document_info, затем convert.
  4. Deliver — n8n берёт сконвертированный файл из общего хранилища и направляет его дальше — по email, в объектное хранилище, SharePoint или в оригинальный ответ.

Агент выбирает инструменты и порядок их вызова. Именно это позволяет одному рабочему процессу обрабатывать «просто конвертировать», «конвертировать только если больше 10 страниц» или «конвертировать и суммировать».

Stand it up in minutes

Минимальный стек — два сервиса, использующие один том: конвертер (за мостом) и n8n:

services:
  conversion-mcp:                    # GroupDocs.Conversion MCP, exposed over SSE
    build: ./bridge                  # supergateway --stdio "groupdocs-conversion-mcp" --port 8000
    environment:
      GROUPDOCS_MCP_STORAGE_PATH: /data
      GROUPDOCS_LICENSE_PATH: /license/GroupDocs.Total.lic
    volumes: [ ./data:/data, ./gd-license:/license:ro ]
  n8n:
    image: n8nio/n8n:latest
    ports: ["5678:5678"]
    volumes: [ ./data:/data ]        # SAME folder — the file hand-off

Затем в n8n создайте агент из четырёх узлов: Chat Trigger, Chat Model (ваши учётные данные OpenAI), инструмент MCP Client, указывающий на http://conversion-mcp:8000/sse, и AI Agent, который их соединяет. Скопируйте файл в ./data, откройте чат и попросите агента его конвертировать.

Полный, готовый к запуску набор — docker-compose.yml, образ моста и импортируемый рабочий процесс n8n — находятся в сопутствующем открытом репозитории (см. ниже).

Licensing

Без лицензии GroupDocs.Conversion работает в режиме оценки: вывод содержит водяной знак, а использование может быть ограничено. Для продакшна разместите файл GroupDocs.Total.lic в смонтированной папке лицензий — вывод станет чистым и неограниченным. Вы можете request a temporary license, чтобы опробовать лицензированный вывод.

Why this fits the enterprise

  • Data sovereignty — документы и движок конвертации остаются в вашей инфраструктуре. Выбираете самохостинговую модель — и AI тоже остаётся внутри.
  • No lock‑in — каждый слой открыт или основан на стандартах (MCP). Свободно меняйте LLM, оркестратор или инструменты.
  • Auditability — каждое решение агента и каждый вызов инструмента фиксируются в виде воспроизводимого выполнения n8n.
  • Composability — это кумулятивное преимущество. Направьте тот же агент на другие MCP‑серверы GroupDocs — Redaction, Watermark, Metadata — и один запрос на естественном языке превратится в полноценный конвейер: «замести персональные данные, конвертировать в PDF, затем добавить водяной знак “Confidential”».

Get started

  • Companion open‑source demo: GroupDocs.Conversion.Agentic — клонируйте репозиторий, добавьте ваш LLM‑ключ, выполните docker compose up и начните общаться с вашими документами.
  • NuGet: GroupDocs.Conversion.Mcp
  • Docker image: ghcr.io/groupdocs-conversion/conversion-net-mcp
  • Learn more about MCP: modelcontextprotocol.io

Agentic автоматизация документов — это не далёкая идея, а решение, которое можно запустить командой docker compose up, построив его из компонентов, которые вы можете прочитать, разместить и доверять. Дайте вашим AI‑агентам возможность конвертировать документы на ваших условиях.