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 выступает сервером, а агент подключается к нему как клиент.
Как включить
Порядок такой.
- Открой Edit → Plugins, найди Unreal MCP и включи его. Вместе с ним нужен плагин All Toolsets.
- Перезапусти редактор.
- В консоли редактора выполни генерацию конфига для своего клиента:
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, так что осторожность сейчас окупается лучше энтузиазма. Попробовать Доку на этой связке можно бесплатно.