Все статьи
7 августа 2026 г.·4 мин чтения

MCP в Unreal Engine 5.8: как подключить ИИ-агента к своему проекту

В UE 5.8 появился встроенный MCP-сервер: как включить плагин Unreal MCP, сгенерировать конфиг клиента, что агент может делать в редакторе и почему сервер нельзя открывать наружу.

17 июня 2026 года вышел Unreal Engine 5.8, и вместе с ним — первый в индустрии встроенный MCP-сервер прямо в редакторе. Это значит, что внешний ИИ-агент может подключиться к открытому проекту и работать с ним: спавнить акторы, настраивать свет, собирать материалы, запускать тесты.

Фича помечена экспериментальной, и это не формальность. Разберём, как её включить и где проходят границы доверия.

Что именно появилось

Epic добавила плагин Unreal MCP. Он поднимает MCP-сервер внутри процесса редактора и выставляет часть движка наружу как набор инструментов протокола.

Что агент получает в распоряжение: создание акторов на уровне, настройку освещения, создание экземпляров материалов, инспекцию виджетов Slate, запуск автоматических тестов. То есть не «сгенерируй игру», а конкретные операции над открытым проектом.

Устройство самого протокола разобрано в статье что такое MCP — здесь важно, что Unreal выступает сервером, а агент подключается к нему как клиент.

Как включить

Порядок такой.

  1. Открой Edit → Plugins, найди Unreal MCP и включи его. Вместе с ним нужен плагин All Toolsets.
  2. Перезапусти редактор.
  3. В консоли редактора выполни генерацию конфига для своего клиента:
ModelContextProtocol.GenerateClientConfig ClaudeCode

Вместо ClaudeCode можно подставить Cursor, VSCode, Gemini, Codex или All, если хочешь получить конфигурацию сразу для всех.

По умолчанию сервер поднимается на http://127.0.0.1:8000/mcp. Порт и путь настраиваются.

Транспорт поддерживается не любой: только HTTP и Server-Sent Events. Ни stdio, ни WebSocket не работают. Если твой клиент умеет подключаться только через stdio — а так устроена изрядная часть примеров в интернете, — он к Unreal не подключится, и дело будет не в конфиге.

Про безопасность: читаем документацию буквально

Epic формулирует ограничения прямо, и их стоит процитировать, а не пересказывать. Плагин работает внутри процесса редактора, не имеет слоя аутентификации и не предназначен для удалённого использования. В документации сказано, что выставлять его за пределы локальной машины небезопасно.

Отсюда практические выводы.

Адрес 127.0.0.1 менять не нужно. Соблазн поставить 0.0.0.0, чтобы подключиться с ноутбука к машине с проектом, здесь обходится дороже обычного: у сервера нет пароля, а инструменты меняют содержимое проекта.

И второе: агент, подключённый к редактору, действует с правами редактора. Он может изменить уровень, ассеты, настройки. Экспериментальный статус означает, что поведение инструментов может поменяться между версиями, а откат в редакторе не всегда полный.

Как с этим работать, чтобы не потерять проект

Несколько правил, которые стоит завести до первой сессии.

Держи проект под системой контроля версий и коммить перед тем, как пускать агента. Это единственный надёжный способ отката: Ctrl+Z в редакторе не отменит серию операций, выполненных через API.

Начинай с операций, которые легко проверить глазами: расставить акторы по сетке, создать набор экземпляров материала, прогнать тесты. Пусть первая задача будет такой, где ошибка видна сразу.

Не давай агенту задачи вида «наведи порядок в проекте». Формулировка без границ на живом проекте — плохая идея независимо от того, насколько хорош агент.

Где здесь польза, а где хайп

Честно: спавнить акторы через агента — не то, ради чего стоит менять процесс. Мышкой быстрее.

Польза начинается на объёме и на рутине. Разложить сотню объектов по правилу. Создать пятьдесят экземпляров материала с разными параметрами по таблице. Прогнать тесты и собрать отчёт. Проверить, что на всех уровнях выставлены нужные настройки освещения. Это работа, где человек ошибается от скуки, а скрипт писать дольше, чем сделать руками один раз, — и вот здесь агент попадает точно.

Что делать, если проект локальный, а агент нет

Тут стоит остановиться, потому что момент неочевидный.

MCP-сервер внутри Unreal — локальный. Но агент, который к нему подключается, может быть облачным. Тогда в облако уходит то, что агент видит: структура проекта, имена ассетов, содержимое, которое он запрашивает через инструменты. Для личного пета-проекта это, скорее всего, неважно. Для проекта под NDA — критично.

Дока закрывает этот разрыв: это десктопный агент, который подключается к MCP-серверам и при этом может работать на локальной модели, скачанной прямо в приложении. Проект остаётся на машине целиком — и сам движок, и модель, которая с ним работает. Плюс агент видит не только Unreal через MCP, но и файлы проекта с терминалом: сборку, логи, скрипты.

Как подключаются MCP-серверы в целом, разобрано в статье про подключение MCP-сервера, а подборка полезных серверов — здесь.

С чего начать

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

Тема новая: запроса «unreal engine mcp» не существовало до весны 2025 года, а после релиза 5.8 он вырос втрое за месяц. Практики пока мало у всех, включая Epic, так что осторожность сейчас окупается лучше энтузиазма. Попробовать Доку на этой связке можно бесплатно.