Unity MCP с Claude Code и Cursor: управляйте редактором без ручного ввода каждого изменения

Предел «ИИ пишет C# в папку»

Инструменты для чат-кодинга хороши в генерации скриптов. Но ИИ, который только редактирует файлы, упускает живое состояние редактора — открытые сцены, выбранные GameObject, варианты префабов, поведение в режиме Play и ошибки в Console.

Если модель видит только файлы на диске, она угадывает иерархию и не может нажать Play, переименовать узел в Hierarchy или проверить отсутствующую ссылку. Командам нужен ассистент внутри цикла движка, а не только в репозитории.

Model Context Protocol (MCP) — это стандартный способ для ИИ-клиентов вызывать инструменты. Сервер Unity MCP предоставляет действия редактора через локальный мост, чтобы такие клиенты, как Claude Code, Cursor и рабочие процессы в стиле Codex, могли читать и изменять проект, пока Unity запущен.

VberAI предоставляет плагин Unity MCP для этого моста. Это руководство — практический путь настройки и использования, а не перечень функций.

Что Unity MCP меняет в повседневной работе

Без MCP	С Unity MCP
Вставляете сгенерированные скрипты, затем исправляете ошибки компиляции вручную	Просите клиент создать скрипт и прикрепить его к именованному GameObject
Вручную дублируете панели UI	Запрос: «Клонируй Panel_Shop под Canvas и переименуй дочерние элементы»
Описываете ошибки Console в чате	Позволяете клиенту читать последние логи / контекст выделения (где плагин это предоставляет)
Угадываете макет сцены из YAML	Запрашиваете иерархию, затем редактируете с подтверждением

Вы по-прежнему проверяете diff и результаты режима Play. Вы перестаёте вводить каждый клик в редакторе, который агент может выполнить безопасно.

Предварительные требования

• Открытый проект Unity (рекомендуется LTS для командной работы)
• Клиент с поддержкой MCP: Claude Code, Cursor, Windsurf или аналогичный
• Локальный сетевой доступ к 127.0.0.1 (мост обычно остаётся на loopback)
• Пакет VberAI Unity MCP для вашей версии Unity (скачать / документация)

Опционально, но полезно: небольшая тестовая сцена (пустой Canvas + две кнопки), чтобы первые запросы было легко проверить.

Чек-лист настройки

1. Установите плагин Unity MCP

1. Импортируйте пакет в ваш проект (или установите через рабочий процесс пакетов вашей команды)
2. Включите расширение / пункт меню (названия могут незначительно различаться в зависимости от сборки — ищите MCP или AI Bridge)
3. Перезагрузите редактор, если Unity попросит

2. Запустите локальный мост MCP

Откройте панель плагина и запустите сервер. Убедитесь:

• Статус показывает running
• Хост — localhost (не открывайте порт публично)
• Путь к проекту соответствует проекту Unity, который вы собираетесь редактировать

3. Зарегистрируйте сервер в вашем ИИ-клиенте

В Cursor или Claude Code добавьте запись сервера MCP, указывающую на локальный мост Unity (stdio или HTTP/SSE — следуйте текущей документации плагина).

Перезапустите клиент, если инструменты не отображаются. Вы должны увидеть перечисленные инструменты, связанные с Unity (чтение сцены, операции с узлами и т.д.).

4. Выполните тест только на чтение

Спросите:

Перечисли корневые GameObject в активной сцене.

Если ответ совпадает с Hierarchy, мост работает. Только после этого пробуйте действия на запись.

5. Выполните небольшой тест на запись

Спросите:

Создай пустой GameObject с именем MCP_SmokeTest в корне сцены.

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

Эффективные шаблоны запросов

Сначала структура

Покажи дочерние элементы Canvas/HUD и обобщи, какие из них являются LayoutGroups.

Целевые записи

Под Canvas/Menu переименуй Button в Btn_Start и установи текст TMP-метки на Start.

Цикл отладки

После того как я нажму Play, обобщи ошибки Console, связанные с PlayerController, и предложи минимальное исправление.

Работа со сгенерированным UI

Если вы импортировали экран из AI Studio, используйте MCP для подключения обработчиков onClick или приведения имён в соответствие с вашими соглашениями C# — без ручной перестройки префаба.

Привычки безопасности

• Держите мост только на localhost
• Предпочитайте чтение → план → запись вместо одного гигантского запроса «перестрой игру»
• Делайте коммит перед крупными правками агента
• Не вставляйте секреты в запросы; MCP не заменяет контроль доступа
• Считайте режим Play и обновление базы данных ассетов контрольными точками для человека

MCP уменьшает ручные клики в движке. Он не отменяет проверку кода.

Как это соотносится со встроенными ИИ-ассистентами Unity

Встроенные ассистенты Unity и сторонние плагины Unity MCP решают пересекающиеся задачи. Оценивайте их одинаково:

1. Может ли инструмент видеть живую Hierarchy / выделение?
2. Может ли он делать обратимые правки, которые вы можете проверить?
3. Работает ли он с ИИ-клиентом, который ваша команда уже использует (Claude Code, Cursor, …)?

Unity MCP наиболее силён, когда ваша команда уже работает в этих клиентах и хочет один протокол для разных движков (многие студии также используют Godot или Cocos MCP с той же привычкой).

Часто задаваемые вопросы

Нужно ли мне всё ещё писать на C#? Да. MCP лучше всего подходит для операций в редакторе и создания каркаса. Игровые системы, сетевой код и оптимизация производительности всё ещё требуют инженеров.

Claude Code или Cursor? Оба работают, если они поддерживают MCP и вы направляете их на один и тот же локальный сервер Unity. Выбирайте клиент, который уже использует ваш репозиторий; мост — общая часть.

Это только для UI? Нет. Hierarchy, компоненты и операции со сценой применимы и к игровым объектам. UI — просто лёгкая первая демонстрация.

Где видео-инструкция? Смотрите Unity Game Engine MCP Plugin (видео-гид) на канале VberAI для записи процесса настройки.

Следующие шаги

1. Установите Unity MCP в тестовую сцену
2. Подключите Claude Code или Cursor и пройдите тест только на чтение
3. Автоматизируйте одну рутинную задачу, которую вы ненавидите (пакетное переименование, дублирование панели, прикрепление скрипта)

Когда узким местом становится перенос дизайна в префаб, а не операции в редакторе, объедините это с рабочим процессом Figma → Unity AI Studio.