Открытая бета-версия Unity AI: Как начать работу с MCP
В сегодняшней статье об открытой бета-версии Unity AI вы узнаете, как подключить Клода Кода, Github Copilot и других агентов искусственного интеллекта непосредственно к редактору Unity с помощью сервера протокола контекста моделей (MCP) Unity.
Сервер MCP от Unity AI открывает новый способ работы с агентами искусственного интеллекта в вашей IDE. Вместо того чтобы переключаться между редактором кода и Unity, можно подключить такие агенты, как Claude Code, Cursor, Windsurf или VS Code Copilot, непосредственно к запущенному проекту Unity, и позволить IDE получать полный контекст проекта, например просматривать сцены, читать выходные данные консоли, редактировать сценарии и запускать действия редактора без необходимости копировать и вставлять контекст.
В этой статье рассказывается, что такое MCP, как подключить агента, какие инструменты доступны и как их использовать для ускорения выполнения стандартных задач разработки, таких как исправление ошибок и управление сценами.
Что такое протокол контекста модели?
Model Context Protocol (MCP) — это открытый стандарт, который позволяет агентам ИИ структурированно взаимодействовать с внешними инструментами и источниками данных. Сервер MCP от Unity реализует этот протокол, так что любой агент искусственного интеллекта, совместимый с MCP, может подключаться к Unity Editor и взаимодействовать с ним так, как если бы это был набор вызываемых инструментов.
Без MCP агент искусственного интеллекта в вашей IDE видит только то, что вы ему показываете: открытые файлы, вставленный код или скопированные ошибки. MCP позволяет в реальном времени получать доступ к состоянию выполнения вашего проекта Unity — иерархии сцен, GameObjects, значениям компонентов, настройкам сборки и сообщениям консоли — по стандартизированному протоколу.
Официальный сервер MCP от Unity входит в пакет AI Assistant, и для его использования требуется подписка Unity (хотя кредиты Unity AI не расходуются).
Предварительные требования
Чтобы начать работу с MCP, ваша среда должна соответствовать следующим требованиям:
- Unity 6 (6000.0) или более поздняя версия с установленным пакетом AI Assistant
- Совместимый с MCP клиент искусственного интеллекта, такой как Claude Code, Cursor, Windsurf или Claude Desktop
- Проект Unity, связанный с Unity Cloud
- Активная пробная версия или подписка на Unity AI
Как интегрировать агент искусственного интеллекта с Unity
Настройка Unity MCP занимает всего несколько минут. Вот полный процесс:
1. Убедитесь, что мост Unity MCP работает
В редакторе Unity перейдите в меню «Редактирование» > «Настройки проекта» > «Искусственный интеллект» > «Unity MCP». Убедитесь, что в Unity Bridge отображается индикатор «Работает» (зеленый индикатор). Мост запускается автоматически при загрузке редактора. Если отображается сообщение «Остановлено», выберите «Пуск».
2. Настройте свой клиент AI
В разделе «Интеграции» на странице настроек Unity MCP можно автоматически настроить поддерживаемых клиентов — откройте раздел Интеграции, выберите клиента и нажмите кнопку Настроить. В зависимости от версии Unity MCP поддерживаемые клиенты могут включать Claude Code, Cursor, Windsurf и Claude Desktop.
3. Добавьте релейный путь вручную (при необходимости)
Если вашего клиента нет в списке автонастройки, добавьте запись сервера, указывающую на двоичный файл Unity relay. Реле устанавливается в ~/.unity/relay/ при запуске Unity. Передайте --mcp в качестве аргумента командной строки исполняемому файлу relay.
4. Одобрите подключение в Unity
При первом подключении агента Unity показывает сообщение «Ожидает подключения». Перейдите в меню «Редактирование» > «Настройки проекта» > «Искусственный интеллект» > Unity MCP, просмотрите сведения о клиенте и нажмите «Принять». Ранее одобренные клиенты автоматически переподключаются.
5. Проверьте соединение
Теперь ваш агент должен перечислить доступные инструменты Unity MCP. Выполните простую команду, например «Прочитайте сообщения консоли Unity и обобщите все предупреждения и ошибки», чтобы убедиться, что соединение работает.
Релейные пути, специфичные для платформы
Бинарный путь реле зависит от операционной системы. При ручной настройке агента используйте путь к своей платформе:
- 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: %ПРОФИЛЬ ПОЛЬЗОВАТЕЛЯ%\ .unity\ relay\ relay_win.exe
- Linux: ~/.unity/релей/релей_linux
Доступные инструменты
После подключения ваш агент искусственного интеллекта получает доступ к набору встроенных инструментов Unity MCP. Агент называет эти инструменты, когда вы даете инструкции: они не взаимодействуют с Unity напрямую, а через протокол.
Основные категории инструментов включают в себя:
- Управление сценами: чтение иерархии, создание/изменение/удаление GameObjects, управление сценами
- Редактирование сценариев: создавайте, читайте и изменяйте сценарии C# в своем проекте
- Доступ к консоли: чтение журналов, предупреждений и ошибок из консоли Unity
- Проверка GameObject: чтение и запись значений компонентов на определенных GameObjects
- Настройки сборки: проверьте платформу и конфигурацию сборки
Вы также можете зарегистрировать собственные инструменты MCP на языке C#, чтобы предоставлять подключенным агентам доступ к своим рабочим процессам редактора. Это удобно для команд, которые хотят автоматизировать специфические для проекта задачи.
Управление Unity с помощью агента искусственного интеллекта
Когда соединение MCP включено, вы можете давать своему агенту искусственного интеллекта инструкции на естественном языке, и он выполнит их с помощью инструментов Unity. Несколько примеров:
- «Создайте новый пустой объект GameObject под названием PlayerSpawn в позиции (0, 0, 0)»
- «Прочитайте иерархию сцен и скажите, в каких объектах отсутствуют компоненты»
- «Напишите сценарий, который перемещает камеру так, чтобы она следовала за игроком, и прикрепите его к основной камере»
- «Проверьте консоль на наличие ошибок и исправьте все, что связано с нулевыми ссылками»
Агент использует инструменты MCP для выполнения каждого шага, показывая свои аргументы и вызовы инструмента. Вы всегда остаетесь в своей IDE — вам не нужно переходить на Unity, пока вы не захотите проверить результат.
Исправление ошибок консоли с помощью Unity MCP
Одно из наиболее практичных применений Unity MCP — предоставление агенту возможности автономно читать и исправлять ошибки консоли. Поскольку агент может читать консоль и редактировать сценарии в одном сеансе, ошибка может исправляться без копирования данных:
1. Агент читает консоль через unity_readConsole
2. Определяет соответствующий сценарий и читает его содержимое
3. Записывает исправление и сохраняет файл обратно в проект
4. Снова читает консоль, чтобы подтвердить, что ошибка устранена
Это закрывает цикл обратной связи, который обычно требует ручного копирования между Unity и помощником по искусственному интеллекту — агент обрабатывает все от начала до конца.
Подробнее об искусственном интеллекте Unity
Если вам интересно узнать больше о том, что доступно в открытой бета-версии Unity AI, приглашаем вас прочитать другие статьи из этой серии:
Попробуйте Unity AI уже сегодня
Открытая бета-версия Unity AI теперь доступна для всех разработчиков Unity 6. Подпишитесь на бесплатную пробную версию, изучите Unity AI Assistant, подключите предпочитаемые инструменты через Unity AI Gateway и начните экспериментировать с тем, как выглядит рабочий процесс разработки с помощью встроенного агента искусственного интеллекта, ориентированного на проекты.
Зарегистрируйтесь и узнайте больше о тарифных планах, ценах и конфиденциальности данных на сайте unity.com/features/ai
Полная документация доступна в документации Unity AI, ссылка на которую приведена в редакторе, или на сайте docs.unity3d.com.
Unity AI Assistant в настоящее время находится в стадии открытого бета-тестирования. Таким образом, функции, поведение и доступность, описанные в этой публикации, находятся в стадии разработки и могут быть изменены, ограничены или прекращены без уведомления.