Cursor Cassé Après Cocos Creator MCP : Corriger la Connexion par Symptôme

Après avoir installé Cocos MCP et l’avoir configuré une fois dans Cursor, beaucoup de gens ont l’impression que Cursor est cassé : le chat ne peut pas toucher la scène, le panneau MCP est tout rouge, ou cela fonctionnait hier et a disparu aujourd’hui. Dans la plupart des cas, Cursor lui-même va bien—le pont MCP est en panne. Soit le serveur côté Creator ne tourne pas, soit la configuration / le rechargement de Cursor n’a jamais pris effet.

Ce guide part des symptômes que vous pouvez voir dans Cursor, afin que vous sachiez quelle couche vérifier ensuite. Les étapes longues côté Creator (importation d’extension, codes d’activation, conflits de ports) se trouvent dans le guide général : Dépannage de connexion Cocos MCP. Si vous avez besoin de la frontière du produit, voir Qu’est-ce que Cocos Creator MCP.

Premièrement : Cursor est-il cassé, ou le pont ?

Ce que vous ressentez	Cause la plus probable
Cursor écrit toujours du code normal, mais ne peut pas atteindre les scènes/nœuds Cocos	MCP non connecté ou outils non activés
La liste MCP n’a pas de cocos-creator (ou le nom de la configuration rapide)	Configuration non écrite, ou rechargement nécessaire
Le nom du service existe mais affiche une erreur / déconnecté	Creator ne tourne pas, mauvaise URL/port, ou rechargement nécessaire
Affiche connecté, mais ne peut pas lister les nœuds de la scène ouverte	Mauvais projet, outils non cochés, ou mauvaise vérification en lecture seule

Claude Code, Codex, et autres clients MCP suivent la même idée : confirmez que le client a une entrée de service saine, puis vérifiez Creator.

Étape 1 : Regardez uniquement le MCP dans Cursor

Ouvrez les paramètres MCP / outils de Cursor (les libellés de menu peuvent varier selon la version) et vérifiez :

1. Si cocos-creator apparaît (ou le nom écrit par la configuration rapide de Creator)
2. Si le statut est connecté / utilisable—pas bloqué en erreur, déconnecté, ou vide
3. Si vous venez de changer la configuration ou d’exécuter Auto configure dans Creator : faites un Rechargement de fenêtre (ou équivalent MCP reload), puis revérifiez la liste

Un cas courant : Creator affiche déjà Running, mais Cursor détient toujours une configuration obsolète—sans rechargement, cela semble « soudainement cassé ».

Étape 2 : Confirmez que l’URL pointe vers le Creator local

L’entrée MCP de Cursor doit cibler une URL de pont locale, généralement :

• http://127.0.0.1:3000/mcp
• ou http://localhost:3000/mcp

Utilisez le port affiché dans le panneau MCP de Creator (souvent 3000 par défaut ; si vous l’avez changé, faites correspondre le panneau).

Ouvrez également Cocos Creator et confirmez que le panneau MCP est Running pour le même projet. Si le panneau ne tourne pas, Recharger dans Cursor ne fera pas apparaître les outils comme par magie.

Pages produits (choisissez le package pour votre version majeure ; ne mélangez pas) :

• Cocos MCP 3.x
• Cocos MCP 2.x

Étape 3 : Si cela échoue encore, sautez par couche

Le chemin MCP a quatre couches. Une défaillance à n’importe quelle couche peut ressembler à « Cursor est cassé / ne se connecte pas » :

1. Plugin dans le projet et activé
        ↓
2. Panneau activé (compte / code de licence)
        ↓
3. Serveur MCP affiche Running (localhost)
        ↓
4. Cursor a la configuration écrite et la liste MCP affiche connecté

Ce que vous voyez dans Cursor	Allez ici en premier
Aucune entrée de service du tout	Couche 4 : retournez à Creator → Configuration rapide → Auto configure, puis Recharger ; détails dans le guide général
Entrée existe mais erreur / ne peut pas se connecter	Couche 3 : Creator tourne-t-il, le port correspond-il, localhost est-il bloqué
Pas de menu MCP dans Creator	Couche 1 : mélange de packages 2.x/3.x, chemin d’importation, redémarrage (symptôme A du guide général)
Le panneau ne peut pas démarrer / non activé	Couche 2 : compte et activation (guide général)
Connecté mais ne peut pas lister les nœuds	Confirmez que le bon projet est ouvert ; exécutez le test en lecture seule ci-dessous ; puis vérifiez les bascules d’outils

Installation complète :

• Installation MCP Cocos Creator 3.x
• Installation MCP Cocos Creator 2.x

Étape 4 : Test de fumée (confirmez que c’est corrigé)

Dans Cursor, commencez par une vérification en lecture seule, par exemple :

Listez les nœuds racines de la scène actuellement ouverte dans Cocos Creator.

Si la réponse correspond à la hiérarchie de l’éditeur, le pont fonctionne. Optionnellement, faites une écriture réversible (créez un nœud temporaire et supprimez-le). Validez avant les grosses modifications ; gardez le pont en localhost uniquement—n’exposez pas le port MCP à l’Internet public.

Questions fréquentes

Que signifie généralement « Cursor cassé » après Cocos Creator MCP ?
Signes typiques : aucune entrée de service MCP, statut rouge/erreur, ou connecté sans outils/nœuds. La plupart des cas ne sont pas un crash de Cursor—il s’agit d’une couche manquante dans le pont à quatre couches.

Dois-je vérifier Cursor ou Creator en premier ?
Commencez par la liste MCP de Cursor (manquant vs rouge). Ensuite, vérifiez Creator : plugin importé/activé, panneau activé, serveur en cours d’exécution, port correspondant à la configuration. Utilisez le tableau des symptômes dans cet article.

Connecté mais aucun nœud—quelle est la prochaine étape ?
Confirmez que le bon projet/scène est ouvert ; effectuez un test de fumée en lecture seule (liste des nœuds racine). Si cela échoue encore, vérifiez les bascules d’outils et les autorisations. Chemin complet : dépannage de connexion.

Dois-je réinstaller Cursor ?
Généralement non. Préférez « configuration rapide → configuration automatique » de Creator, rechargez MCP, et vérifiez le port localhost. Limite de catégorie : Qu’est-ce que Cocos Creator MCP.