Dépannage de la connexion Cocos MCP : Cursor n'affiche pas cocos-creator
Correctifs basés sur les symptômes pour VberAI Cocos Creator 2.x / 3.x MCP : extension manquante, échec d'activation, serveur non démarré, conflits de port, MC…
- cocos
- cocos-creator
- mcp
- cursor
- troubleshooting
- cocos-mcp
Premièrement : quelle couche a échoué ?
Si vous dites « Cursor est cassé / ne se connecte pas », partez des symptômes côté Cursor : Cursor cassé après Cocos Creator MCP.
Si le rôle de MCP et l’écart avec « Cocos Creator AI » restent flous, lisez d’abord Qu’est-ce que Cocos Creator MCP.
Le chemin MCP comporte quatre couches. Une défaillance à n’importe quelle couche ressemble à « impossible de se connecter » :
1. Extension installée et activée
↓
2. Panneau activé (compte / code de licence)
↓
3. Serveur MCP affiche En cours d'exécution (localhost)
↓
4. Configuration de l'IDE IA écrite et liste MCP affiche connecté
| Ce que vous voyez | Vérifiez d’abord |
|---|---|
| Pas de menu Extension → Cocos MCP Server / MCP Server | Couche 1 : version du paquet, chemin d’importation, redémarrage |
| Le panneau s’ouvre mais ne peut pas démarrer / reste non activé | Couche 2 : compte et licence |
| Cliqué sur Démarrer mais jamais En cours d’exécution | Couche 3 : port, pare-feu, activation |
Creator affiche En cours d’exécution, Cursor n’a pas cocos-creator | Couche 4 : configuration rapide, rechargement MCP, fichier de configuration |
| Cursor affiche connecté mais ne peut pas lister les nœuds de scène | Invite de vérification, bascules d’outils, projet ouvert correct |
Symptôme A : Pas d’extension MCP dans le menu
Causes probables
- Paquets mixtes 2.x / 3.x
- 3.x : non importé dans le gestionnaire d’extensions, ou toujours désactivé
- 2.x : pas sous
packages/<nom-du-plugin>/, ou un niveau d’imbrication supplémentaire lors de la décompression - 2.x : fichiers placés mais Creator pas complètement redémarré
Correctifs
Creator 3.x :
- Téléchargez depuis Cocos MCP 3.x—pas le pack 2.x
- Ouvrez le projet → Extension → Gestionnaire d’extensions → Importer → sélectionnez le zip 3.x
- Confirmez que
cocos-mcp-serverest activé ; activez-le s’il est désactivé - Si le menu est toujours manquant : quittez Creator et rouvrez le même projet
Creator 2.x :
- Téléchargez depuis Cocos MCP 2.x
- Après décompression, l’arborescence devrait ressembler à :
racine-de-votre-projet/
packages/
<nom-du-plugin>/ ← fichiers du plugin directement ici
package.json ← devrait exister à ce chemin (nom selon le paquet)
- Mauvaise imbrication exemple :
packages/
xxx-mcp-unzip/
<nom-du-plugin>/
package.json
- Corrigez le chemin, puis quittez et redémarrez Creator (pas seulement actualiser la scène). Vérifiez Extension → Serveur MCP.
Symptôme B : Le panneau s’ouvre, mais l’activation échoue ou le service ne démarre pas
Causes probables
- Le compte ne dispose pas de l’entitlement Pro correspondant
- Code de licence expiré ou e-mail ne correspond pas
- Cliqué sur Démarrer avant l’activation
Correctifs
- Ouvrez le panneau MCP (3.x :
Extension → Cocos MCP Server → Ouvrir le panneau MCP; 2.x :Extension → Serveur MCP) - Activez avec soit :
- Compte VberAI + mot de passe
- E-mail + code de licence
- Confirmez le plan / code sur le centre de compte officiel, puis réessayez dans le panneau
- Après activation uniquement, ouvrez les paramètres du serveur MCP et cliquez sur Démarrer
Sans activation, le serveur n’atteint généralement jamais En cours d’exécution. Corrigez le côté éditeur avant de blâmer Cursor.
Symptôme C : Cliqué sur Démarrer, mais jamais En cours d’exécution
Causes probables
- Toujours pas activé (voir symptôme B)
- Port utilisé (3.x utilise souvent par défaut
3000; 2.x suit le panneau) - Pare-feu / logiciel de sécurité bloque l’écoute localhost
Correctifs
- Notez le port sur la page des paramètres du serveur MCP (les exemples ci-dessous utilisent
3000—remplacez par la valeur de votre panneau) - Vérifiez si quelque chose écoute déjà :
macOS / Linux :
lsof -iTCP:3000 -sTCP:LISTEN
Windows (PowerShell) :
netstat -ano | findstr :3000
- Si un autre processus occupe le port :
- arrêtez ce processus, ou
- choisissez un port libre dans le panneau MCP, puis Démarrer à nouveau
- Assurez-vous que le pare-feu autorise
127.0.0.1(ne pas exposer MCP à l’internet public) - Lorsque le panneau affiche En cours d’exécution, configurez l’IDE IA
Symptôme D : Creator est en cours d’exécution, Cursor n’a pas cocos-creator
La plupart des rapports de « échec de connexion » arrivent ici : éditeur OK, client n’a jamais ingéré la configuration.
Correctifs (dans l’ordre)
- Dans Creator, confirmez que le panneau MCP est toujours En cours d’exécution (les changements de port ou les redémarrages de l’éditeur peuvent l’arrêter)
- Ouvrez le Gestionnaire d’outils et activez les outils dont vous avez besoin
- Ouvrez Configuration rapide → choisissez Cursor → Configuration automatique jusqu’à ce que l’interface affiche Configuré
- Dans Cursor → liste MCP / outils :
- Vous devriez voir
cocos-creator(ou le nom affiché dans le panneau) - Si manquant : Recharger MCP (ou redémarrer Cursor) et vérifiez à nouveau
- Vous devriez voir
- Toujours manquant : vérifiez que la configuration MCP de Cursor contient le pont local (
127.0.0.1+ le port du panneau)
La sortie de la configuration automatique varie selon la version de Cursor. Lors d’une inspection manuelle :
- Le nom du service correspond à Cocos MCP (par exemple
cocos-creator) - L’hôte est
127.0.0.1oulocalhost, le port correspond à Creator - Pas une IP LAN ou publique par erreur
Après toute modification de configuration, rechargez MCP à nouveau ou l’interface conservera l’ancien état.
Autres IDE IA
Dans la configuration rapide, choisissez Claude Code, Codex, Windsurf, Cline, etc., puis Configuration automatique → recharger MCP dans ce client. Configurer Cursor ne connecte pas chaque IDE.
Symptôme E : Affiche connecté, mais ne peut pas lister la scène / modifier les nœuds
Causes probables
- Le projet / la scène ouvert dans Creator ne correspond pas à ce que vous avez demandé
- Les outils nécessaires ne sont pas cochés dans le Gestionnaire d’outils
- Vous avez seulement vérifié « les fichiers sur le disque », pas le contexte de l’éditeur
Vérification
Envoyez une invite en lecture seule dans Cursor :
Listez les noms des nœuds racines de la scène actuellement ouverte dans Cocos Creator.
| Résultat | Signification |
|---|---|
| Correspond à la hiérarchie | Pont OK ; essayez une petite écriture ensuite |
| Erreur claire / pas d’outils | Revenez aux symptômes C/D |
| Noms de nœuds inventés | MCP probablement non utilisé ; vérifiez la connexion et les bascules d’outils |
Ensuite, essayez une petite écriture (créez un nœud temporaire et supprimez-le). Validez avant les grandes modifications.
Tableau rapide 2.x vs 3.x
| Élément | Creator 3.x | Creator 2.x |
|---|---|---|
| Page produit | cocos (3.x) | cocos2x |
| Installation | Gestionnaire d’extensions → Importer | Décompressez dans le projet packages/ |
| Après installation | Activez dans la liste | Doit redémarrer Creator |
| Paquet | 3.x uniquement | 2.x uniquement |
| Étapes complètes | Installation 3.x | Installation 2.x |
Les paquets mixtes apparaissent souvent comme « pas de menu » ou « échec d’importation »—utilisez ce tableau en premier.
Ordre recommandé (liste de contrôle de 5 minutes)
Cochez dans l’ordre ; la plupart des échecs se situent dans les quatre premiers :
- La version majeure de Creator correspond au zip MCP (2.x ↔ 2.x, 3.x ↔ 3.x)
- Extension activée / chemin
packagescorrect ; 2.x redémarré - Panneau activé avec succès
- Panneau affiche En cours d’exécution ; port libre
- Configuration rapide → Configuration automatique pour l’IDE actuel
- MCP rechargé dans l’IDE IA ;
cocos-creatorlisté - Invite en lecture seule liste les racines de la scène actuellement ouverte
Si cela échoue encore, capturez ceci
Lorsque vous demandez de l’aide au support ou à un collègue, incluez :
- Version exacte de Creator (par exemple 3.8.x / 2.4.x)
- Type de pack MCP (2.x ou 3.x Pro)
- Si le panneau est En cours d’exécution, et le port
- Nom/version de l’IDE IA et capture d’écran de la liste MCP
- Invite en lecture seule exacte et réponse
Gardez le pont sur localhost uniquement ; ne publiez pas le port MCP.
Documentation connexe
Poursuivre la lecture
D’autres guides qui pourraient vous intéresser
Traduction en un clic VberAI : UI / Figma / PSD — Copie uniquement, mise en page inchangée
VberAI Studio traduit les maquettes UI et les calques de texte Figma/PSD : copie uniquement, mise en page, design, structure et hiérarchie restent fixes—lancem…
- vberai
- ai-studio
- ui-translate
- ui-translation
Quel outil IA pour l'art de game design ? Générateurs d'assets de jeu vs art IA général (2026)
Quel outil IA pour l'art de game design ? Comparez Layer AI, PicLumen, Meshy, Morphic, Unity AI UI et Midjourney par livrable : concept, 2D, UI, 3D.Les outils …
- game-art
- ai-tools
- concept-art
- game-ui
Unity MCP avec Claude Code et Cursor : Piloter l'éditeur sans écrire chaque modification à la main
Connectez Claude Code, Cursor et Codex à Unity via Model Context Protocol : installez un pont local, prévisualisez les changements et déboguez les scènes au-de…
- unity-mcp
- mcp-for-unity
- claude-unity-mcp
- unity-claude-code