Как подключить Cursor к Unity через MCP: пошаговая настройка

Как подключить Cursor к Unity через MCP

Cursor (Курсор) подключается к Unity (Юнити) через локальный MCP (МСП)‑мост VberAI Unity MCP — не через облачный плагин. Краткий путь:

1. Установите Unity MCP в проект Unity и активируйте пакет
2. Запустите Unity MCP Server в редакторе (статус Running, порт по умолчанию 6589)
3. В Cursor: Settings → MCP → добавьте сервис unity-mcp (автонастройка из панели плагина или вручную)
4. Перезагрузите 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

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 с той же привычкой).

Какие ИИ‑клиенты поддерживает 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 для записи процесса настройки.

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

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

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