Cocos Creator 2.x MCP: установка через packages и подключение AI IDE

Что рассматривается в этом руководстве

Следуйте этим пяти шагам, чтобы подключить Cocos Creator 2.x MCP (VberAI Pro) к локальному проекту Creator 2.x, чтобы Cursor (или другая AI IDE с поддержкой MCP — принцип тот же) мог управлять, просматривать и отлаживать редактор, а не просто редактировать скрипты на диске.

После завершения вы сможете:

• Распаковать плагин в папку packages проекта
• Перезапустить Creator, затем активировать с помощью учетной записи VberAI или email + код активации
• Запустить локальный Cocos MCP Server
• Использовать Quick configure → Auto configure для регистрации сервера в Cursor и подтверждения подключения

Страница продукта: VberAI Cocos MCP 2.x

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

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

Элемент	Примечания
Cocos Creator	2.4.x+ / другие проекты 2.x (не смешивать с пакетом для 3.x)
Пакет плагина	Архив Cocos Creator 2.x MCP Pro с официального сайта
Активация	Учетная запись VberAI + пароль, или email + код активации
AI IDE	Рекомендуется Cursor; другие MCP-клиенты также подходят
Локальная сеть	MCP-мост обычно работает на 127.0.0.1 — не открывайте порт публично

Шаг 1: Загрузка Cocos Creator 2.x MCP

Загрузите Pro сборку с сайта VberAI:

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

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

1. Откройте страницу и загрузите Cocos MCP 2.x Pro с правами вашей учетной записи
2. Сохраните архив локально и подготовьтесь к его извлечению
3. Убедитесь, что проект — Creator 2.x; не смешивайте с пакетом для 3.x MCP

Различия между OSS и Pro, а также тарификация соответствуют текущему тексту на сайте.

Шаг 2: Установка плагина (в packages)

В отличие от 3.x (Extension Manager → Import Extension), в 2.x установка производится размещением файлов в проекте:

1. Распакуйте архив на вашем компьютере
2. Переместите распакованную папку плагина в каталог packages в корне проекта Cocos Creator
   • Если packages еще не существует, создайте его
3. Убедитесь, что структура имеет вид packages/<имя-плагина>/, а не вложенность с дополнительным уровнем распаковки

Пока не настраивайте: перезапустите Creator, чтобы расширение загрузилось корректно (следующий шаг).

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

1. Полностью перезапустите Cocos Creator и откройте проект, содержащий плагин
2. Меню: Extension → MCP Server
3. На экране активации используйте либо:
   • Учетную запись VberAI + пароль
   • Email + код активации
4. После успешной активации откройте страницу настроек MCP Server (следующий шаг)

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

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

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

Теперь у вас есть локальный MCP-мост. Далее передайте его вашей AI IDE.

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

1. Откройте Tool manager
   • Просмотрите инструменты, предоставляемые Cocos MCP Server
   • Включите только те, которые хотите использовать с AI
2. Откройте Quick configure
   • Выберите вашу IDE (например, Cursor)
   • Нажмите Auto configure
   • Убедитесь, что в интерфейсе отображается состояние configured
3. Откройте Cursor
   • В списке MCP / инструментов вы должны увидеть cocos-creator (или имя, указанное в панели) подключенным
   • Если он отсутствует, нажмите Reload (или эквивалентную перезагрузку MCP) в Cursor и проверьте снова

Другие IDE следуют тому же пути — просто выберите другой клиент в Quick configure.

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

В Cursor начните с проверки только на чтение, например:

Перечисли корневые узлы сцены, которая сейчас открыта в Cocos Creator.

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

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

Файлы в packages, но нет меню Extension → MCP Server? Убедитесь, что вы полностью перезапустили Creator (а не просто перезагрузили сцену). Проверьте, что папка находится в packages/<имя-плагина>/ без дополнительной вложенности от архива. Убедитесь, что вы загрузили пакет для 2.x, а не для 3.x.

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

Я нажал Start service, но никогда не вижу Running? Убедитесь, что порт свободен и localhost не заблокирован. Убедитесь, что Шаг 3 выполнен успешно.

Cursor не показывает cocos-creator? В Creator убедитесь, что сервер все еще Running, выполните Quick configure → Auto configure снова, затем перезагрузите MCP в Cursor. Если все еще не работает, проверьте, что конфигурация MCP в Cursor включает адрес локального моста.

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

• Используйте естественный язык для запроса сцены или небольшого редактирования, чтобы изучить границы инструмента
• Делайте коммит перед большими изменениями; держите мост только на localhost
• Для интерфейса от дизайна к движку используйте VberAI AI Studio, затем дорабатывайте в редакторе с MCP

Для Creator 3.x следуйте руководству по установке Cocos Creator 3.x MCP — не смешивайте пакеты. Для дополнительного контекста по MCP смотрите видео-руководство по Cocos Creator MCP.