Как подключить Claude Code к Unity: MCP, CLI и проверка

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

Claude Code (CLI) подключается к Unity (Юнити) через Unity MCP (МСП): пакет в проекте → сервер Running (порт 6589) → скопировать CLI‑команду из Quick setup → выполнить в терминале → в Claude появится unity-mcp.

Краткий путь (подробно — шаги ниже):

1. Скачать Unity MCP → Package Manager → Add package from disk
2. Активация в Window → Unity MCP → Mcp Panel
3. Start service до Running
4. Quick setup → Claude CLI → Copy команды → запуск в терминале
5. Read-only проверка: «Перечисли корневые объекты Hierarchy»

Можно ли подключить Claude / Клod к Unity? Да — через этот локальный мост, не через облачный плагин Unity. Для Cursor см. отдельный гайд. Установка пакета без Claude: Unity MCP install.

Это руководство — Claude CLI. Gemini CLI — тот же Quick setup, другая команда. Codex — см. FAQ ниже.

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

Пункт	Примечания
Unity	Рекомендуется 2022.3+ / Unity 6 (следуйте актуальным примечаниям о поддержке для вашей сборки)
Пакет плагина	Скачанный и распакованный архив Unity MCP
Активация	Аккаунт плагина + пароль или email + код активации (согласно Mcp Panel)
AI IDE	Claude CLI (тот же процесс для Gemini CLI)
Локальная сеть	Мост MCP обычно работает на 127.0.0.1 — не открывайте порт публично

Шаг 1: Скачайте Unity MCP

Скачайте плагин с сайта или страницы релизов вашего поставщика Unity MCP:

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

Рекомендуемый порядок действий:

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

Различия в лицензировании и редакциях зависят от поставщика — следуйте их официальной документации.

Шаг 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. На экране активации либо:
   • Войдите с помощью аккаунта + пароля
   • Или введите email + код активации
3. После успешной активации откройте страницу настроек MCP Server (следующий шаг)

Без активации сервис обычно не запускается. Убедитесь, что ваш аккаунт или код соответствует версии плагина, которую вы установили.

Шаг 4: Запустите unity-mcp-server

1. После активации откройте страницу настроек Unity MCP Server
2. Настройте по необходимости:
   • Port: по умолчанию 6589
   • Language: в соответствии с вашими предпочтениями интерфейса
   • Startup: следуйте параметрам панели (например, автозапуск с редактором, если доступно)
3. Нажмите Start service
4. Когда панель показывает Running, Unity MCP Server запущен

Теперь у вас есть локальный мост MCP — далее настройте Claude CLI.

Шаг 5: Настройте Claude CLI

1. Откройте Tool management
   • Просмотрите инструменты, предоставляемые Unity MCP Server
   • Включите только то, что вы хотите, чтобы модель использовала
2. Откройте Quick setup
   • Выберите Claude CLI (Gemini CLI работает так же — выберите этого клиента)
   • Claude CLI / Gemini CLI не поддерживают Auto configure — нажмите Copy на CLI-команде, показанной на панели

3. Откройте системный терминал, вставьте и запустите скопированную команду (в среде, где установлен Claude CLI)
4. Вернитесь в Claude CLI и убедитесь, что unity-mcp (или эквивалентное зарегистрированное имя) появился в списке MCP

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

В Claude CLI начните с проверки только для чтения, например:

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

Если ответ совпадает с редактором, мост работает исправно. Затем попробуйте небольшую запись (создайте временный пустой GameObject и удалите его), чтобы подтвердить разрешения и выбор инструментов.

FAQ

Можно ли подключить Claude к Unity? / Claude Code работает с Unity?
Да, через Unity MCP и Claude CLI (шаги 1–5). Unity должен быть открыт, сервер Running.

Как подключить Клod Code к Unity?
То же: Unity MCP + CLI‑команда из панели. Не путайте с чатом без MCP — без моста Claude видит только файлы .cs.

Как подключить Codex к Unity?
Unity MCP поддерживает MCP‑клиенты с локальной конфигурацией. После Running добавьте unity-mcp в конфиг Codex (адрес/stdio — как в Quick setup для вашего клиента). Если tools не видны — перезапустите Codex и проверьте active instances.

Add package from disk не может найти package.json?
Убедитесь, что на Шаге 1 архив был полностью распакован и вы выбрали package.json в корне этой папки — а не во вложенной распаковке.

Активация постоянно не удаётся?
Проверьте, что ваш аккаунт или код активации действителен, не истёк и привязан к правильному email, затем повторите попытку в Mcp Panel.

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

Claude CLI не показывает unity-mcp?
Убедитесь, что Unity по-прежнему показывает Running; вернитесь в Quick setup, скопируйте CLI-команду снова и полностью выполните её в терминале. Убедитесь, что вы выбрали Claude CLI, а не Cursor. Для Gemini CLI выберите Gemini CLI и скопируйте команду этого клиента.

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

• Попробуйте запрос сцены на естественном языке или небольшое изменение, чтобы изучить границы инструментов
• Делайте коммит перед крупными изменениями; держите мост только на localhost
• Шаблоны промптов после подключения: Как подключить Cursor к Unity через MCP