Cocos Creator MCP не подключается: настройка, порт и Cursor

Cocos Creator MCP не подключается — настройка по симптомам

Cocos Creator MCP (cocos creator mcp) не коннектится, если оборван один из четырёх слоёв: плагин → активация → Running на localhost → конфиг в Cursor.

Быстрый чеклист:

1. Версия пакета 2.x ↔ 2.x или 3.x ↔ 3.x (не смешивать)
2. Расширение включено; для 2.x — папка packages/ и полный рестарт Creator
3. Панель активирована (аккаунт / код)
4. Статус Running, порт свободен (часто 3000)
5. Быстрая настройка → автонастройка в Cursor + Reload MCP
6. Read-only: «Перечисли корневые ноды открытой сцены»

Если формулировка «Cursor сломался» — сначала Cursor + Cocos MCP. Что такое MCP: Cocos Creator MCP — обзор.

Установка: 3.x · 2.x. Примеры на Cursor; Claude Code / Codex — та же логика reload.

Сначала: на каком слое обрыв?

Путь MCP — четыре слоя. Падение любого выглядит как «не коннектится»:

1. Плагин в проекте и включён
        ↓
2. Панель активирована (аккаунт / код)
        ↓
3. MCP Server в статусе Running (localhost)
        ↓
4. В AI IDE записан конфиг и список MCP показывает connected

Что видите	Смотреть сначала
Нет меню Расширение → Cocos MCP Server / MCP Server	Слой 1: версия пакета, путь импорта, перезапуск
Панель есть, но сервис не стартует / не активирован	Слой 2: аккаунт и код
Нажали «Запустить», нет Running	Слой 3: порт, файрвол, активация
В Creator Running, в Cursor нет cocos-creator	Слой 4: быстрая настройка, reload MCP, файл конфига
Cursor «подключён», но узлы сцены не перечисляются	Промпт проверки, галочки инструментов, открыт ли нужный проект

Симптом A: в меню нет расширения MCP

Вероятные причины

1. Смешали пакеты 2.x / 3.x
2. 3.x: не импортировали в менеджере расширений или всё ещё выключено
3. 2.x: не в packages/<имя-плагина>/ или лишний уровень после unzip
4. 2.x: файлы положили, но Creator не перезапускали полностью

Шаги

Creator 3.x:

1. Скачайте с Cocos MCP 3.x, не 2.x
2. Откройте проект → Расширение → Менеджер расширений → Импорт → zip 3.x
3. В списке cocos-mcp-server включён; иначе включите
4. Меню всё ещё нет — закройте Creator и откройте тот же проект снова

Creator 2.x:

1. Скачайте с Cocos MCP 2.x
2. После распаковки дерево должно быть таким:

корень-проекта/
  packages/
    <имя-плагина>/          ← файлы плагина прямо здесь
      package.json          ← должен быть на этом пути

3. Ошибочная вложенность:

packages/
  xxx-mcp-unzip/
    <имя-плагина>/
      package.json

4. Исправьте путь, полностью перезапустите Creator (не только обновите сцену), проверьте Расширение → MCP Server.

Симптом B: панель открывается, активация/старт не идут

Вероятные причины

• Нет соответствующего Pro на аккаунте
• Код просрочен или email не совпадает
• Нажали «Запустить» до активации

Шаги

1. Откройте панель MCP (3.x: Расширение → Cocos MCP Server → Open Mcp Panel; 2.x: Расширение → MCP Server)
2. Активируйте одним способом:
   • аккаунт VberAI + пароль
   • email + код
3. Сверьте план/код в личном кабинете на сайте и повторите
4. Только после активации зайдите в настройки MCP Server и нажмите «Запустить»

Без активации сервис обычно не доходит до Running. Это не проблема Cursor — чините редактор.

Симптом C: нажали «Запустить», нет Running

Вероятные причины

1. Всё ещё не активировано (симптом B)
2. Порт занят (у 3.x часто 3000; у 2.x — как на панели)
3. Файрвол / защита блокирует listen на localhost

Шаги

1. Запомните порт на странице настроек MCP Server (ниже пример 3000 — подставьте свой)
2. Проверьте, кто слушает порт:

macOS / Linux:

lsof -iTCP:3000 -sTCP:LISTEN

Windows (PowerShell):

netstat -ano | findstr :3000

3. Если порт занят:
   • завершите процесс, или
   • выберите свободный порт на панели и снова «Запустить»
4. Файрвол не должен резать 127.0.0.1 (MCP не выставлять в интернет)
5. Когда панель покажет Running, настраивайте Cursor

Симптом D: в Creator Running, в Cursor нет cocos-creator

Самый частый тип «не коннектится»: редактор в порядке, клиент не подхватил конфиг.

Шаги (по порядку)

1. В Creator убедитесь, что панель всё ещё Running (смена порта или рестарт могли остановить сервис)
2. Управление инструментами — нужные tools включены
3. Быстрая настройка → Cursor → Автоконфиг, пока UI не покажет Configured
4. В Cursor → список MCP / tools:
   • должен быть cocos-creator (или имя с панели)
   • нет — Reload MCP (или перезапуск Cursor)
5. Всё ещё нет — проверьте, что в MCP-конфиге Cursor есть локальный мост (127.0.0.1 + порт панели)

Формат автоконфига зависит от версии Cursor. При ручной проверке:

• имя сервиса — Cocos MCP (например cocos-creator)
• хост 127.0.0.1 / localhost, порт как в Creator
• не LAN и не публичный IP

После правки конфига обязательно снова reload MCP, иначе UI покажет старое состояние.

Другие AI IDE

В быстрой настройке выберите Claude Code, Codex, Windsurf, Cline и т.д., затем «автоконфиг → reload MCP в том клиенте». Настройка Cursor ≠ все IDE подключены.

Симптом E: «подключён», но сцена не читается / узлы не меняются

Вероятные причины

1. Открытый проект/сцена в Creator не совпадает с вопросом
2. Нужные tools выключены в Управлении инструментами
3. Проверили только «файлы на диске», не контекст редактора

Проверка

В Cursor сначала read-only промпт:

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

Результат	Смысл
Совпадает с Hierarchy	Мост OK; можно малый write-тест
Явная ошибка / нет tools	Вернуться к C/D
Выдуманные имена узлов	MCP, скорее всего, не вызван; проверить коннект и галочки

Затем малый write (создать временный узел и удалить). Перед крупными правками — commit.

Таблица 2.x / 3.x

	Creator 3.x	Creator 2.x
Страница продукта	cocos (3.x)	cocos2x
Установка	Менеджер расширений → Импорт	Распаковать в packages/ проекта
После установки	Включить в списке	Обязателен рестарт Creator
Пакет	только 3.x	только 2.x
Полные шаги	установка 3.x	установка 2.x

Смешение пакетов часто даёт «нет меню» или «импорт не удался» — сначала эта таблица.

Рекомендуемый порядок (чеклист на 5 минут)

Идите сверху; большинство сбоев — в первых четырёх пунктах:

1. Мажор Creator совпадает с zip MCP (2.x↔2.x, 3.x↔3.x)
2. Расширение включено / путь packages верный; для 2.x был рестарт
3. Панель успешно активирована
4. Панель Running; порт свободен
5. Для текущего IDE: быстрая настройка → автоконфиг
6. В AI IDE reload MCP; в списке есть cocos-creator
7. Read-only промпт перечисляет корни сейчас открытой сцены

Если всё ещё плохо — зафиксируйте

Для поддержки или коллеги:

• Точная версия Creator (напр. 3.8.x / 2.4.x)
• Тип пакета MCP (2.x или 3.x Pro)
• Running ли панель и какой порт
• Имя/версия AI IDE, скрин списка MCP
• Точный read-only промпт и ответ

Мост только на localhost; порт MCP в интернет не открывать.

Связанные материалы

• Установка Cocos Creator 3.x MCP
• Установка Cocos Creator 2.x MCP
• Видео-настройка Cocos Creator MCP
• Выбор движка: Godot MCP vs Unity MCP vs Cocos MCP

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

Cocos Creator MCP — как настроить?
Импорт пакета → активация → Запустить службу до Running → автонастройка Cursor. 3.x или 2.x.

В Cursor нет cocos-creator — что делать?
Симптом D в этой статье: Running в Creator → Quick setup → Reload MCP. Если «Cursor сломался» — отдельный гайд.

Порт 3000 занят / сервер не Running?
Симптом C: lsof / смена порта на панели. MCP только на 127.0.0.1, не в интернет.

MCP Cocos Creator 2.x и 3.x — один пакет?
Нет. Таблица 2.x / 3.x выше; смешение — частая причина «нет меню MCP».