Cocos Creator 3.x MCP: импорт расширения и подключение AI IDE

Что вы узнаете из этого руководства

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

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

• Импортировать и включить cocos-mcp-server через Менеджер расширений
• Активировать с помощью учетной записи VberAI или email + код активации
• Запустить локальный Cocos MCP Server (порт по умолчанию 3000)
• Использовать Быстрая настройка → Автонастройка, чтобы зарегистрировать сервер в Cursor и подтвердить подключение

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

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

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

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

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

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

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

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

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

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

Шаг 2: Импорт расширения

1. Откройте ваш проект Cocos Creator 3.x
2. Меню: Расширение → Менеджер расширений → Импорт расширения
3. Выберите архив Cocos Creator 3.x MCP, который вы только что загрузили
4. После успешного импорта в списке расширений должно отображаться cocos-mcp-server включен

Если расширение отключено, включите его перед продолжением.

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

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

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

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

1. После активации откройте Настройки MCP-сервера
2. Настройте по необходимости:
   • Порт: по умолчанию 3000
   • Язык: выберите предпочитаемый язык интерфейса
   • Автозапуск: используйте опции панели (например, автоматический запуск вместе с редактором, если доступно)
3. Нажмите Запустить службу
4. Когда на панели отобразится Работает, Cocos MCP Server запущен

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

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

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

Другие IDE работают аналогично — просто выберите другой клиент в разделе «Быстрая настройка».

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

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

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

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

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

Не удалось импортировать, или cocos-mcp-server отсутствует в списке? Используйте официальный архив 3.x (не 2.x). Creator должен быть 3.0+. Если расширение остается отключенным, включите его в Менеджере расширений и перезапустите Creator.

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

Я нажал «Запустить службу», но статус «Работает» не появляется? Убедитесь, что порт 3000 (или ваш пользовательский порт) свободен и localhost не заблокирован. Проверьте, что шаг 3 выполнен успешно.

Cursor не показывает cocos-creator? В Creator убедитесь, что сервер все еще работает, выполните Быстрая настройка → Автонастройка еще раз, затем перезагрузите MCP в Cursor. Если проблема сохраняется, проверьте, что конфигурация MCP в Cursor содержит адрес локального моста.

Дальнейшие шаги

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

Для Creator 2.x следуйте руководству по установке Cocos Creator 2.x MCP — не смешивайте пакеты. Дополнительную информацию о MCP см. в видеоруководстве по Cocos Creator MCP.