Как подключить Cursor к Unity через MCP: пошаговая настройка
Как подключить Cursor (Курсор) к Unity (Юнити) через MCP (МСП): установите VberAI Unity MCP, запустите локальный сервер, добавьте unity-mcp в Cursor и проверьт…
- unity-mcp
- mcp-for-unity
- claude-unity-mcp
- unity-claude-code
- unity-ai
- claude-code
- cursor
- vberai
Как подключить Cursor к Unity через MCP
Cursor (Курсор) подключается к Unity (Юнити) через локальный MCP (МСП)‑мост VberAI Unity MCP — не через облачный плагин. Краткий путь:
- Установите Unity MCP в проект Unity и активируйте пакет
- Запустите Unity MCP Server в редакторе (статус Running, порт по умолчанию 6589)
- В Cursor: Settings → MCP → добавьте сервис unity-mcp (автонастройка из панели плагина или вручную)
- Перезагрузите MCP в Cursor и проверьте: «Перечисли корневые GameObject активной сцены»
Тот же мост работает с Claude Code и Codex — меняется только клиент, шаги в Unity одинаковые. Подробная установка пакета: Установка Unity MCP.
Если Cursor видит только файлы на диске, он не может читать живую Hierarchy, Console и режим Play. Model Context Protocol (MCP) даёт ИИ‑клиенту инструменты редактора через локальный сервер, пока Unity открыт.
Что 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
- Импортируйте пакет в ваш проект (или установите через рабочий процесс пакетов вашей команды)
- Включите расширение / пункт меню (названия могут незначительно различаться в зависимости от сборки — ищите MCP или AI Bridge)
- Перезагрузите редактор, если 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 решают пересекающиеся задачи. Оценивайте их одинаково:
- Может ли инструмент видеть живую Hierarchy / выделение?
- Может ли он делать обратимые правки, которые вы можете проверить?
- Работает ли он с ИИ-клиентом, который ваша команда уже использует (Claude Code, Cursor, …)?
Unity MCP наиболее силён, когда ваша команда уже работает в этих клиентах и хочет один протокол для разных движков (многие студии также используют Godot или Cocos MCP с той же привычкой).
Какие ИИ‑клиенты поддерживает Unity MCP
Один локальный unity-mcp сервер; меняется только клиент:
| Клиент | Как подключить |
|---|---|
| Cursor (Курсор) | Quick setup → автонастройка — гайд Cursor |
| Claude Code | Quick setup → Copy CLI command — гайд Claude |
| Codex | MCP‑конфиг вручную (endpoint/stdio из панели Unity MCP) после Running |
| Windsurf / Cline / Continue | Аналогично Cursor — запись MCP + Reload |
| Gemini CLI | Quick setup → Gemini CLI → Copy command |
Какая ИИ лучше работает с Unity MCP? Та, которой команда уже пользуется для кода — MCP не привязан к одной модели. Важнее стабильный Running и видимые tools, чем бренд LLM.
Часто задаваемые вопросы
Как подключить Cursor к Unity? Установите VberAI Unity MCP в проект, запустите локальный сервер в Unity, затем добавьте unity-mcp в список MCP Cursor и перезагрузите клиент. Пошагово — в чек-листе настройки выше и в гайде по установке.
Cursor подключение к Unity не работает — что проверить? Unity должен быть открыт с тем же проектом; сервер MCP — Running; в Cursor есть unity-mcp с tools (при необходимости Reload Window). Если сервер работает, но редактор не в списке активных инстансов — см. раздел про active instances.
Может ли Cursor взять контекст проекта Unity?
Да — через MCP: клиент читает Hierarchy, выделение, Console и другие инструменты редактора, а не только .cs на диске.
Как добавить ИИ Cursor к Unity? Это и есть связка Unity MCP + Cursor: плагин в Unity + запись MCP в Cursor. Отдельного «Cursor‑плагина» в Asset Store не нужно.
Нужно ли мне всё ещё писать на C#? Да. MCP лучше всего подходит для операций в редакторе и создания каркаса. Игровые системы, сетевой код и оптимизация производительности всё ещё требуют инженеров.
Claude Code или Cursor? Оба работают, если они поддерживают MCP и вы направляете их на один и тот же локальный сервер Unity. Выбирайте клиент, который уже использует ваш репозиторий; мост — общая часть. Claude — отдельная установка CLI.
Как подключить Codex к Unity? После Running добавьте unity-mcp в MCP‑настройки Codex (как в Quick setup). Если tools пустые — active instances.
Unity MCP — какие ИИ используются?
Cursor, Claude Code, Codex, Windsurf, Cline, Gemini CLI и другие MCP‑клиенты — см. таблицу клиентов выше.
Это только для UI?
Нет. Hierarchy, компоненты и операции со сценой применимы и к игровым объектам. UI — просто лёгкая первая демонстрация.
Где видео-инструкция? Смотрите Unity Game Engine MCP Plugin (видео-гид) на канале VberAI для записи процесса настройки.
Следующие шаги
- Установите Unity MCP в тестовую сцену
- Подключите Claude Code или Cursor и пройдите тест только на чтение
- Автоматизируйте одну рутинную задачу, которую вы ненавидите (пакетное переименование, дублирование панели, прикрепление скрипта)
Когда узким местом становится перенос дизайна в префаб, а не операции в редакторе, объедините это с рабочим процессом Figma → Unity AI Studio.
Читайте дальше
Другие статьи, которые могут вам понравиться
Спрайты и sequence‑кадры: GPT Image vs видео в VberAI Studio
AI игровые спрайты и sequence‑кадры: sprite sheet (GPT Image) vs видео→разбор кадров в VberAI Studio. Сравнение, когда что брать, экспорт в Unity / Godot / Coc…
- vberai
- ai-studio
- sprite-frames
- sequence-frames
Что умеет VberAI Studio: генерация изображения, нарезка UI, смена оформления, перевод и вырезание фона
Что умеет VberAI Studio, на одной странице: генерация изображения, нарезка на месте, смена оформления, перевод UI, пикселизация, вырезание фона, кадры, аудио, …
- vberai
- ai-studio
- game-ui
- image-gen
Как подключить Claude Code к Unity: MCP, CLI и проверка
Как подключить Claude (Claude Code) к Unity (Юнити) через MCP: установка Unity MCP, запуск сервера, CLI-команда из панели и проверка Hierarchy. Можно ли Claude…
- unity
- mcp
- claude-code
- tutorial