Guide d'installation Unity MCP : Ajouter le package depuis le disque et connecter un IDE IA
Installez VberAI Unity MCP Pro étape par étape—Package Manager Ajouter le package depuis le disque, activez votre compte, démarrez le serveur MCP local (port p…
- unity
- mcp
- cursor
- tutorial
- unity-mcp
- ai
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/fr/game-engines/unity?ch=CQZLC2FG)
Flux suggéré :
- Ouvrez la page et téléchargez Unity MCP Pro avec les permissions de votre compte
- Enregistrez l’archive localement et décompressez-la dans un dossier fixe (l’étape suivante nécessite
package.jsonà l’intérieur) - Confirmez que
package.jsonexiste 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
- Ouvrez votre projet Unity cible
- Menu Window → Package Manager
- Cliquez sur + en haut à gauche du panneau Package Manager
- Choisissez Add package from disk
- Sélectionnez le fichier
package.jsondans 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
- Menu Window → Unity MCP → Mcp Panel
- Sur l’écran d’activation, soit :
- Connectez-vous avec compte VberAI + mot de passe
- Ou entrez e-mail + code d’activation
- 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
- Après l’activation, ouvrez la page des paramètres du serveur Unity MCP
- 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)
- Port : défaut
- Cliquez sur Démarrer le service
- 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)
- 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
- Ouvrez Configuration rapide
- Choisissez votre IDE (par exemple Cursor)
- Cliquez sur Auto-configurer
- Confirmez que l’interface affiche Configuré
- 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.
Poursuivre la lecture
D’autres guides qui pourraient vous intéresser
Godot MCP vs Scripting Manuel : Quand le Contrôle du Moteur par IA a du Sens
Guide pratique : utilisez VberAI Godot MCP pour les prototypes et le code répétitif, gardez le GDScript manuel pour les chemins critiques—basé sur les pratique…
- godot-mcp
- vberai
- comparison
- GDScript
VberAI Studio : Diviser les images de conception d'UI de jeu et les importer dans Unity / Godot / Cocos
VberAI Studio divise les images d'UI plein écran en éléments d'UI, conserve la mise en page et le dimensionnement, et exporte vers Unity, Godot et Cocos.
- vberai
- ai-studio
- game-ui
- game-art
Créer un RPG 3D avec Unity MCP : Contrôle à la troisième personne, Combat et Quêtes
Guide pratique Unity MCP pour un prototype RPG 3D jouable : mouvement à la troisième personne, mêlée en temps réel, machines à états ennemies et quêtes dans Cu…
- Unity MCP
- 3D RPG
- Unity
- combat