Guide d'installation Unity MCP : Ajouter le package depuis le disque et connecter un IDE IA

Ce que couvre ce guide

Suivez ces cinq étapes pour connecter Unity MCP (VberAI Pro) à un projet Unity local afin que Cursor (ou un autre IDE IA compatible MCP—les étapes sont similaires) puisse opérer, prévisualiser et déboguer l’éditeur—pas seulement éditer des scripts sur le disque.

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

• Importer Unity MCP via le Package Manager Ajouter le package depuis le disque
• Activer avec un compte VberAI ou un e-mail + code d’activation
• Démarrer le serveur Unity MCP local (port par défaut 6589)
• Utiliser Configuration rapide → Auto-configurer pour enregistrer le serveur dans Cursor et confirmer la connexion

Page produit : VberAI Unity MCP

Ce guide utilise Cursor comme exemple. Claude Code, Windsurf, Cline et d’autres clients MCP suivent la même idée.

Prérequis

Élément	Notes
Unity	2022.3+ / Unity 6 recommandé (suivez les notes de support actuelles du site)
Package du plugin	Archive Unity MCP Pro du site officiel, déjà décompressée
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 s’exécute généralement sur 127.0.0.1—n’exposez pas le port publiquement

Étape 1 : Télécharger Unity MCP

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

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

Flux suggéré :

1. Ouvrez la page et téléchargez Unity MCP Pro avec les permissions de votre compte
2. Enregistrez l’archive localement et décompressez-la dans un dossier fixe (l’étape suivante nécessite package.json à l’intérieur)
3. Confirmez que package.json existe dans le dossier décompressé avant d’ouvrir Unity

Les différences OSS vs Pro et les prix suivent la documentation officielle actuelle.

Étape 2 : Importer le package

1. Ouvrez votre projet Unity cible
2. Menu Window → Package Manager
3. Cliquez sur + en haut à gauche du panneau Package Manager
4. Choisissez Add package from disk
5. Sélectionnez le fichier package.json dans le dossier décompressé de l’étape 1

Après une importation réussie, le package Unity MCP devrait apparaître dans la liste du Package Manager.

Étape 3 : Activer unity-mcp

1. Menu Window → Unity MCP → Mcp Panel
2. Sur l’écran d’activation, soit :
   • Connectez-vous avec compte VberAI + mot de passe
   • Ou entrez 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 service ne démarrera généralement pas. Confirmez que votre plan ou code correspond à la version Pro actuelle.

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

1. Après l’activation, ouvrez la page des paramètres du serveur Unity MCP
2. Ajustez selon vos besoins :
   • Port : défaut 6589
   • Langue : correspond à votre préférence d’interface
   • Démarrage : suivez 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, le serveur Unity MCP est opérationnel

Vous avez maintenant un pont MCP local—ensuite, remettez-le à votre IDE IA.

Étape 5 : Configuration en un clic de l’IDE IA (exemple Cursor)

1. Ouvrez Gestion des outils
   • Passez en revue les outils exposés par le serveur Unity MCP
   • Activez uniquement ceux que vous voulez que le modèle utilise
2. Ouvrez Configuration rapide
   • Choisissez votre IDE (par exemple Cursor)
   • Cliquez sur Auto-configurer
   • Confirmez que l’interface affiche Configuré
3. Ouvrez Cursor
   • MCP / outils devrait lister unity-mcp comme connecté
   • Si ce n’est pas le cas, cliquez sur Recharger (ou l’équivalent de rechargement MCP) dans Cursor et vérifiez à nouveau

Les autres IDE utilisent le même flux de configuration rapide—changez simplement le client.

Vérification rapide après connexion

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

Listez les objets racine dans la hiérarchie de la scène actuellement ouverte dans Unity.

Si la réponse correspond à l’éditeur, le pont est sain. Ensuite, essayez une petite écriture (créez un GameObject vide temporaire et supprimez-le) pour confirmer les permissions et la sélection d’outils.

FAQ

Add package from disk ne trouve pas package.json ?
Confirmez que l’étape 1 a entièrement décompressé l’archive et que vous avez sélectionné package.json à la racine de ce dossier—pas dans un extrait imbriqué.

L’activation échoue toujours ?
Vérifiez les droits Pro, l’expiration du code et la liaison e-mail dans votre compte officiel, puis réessayez dans Mcp Panel.

Service démarré mais pas En cours d’exécution ?
Assurez-vous que le port 6589 (ou votre port personnalisé) est libre et que localhost n’est pas bloqué. Confirmez que l’activation de l’étape 3 a réussi.

Cursor n’affiche pas unity-mcp ?
Confirmez que Unity affiche toujours En cours d’exécution, exécutez à nouveau Configuration rapide → Auto-configurer, puis rechargez MCP dans Cursor. Si nécessaire, vérifiez que la configuration MCP de Cursor pointe vers le pont local.

Prochaines étapes

• Essayez une requête de scène en langage naturel ou une petite modification pour apprendre les limites des outils
• Validez avant les grandes modifications ; gardez le pont sur localhost uniquement
• Pour l’interface de conception à moteur, associez avec VberAI Studio pour le transfert Figma / PSD, puis itérez avec MCP

Plus de contexte Unity + MCP : Guide vidéo Unity MCP, Unity MCP avec Claude Code et Cursor.