Unity AI Open Beta: Как начать работу с МКП

May 11, 2026|5 Мин

Работа для Unity AI Open Beta. Металлический фиолетовый объект, похожий на полоску, наложенный на черный/фиолетовый градиентный фон.

Эта веб-страница была переведена с помощью машинного перевода для вашего удобства. Мы не можем гарантировать точность или надежность переведенного контента. Если у вас есть вопросы о точности переведенного контента, обращайтесь к официальной английской версии веб-страницы.

Нажмите здесь.

В сегодняшней статье, посвященной Unity AI Open Beta, узнайте, как подключить Claude Code, GitHub Copilot и других агентов ИИ напрямую к редактору Unity с сервером типового контекстного протокола (MCP) Unity.

MCP- сервер Unity AI открывает новый способ работы с агентами AI в вашем IDE. Вместо того, чтобы переключаться между редактором кода и Unity, вы можете подключать агентов, таких как Claude Code, Cursor, Windsurf или VS Code Copilot, напрямую к вашему запущенному проекту Unity – и позволить IDE получить полный контекст проекта, такой как осмотр сцен, чтение консольных выходов, редактирование сценариев и запуск действий редактора без необходимости копирования-вставки контекста.

В этом посте рассказывается о том, что такое MCP, как подключить агента, какие инструменты доступны и как его можно использовать для ускорения выполнения общих задач разработки, таких как исправление ошибок и управление сценами.

Что такое Типовой протокол?

Модельный протокол контекста (МКП) является открытым стандартом, позволяющим агентам ИИ структурированно взаимодействовать с внешними инструментами и источниками данных. MCP-сервер Unity реализует этот протокол таким образом, что любой MCP-совместимый ИИ-агент может подключиться к Unity Editor и взаимодействовать с ним, как с набором вызываемых инструментов.

Без MCP агент ИИ в IDE видит только то, что вы ему показываете: открытые файлы, вставленный код или ошибки, которые вы копируете. С помощью MCP он имеет доступ в реальном времени к состоянию выполнения вашего проекта Unity – иерархии сцен, GameObjects, значениям компонентов, настройкам сборки и консольным сообщениям – через стандартизированный протокол.

Официальный MCP-сервер Unity входит в пакет AI Assistant и требует подписки Unity (хотя кредиты Unity AI не расходуются).

Меню Unity MCP Server, показывающее настройки проекта. — Настройки проекта для MCP-сервера Unity

Предпосылки

Чтобы начать работу с MCP, окружение должно отвечать следующим требованиям:

Unity 6 (6000.0) или более поздняя версия с установленным пакетом AI Assistant
Совместимый с MCP клиент ИИ, такой как Claude Code, Cursor, Windsurf или Claude Desktop
Проект Unity связан с Unity Cloud
Активная пробная версия или подписка на Unity AI

How to integrated a AI Agent with Unity

Настройка Unity MCP занимает всего несколько минут. Вот полный процесс:

1. Проверка работы моста Unity MCP

В редакторе Unity перейдите в меню Правка > Настройки проекта > AI > Unity MCP. Проверьте, что Unity Bridge показывает Running (зеленый индикатор). Мост запускается автоматически при загрузке Редактора. Если он показывает Остановлен, выберите Пуск.

MCP- сервер Unity открыт в редакторе Unity. Пользователь проверяет, что Unity Bridge работает. — Успешно работает мост Unity

2. Настройка клиента ИИ

Раздел Интеграции на странице настроек Unity MCP может автоматически настроить поддерживаемые клиенты: развернуть Интеграции, выбрать клиента и Настроить. Поддерживаемые клиенты могут включать Claude Code, Cursor, Windsurf и Claude Desktop в зависимости от версии Unity MCP.

3. Добавить путь Relay вручную (если нужно)

Если вашего клиента нет в списке автонастройки, добавьте запись сервера, указывающую на двоичный файл Unity Relay. Relay устанавливается в ~ /. Unity/ Relay / when Unity start. Pass -- mcp как аргумент командной строки исполняемого файла Relay.

4. Одобрить связь в Unity

При первом подключении агента Unity показывает сообщение в режиме ожидания соединения. Перейдите в окно Правка > Настройки проекта > AI > MCP Unity, просмотрите данные клиента и выберите пункт Принять. Ранее одобренные клиенты восстанавливают связь автоматически.

5. Проверить соединение

Теперь ваш агент должен перечислить доступные инструменты Unity MCP. Выполните простую команду типа “Прочитайте сообщения консоли Unity и сведите все предупреждения или ошибки”, чтобы проверить работоспособность соединения.

Unity MCP Server открыт в редакторе Unity. MCP-сервер подтверждает связь между Unity и выбранным разработчиком LLM. — MCP-сервер, подтверждающий связь между Unity и выбранным разработчиком LLM

Пути ретрансляции для конкретной платформы

Двоичный путь Relay варьируется в зависимости от операционной системы. Используйте путь для платформы при настройке агента вручную:

macOS (Apple Silicon): ~/.unity/relay/relay_mac_arm64.app/Contents/MacOS/relay_mac_arm64
macOS (Intel): ~/.unity/relay/relay_mac_x64.app/Contents/MacOS/relay_mac_x64
Windows:% userPROFILE%\. Unity\relay\relay_win.exe
Linux: ~/. Unity/Relay/relay_ Linux

Доступные инструменты

После подключения ваш агент ИИ получает доступ к набору встроенных средств МКП Unity. Именно эти инструменты вызывает агент, когда вы даете ему инструкции – он не взаимодействует с Unity напрямую, он проходит через протокол.

Основные категории инструментов включают:

Управление сценами: чтение иерархии, создание/изменение/удаление GameObjects, управление сценами
Редактирование сценариев: создание, чтение и изменение сценариев C# в вашем проекте
Консольный доступ: чтение журналов, предупреждений и ошибок из консоли Unity
Проверка GameObject: чтение и запись значений компонентов на определенных GameObjects
Параметры сборки: проверка платформы и настройка сборки

Вы также можете зарегистрировать пользовательские инструменты MCP в C#, чтобы открыть рабочие процессы вашего редактора для подключенных агентов – полезно для команд, которые хотят автоматизировать задачи конкретного проекта.

Список интеграций Unity MCP Server, открытых в редакторе Unity, включая Cursor, Claude Code, Windsurf, Claude Desktop, VSCode GitHub Copilot, Kiro, Codex и Gemini. — Unity AI перечисляет доступные интеграции для Unity MCP

Управление единством от агента ИИ

При активном MCP-соединении вы можете давать своему ИИ-агенту естественноязычные инструкции, и он выполнит их, используя инструменты Unity. Некоторые примеры:

«Создать новый пустой GameObject под названием PlayerSpawn на позиции (0, 0, 0)»
«Прочитайте иерархию сцены и скажите, в каких объектах отсутствуют компоненты»
“Напишите скрипт, который перемещает камеру, чтобы следовать за Игроком, и прикрепите его к основной камере”
«Проверьте консоль на ошибки и исправьте все, что связано с null ссылками»

Агент использует инструменты MCP для осуществления каждого шага, показывая свои аргументы и вызовы инструментов, которые он делает. Вы остаетесь в своей IDE на протяжении всего времени – вам не нужно переходить на Unity, пока вы не захотите пересмотреть результат.

Вид в редакторе Unity Unity AI Agent, вносящий изменения в сцену на основе инструкций LLM, подключенных через MCP- сервер. — ИИ Агент, вносящий изменения в сцену в Unity на основе инструкций LLM, подключенного через MCP-сервер

Исправление ошибок консоли с помощью Unity MCP

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

1. Агент читает консоль через Unity_ReadConsole

2. Определяет соответствующий скрипт и считывает его содержание

3. Пишет исправление и сохраняет файл обратно в проект

4. Перечитывает консоль для подтверждения устранения ошибки

Это замыкает цикл обратной связи, который обычно требует ручного копирования-вставки между Unity и помощником ИИ – агент обрабатывает его из конца в конец.

Представление In- Editor об ИИ Агенте Unity, который читает ошибку консоли и применяет исправление. — ИИ Агент чтение ошибки консоли и применение исправления

More on Unity AI

Если вам интересно подробнее ознакомиться с тем, что доступно в бета-версии Unity AI Open, предлагаем вам ознакомиться с другими статьями из этой серии:

Try Unity AI today

Unity AI open beta доступна уже сейчас для всех разработчиков Unity 6. Запишитесь на бесплатную пробную версию, изучите Unity AI Assistant, подключите предпочтительные инструменты через Unity AI Gateway и начните экспериментировать с тем, как выглядит рабочий процесс вашей разработки с помощью встроенного ИИ-агента, осведомленного о проекте.

Зарегистрируйтесь и узнайте больше о тарифных планах, ценах и конфиденциальности данных на сайте unity.com/features/ai

Полная документация доступна в документах Unity AI, ссылки на которые имеются в редакторе, или на сайте docs.unity3d.com.

Unity AI Assistant в настоящее время находится в открытой бета-версии. Как таковые функции, поведение и доступность, описанные в этом посте, находятся в активной разработке и могут быть изменены, ограничены или прекращены без уведомления.