Guide d'installation de Cocos Creator 3.x MCP : Importer l'extension et connecter un IDE IA

Ce que couvre ce guide

Suivez ces cinq étapes pour connecter Cocos Creator 3.x MCP (VberAI Pro) à un projet Creator local afin que Cursor (ou un autre IDE IA compatible MCP – même principe) puisse opérer, prévisualiser et déboguer l’éditeur – pas seulement modifier des scripts sur disque.

Lorsque vous aurez terminé, vous devriez être en mesure de :

• Importer et activer cocos-mcp-server via le gestionnaire d’extensions
• Activer avec un compte VberAI ou un e-mail + code d’activation
• Démarrer le serveur MCP Cocos local (port par défaut 3000)
• Utiliser Configuration rapide → Configuration automatique pour enregistrer le serveur dans Cursor et confirmer la connexion

Page produit : VberAI Cocos MCP 3.x

Cet article utilise Cursor comme exemple. Claude Code, Windsurf, Cline et d’autres clients MCP suivent un flux similaire.

Prérequis

Élément	Notes
Cocos Creator	3.0+ (n’importe quel projet 3.x)
Paquet de plugin	Archive Cocos Creator 3.x MCP Pro du site officiel
Activation	Compte VberAI + mot de passe, ou e-mail + code d’activation
IDE IA	Cursor recommandé ; d’autres clients MCP fonctionnent aussi
Réseau local	Le pont MCP fonctionne généralement sur 127.0.0.1 – n’exposez pas le port publiquement

Étape 1 : Télécharger Cocos Creator 3.x MCP

Téléchargez la version Pro depuis le site VberAI :

Page de téléchargement : https://www.vberai.com/game-engines/cocos?ch=CQZLC2FG

Flux suggéré :

1. Ouvrez la page et téléchargez Cocos MCP 3.x Pro avec les permissions de votre compte
2. Enregistrez l’archive localement – vous n’avez pas besoin de la décompresser dans le projet pour l’instant (l’étape suivante importe l’archive)
3. Confirmez que le projet est en Creator 3.0 ou plus récent ; ne mélangez pas avec le paquet 2.x

Les différences OSS vs Pro et la facturation suivent la copie actuelle du site.

Étape 2 : Importer l’extension

1. Ouvrez votre projet Cocos Creator 3.x
2. Menu : Extension → Gestionnaire d’extensions → Importer une extension
3. Sélectionnez l’archive Cocos Creator 3.x MCP que vous venez de télécharger
4. Après une importation réussie, la liste des extensions devrait afficher cocos-mcp-server activé

S’il apparaît désactivé, activez-le avant de continuer.

Étape 3 : Activer cocos-mcp-server

1. Menu : Extension → Cocos MCP Server → Ouvrir le panneau MCP
2. Sur l’écran d’activation, utilisez soit :
   • Compte VberAI + mot de passe
   • E-mail + code d’activation
3. Après la réussite de l’activation, ouvrez la page des paramètres du serveur MCP (étape suivante)

Sans activation, le serveur ne démarrera généralement pas. Confirmez que votre plan ou code correspond à la version Pro actuelle.

Étape 4 : Démarrer cocos-mcp-server

1. Après l’activation, ouvrez Paramètres du serveur MCP
2. Ajustez selon vos besoins :
   • Port : par défaut 3000
   • Langue : correspond à votre préférence d’interface
   • Démarrage : utilisez les options du panneau (par exemple démarrage automatique avec l’éditeur, si disponible)
3. Cliquez sur Démarrer le service
4. Lorsque le panneau affiche En cours d’exécution, Cocos MCP Server est opérationnel

Vous avez maintenant un pont MCP local. Ensuite, confiez-le à votre IDE IA.

Étape 5 : Configuration en un clic pour IDE IA (exemple Cursor)

1. Ouvrez Gestionnaire d’outils
   • Passez en revue les outils exposés par Cocos MCP Server
   • Activez uniquement ceux que vous souhaitez que l’IA utilise
2. Ouvrez Configuration rapide
   • Choisissez votre IDE (par exemple Cursor)
   • Cliquez sur Configuration automatique
   • Confirmez que l’interface affiche un état configuré
3. Ouvrez Cursor
   • Dans la liste MCP / outils, vous devriez voir cocos-creator (ou le nom affiché dans le panneau) connecté
   • S’il est manquant, cliquez sur Recharger (ou l’équivalent de rechargement MCP) dans Cursor et vérifiez à nouveau

Les autres IDE suivent le même chemin – choisissez simplement un client différent sous Configuration rapide.

Vérification rapide après connexion

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. Ensuite, essayez une petite écriture (créez un nœud temporaire et supprimez-le) pour confirmer les permissions et la sélection d’outils.

FAQ

L’importation a échoué, ou cocos-mcp-server est absent de la liste ?
Utilisez l’archive officielle 3.x (pas 2.x). Creator doit être 3.0+. S’il reste désactivé, activez-le dans le gestionnaire d’extensions et redémarrez Creator.

L’activation échoue toujours ?
Confirmez les droits Pro, ou que le code d’activation est valide et lié à la bonne adresse e-mail. Vérifiez le centre de compte sur le site, puis réessayez dans le panneau.

J’ai cliqué sur Démarrer le service mais je ne vois jamais En cours d’exécution ?
Confirmez que le port 3000 (ou votre port personnalisé) est libre et que localhost n’est pas bloqué. Assurez-vous que l’étape 3 a été complétée avec succès.

Cursor n’affiche pas cocos-creator ?
Dans Creator, confirmez que le serveur est toujours En cours d’exécution, exécutez à nouveau Configuration rapide → Configuration automatique, puis rechargez MCP dans Cursor. Si cela échoue toujours, vérifiez que la configuration MCP de Cursor inclut l’adresse du pont local.

Prochaines étapes

• Utilisez le langage naturel pour une requête de scène ou une petite modification afin d’apprendre les limites des outils
• Validez avant les modifications importantes ; gardez le pont sur localhost uniquement
• Pour l’interface de conception à moteur, associez avec VberAI Studio, puis itérez dans l’éditeur avec MCP

Pour Creator 2.x, suivez le guide d’installation Cocos Creator 2.x MCP – ne mélangez pas les paquets. Pour clarifier les limites et la différence avec le vague « Cocos Creator AI », voir Qu’est-ce que Cocos Creator MCP. Pour plus de contexte MCP, consultez le guide vidéo Cocos Creator MCP.