Как установить Unity MCP и подключить MCP к Unity (Cursor, Claude)

Как установить Unity MCP и подключить MCP к Unity

Unity MCP (МСП для Юнiti) ставится через Package Manager → Add package from disk, затем активируется в Window → Unity MCP → Mcp Panel и запускается локальный Unity MCP Server (порт 6589). После статуса Running подключите Cursor (Курсор) или другой MCP‑клиент через быструю настройку → автонастройку — в списке MCP появится unity-mcp.

За пять шагов ниже вы:

• Импортируете Unity MCP через Package Manager → Add package from disk
• Активируете аккаунт VberAI или email + код активации
• Запускаете локальный Unity MCP Server (порт по умолчанию 6589)
• Прописываете сервис в Cursor и проверяете соединение

Подробнее про ежедневную работу с Cursor после подключения: Как подключить Cursor к Unity через MCP.

Страница продукта: VberAI Unity MCP

В гайде пример — Cursor. Claude Code, Windsurf, Cline и другие MCP-клиенты настраиваются аналогично.

Требования

Пункт	Пояснение
Unity	Рекомендуется 2022.3+ / Unity 6 (см. актуальные требования на сайте)
Пакет	Архив Unity MCP Pro с сайта, уже распакованный
Активация	Аккаунт VberAI + пароль или email + код
AI IDE	Рекомендуется Cursor; подойдут и другие MCP-клиенты
Сеть	Мост обычно на 127.0.0.1 — не открывайте порт в интернет

Шаг 1: Скачать Unity MCP

Скачайте Pro на сайте VberAI:

Страница загрузки: https://www.vberai.com/game-engines/unity?ch=CQZLC2FG

Рекомендуется:

1. Открыть страницу и скачать Unity MCP Pro по правам аккаунта
2. Сохранить архив и распаковать в постоянную папку (на следующем шаге нужен package.json)
3. Убедиться, что в папке есть package.json, затем открыть Unity

Различия OSS / Pro и тарифы — по актуальным текстам на сайте.

Шаг 2: Импорт пакета

1. Откройте целевой проект Unity
2. Меню Window → Package Manager
3. В панели Package Manager нажмите «+» слева сверху
4. Выберите Add package from disk
5. Укажите package.json из папки распаковки шага 1

После успеха пакет Unity MCP появится в списке Package Manager.

Шаг 3: Активация unity-mcp

1. Меню Window → Unity MCP → Mcp Panel
2. На экране активации выберите:
   • аккаунт VberAI + пароль
   • или email + код активации
3. После успеха откройте страницу настроек MCP Server (следующий шаг)

Без активации сервис обычно не запускается. Проверьте, что план или код соответствуют текущему Pro.

Шаг 4: Запуск unity-mcp-server

1. После активации откройте настройки Unity MCP Server
2. При необходимости задайте:
   • Порт: по умолчанию 6589
   • Язык: по удобству UI
   • Запуск: по опциям панели (например автозапуск с редактором)
3. Нажмите «Запустить сервис»
4. Когда появится «Выполняется» / Running, Unity MCP Server запущен

Локальный MCP-мост готов — передайте его AI IDE.

Шаг 5: Автонастройка AI IDE (пример Cursor)

1. Откройте управление инструментами
   • Просмотрите список инструментов Unity MCP Server
   • Включите только нужные
2. Откройте быструю настройку
   • Выберите IDE (например Cursor)
   • Нажмите автонастройку
   • Убедитесь в статусе настроено
3. Откройте Cursor
   • В списке MCP / tools должен быть подключён unity-mcp
   • Если нет — нажмите Reload (перезагрузка MCP) в Cursor

Другие IDE — тот же поток, смените клиент в быстрой настройке.

Быстрая проверка после подключения

В Cursor начните с чтения, например:

Перечисли корневые объекты Hierarchy в сцене, открытой в Unity.

Если ответ совпадает с редактором — мост работает. Затем сделайте малую запись (создать временный Empty и удалить).

MCP Server Running, но Unity Editor не в списке активных инстансов

Симптом из Yandex/форумов: MCP‑сервер работает, но Unity Editor не зарегистрирован в списке активных инстансов — Cursor или Claude не видят tools / не читают сцену.

Шаг	Действие
1	Открыт конкретный проект Unity, не только Hub
2	Mcp Panel: Stop → Start, статус Running
3	Порт 6589 свободен; localhost не блокируется
4	Save Project, снова автонастройка Cursor в панели Unity MCP
5	Cursor: Reload Window; закройте лишние окна Unity с другими проектами
6	После обновления пакета — переактивируйте и перезапустите редактор

Если Play OK, а Player build падает — см. отдельный гайд по сборке.

FAQ

Как установить Unity MCP? Скачайте Pro с сайта VberAI → распакуйте → Package Manager → Add package from disk → выберите package.json → активируйте в Mcp Panel → запустите сервер. Шаги 1–4 выше.

Как подключить MCP к Unity / Cursor? MCP ставится внутрь проекта Unity (шаги 1–4), затем Cursor получает unity-mcp через автонастройку (шаг 5). Unity и Cursor должны работать одновременно на одной машине.

Unity MCP как включить после установки? Window → Unity MCP → Mcp Panel → активация → Запустить сервис до Running → автонастройка IDE.

Не находится package.json при Add package from disk?
Убедитесь, что архив полностью распакован и выбран package.json в корне папки, без лишней вложенности.

Активация постоянно падает?
Проверьте Pro-доступ, срок кода и привязку email в кабинете на сайте, затем повторите в Mcp Panel.

Сервис запущен, но нет Running?
Освободите порт 6589 (или ваш порт), не блокируйте localhost. Убедитесь, что шаг 3 пройден.

В Cursor нет unity-mcp?
В Unity статус должен быть Running; снова быстрая настройка → автонастройка; перезагрузите MCP в Cursor.

Дальше

• Попробуйте запрос к сцене или мелкое изменение на естественном языке
• Перед крупными правками — коммит; мост только на localhost
• Для UI из макетов подключите VberAI Studio, затем итерации через MCP

Дополнительно: видеогайд Unity MCP, Как подключить Cursor к Unity через MCP.