Bêta ouverte de Unity AI : Comment se lancer avec MCP
Dans l'article d'aujourd'hui consacré à la bêta ouverte d'Unity AI, découvrez comment connecter Claude Code, GitHub Copilot et d'autres agents IA directement à l'éditeur Unity grâce au serveur MCP (Model Context Protocol) de Unity.
Le serveur MCP d'Unity AI offre une nouvelle façon de travailler avec des agents IA au sein de votre IDE. Au lieu de passer sans cesse de votre éditeur de code à Unity, vous pouvez connecter des agents tels que Claude Code, Cursor, Windsurf ou VS Code Copilot directement à votre projet Unity en cours d'exécution. L'IDE aura ainsi accès à l'intégralité du contexte du projet : il pourra notamment inspecter les scènes, lire les sorties de la console, modifier les scripts et déclencher des actions de l'éditeur sans que vous ayez à copier-coller le contexte.
Cet article explique en détail ce qu'est MCP, comment connecter un agent, quels outils sont disponibles et comment vous pouvez l'utiliser pour accélérer des tâches de développement courantes telles que la correction de bogues et la gestion des scènes.
Qu'est-ce que le protocole Model Context Protocol ?
Le Model Context Protocol (MCP) est une norme ouverte qui permet aux agents d'IA de communiquer avec des outils et des sources de données externes de manière structurée. Le serveur MCP de Unity met en œuvre ce protocole afin que tout agent IA compatible MCP puisse se connecter à l'éditeur Unity et interagir avec lui comme s'il s'agissait d'un ensemble d'outils pouvant être appelés.
Sans MCP, un agent IA dans votre IDE ne voit que ce que vous lui montrez : les fichiers que vous avez ouverts, le code que vous collez ou les erreurs que vous copiez. Grâce à MCP, il dispose d'un accès en temps réel à l'état d'exécution de votre projet Unity (hiérarchie des scènes, GameObjects, valeurs des composants, paramètres de compilation et messages de la console) via un protocole standardisé.
Le serveur MCP officiel de Unity est inclus dans le pack AI Assistant et nécessite un abonnement Unity pour être utilisé (bien que cela n'entraîne pas de consommation de crédits Unity AI).
Conditions préalables
Pour commencer à utiliser MCP, votre environnement doit répondre aux exigences suivantes :
- Unity 6 (6000.0) ou une version ultérieure avec le pack AI Assistant installé
- Un client d'IA compatible avec MCP, tel que Claude Code, Cursor, Windsurf ou Claude Desktop
- Un projet Unity connecté à Unity Cloud
- Un essai ou un abonnement actif à Unity AI
Comment intégrer un agent IA à Unity
La configuration de Unity MCP ne prend que quelques minutes. Voici la procédure complète :
1. Vérifiez que le pont Unity MCP est en cours d'exécution
Dans l'éditeur Unity, allez dans Édition > Paramètres du projet > IA > Unity MCP. Vérifiez que Unity Bridge affiche « En cours d'exécution » (indicateur vert). Le pont se lance automatiquement dès le chargement de l'éditeur. Si le statut indique « Arrêté », sélectionnez « Démarrer ».
2. Configurez votre client IA
La section « Intégrations » de la page des paramètres Unity MCP permet de configurer automatiquement les clients pris en charge : développez la section « Intégrations », sélectionnez votre client, puis cliquez sur « Configurer ». Les clients pris en charge peuvent inclure Claude Code, Cursor, Windsurf et Claude Desktop, selon la version de Unity MCP dont vous disposez.
3. Ajoutez manuellement le chemin du Relay (si nécessaire)
Si votre client ne figure pas dans la liste de configuration automatique, ajoutez une entrée de serveur pointant vers le fichier binaire du Relay Unity. Le Relay est installé dans le répertoire ~/.unity/relay/ au démarrage de Unity. Passez l'argument de ligne de commande --mcp à l'exécutable Relay.
4. Valider la connexion dans Unity
Lors de la première connexion de votre agent, Unity affiche un message indiquant « Connexion en attente ». Allez dans Édition > Paramètres du projet > IA > Unity MCP, vérifiez les informations relatives au client, puis sélectionnez Accepter. Les clients déjà approuvés se reconnectent automatiquement.
5. Vérifiez la connexion
Votre agent devrait maintenant vous présenter la liste des outils Unity MCP disponibles. Exécutez une commande simple telle que « Lire les messages de la console Unity et récapituler les avertissements ou les erreurs » pour vérifier que la connexion fonctionne.
Chemins de relais spécifiques à la plateforme
Le chemin d'accès binaire au Relay varie selon le système d'exploitation. Utilisez le chemin d'accès correspondant à votre plateforme lorsque vous configurez votre agent manuellement :
- macOS (Apple Silicon): ~/.unity/relay/relay_mac_arm64.app/Contents/MacOS/relay_mac_arm64
- macOS (Intel): ~/.unity/relay/relay_mac_x64.app/Contents/MacOS/relay_mac_x64
- Windows : %USERPROFILE%\.unity\Relay\Relay_win.exe
- Linux : ~/.unity/Relay/Relay_linux
Outils disponibles
Une fois connecté, votre agent IA a accès à un ensemble d'outils Unity MCP intégrés. Ces outils sont ce à quoi l'agent fait appel lorsque vous lui donnez des instructions : il n'interagit pas directement avec Unity, mais passe par le protocole.
Les principales catégories d'outils sont les suivantes :
- Gestion des scènes : lecture de la hiérarchie, création/modification/suppression de GameObjects, gestion des scènes
- Édition de scripts : créez, consultez et modifiez des scripts C# dans votre projet
- Accès à la console : consulter les journaux, les avertissements et les erreurs depuis la console Unity
- Inspection d'un GameObject : lecture et écriture des valeurs des composants sur des GameObjects spécifiques
- Paramètres de compilation : vérifier la plate-forme et la configuration de compilation
Vous pouvez également enregistrer des outils MCP personnalisés en C# afin de mettre vos propres flux de travail d'éditeur à la disposition des agents connectés, ce qui s'avère utile pour les équipes souhaitant automatiser des tâches spécifiques à un projet.
Contrôler Unity à partir d'un agent IA
Une fois la connexion MCP établie, vous pouvez donner des instructions en langage naturel à votre agent IA, qui les exécutera à l'aide des outils de Unity. Quelques exemples :
- « Créez un nouvel objet GameObject vide nommé PlayerSpawn à la position (0, 0, 0) »
- « Analyse la hiérarchie de la scène et indique-moi quels objets ont des composants manquants. »
- « Écrivez un script qui permette à la caméra de suivre le joueur, puis associez-le à la caméra principale. »
- « Vérifiez s’il y a des erreurs dans la console et corrigez tout ce qui concerne les références nulles. »
L'agent utilise les outils MCP pour effectuer chaque étape, en exposant son raisonnement et les appels d'outils qu'il effectue. Vous restez dans votre IDE tout au long du processus ; vous n'avez pas besoin de passer à Unity tant que vous ne souhaitez pas vérifier le résultat.
Résolution des erreurs de console avec Unity MCP
L'une des utilisations les plus pratiques de Unity MCP consiste à permettre à votre agent de lire et de corriger les erreurs de console de manière autonome. Comme l'agent peut à la fois consulter la console et modifier des scripts au cours de la même session, il peut passer de l'erreur à la correction sans que vous ayez à copier quoi que ce soit :
1. L'agent lit la console via Unity_ReadConsole
2. Identifie le script concerné et en lit le contenu
3. Apporte une correction et enregistre le fichier dans le projet
4. Relit la console pour vérifier que l'erreur a bien été résolue
Cela permet de boucler la boucle de rétroaction qui nécessite habituellement un copier-coller manuel entre Unity et un assistant IA : l'agent se charge de tout du début à la fin.
En savoir plus sur Unity AI
Si vous souhaitez en savoir plus sur les fonctionnalités disponibles dans la version bêta ouverte de Unity AI, nous vous invitons à consulter les autres articles de cette série :
Essayez Unity AI dès aujourd'hui
La bêta ouverte d'Unity AI est désormais disponible pour tous les développeurs utilisant Unity 6. Inscrivez-vous pour bénéficier d'un essai gratuit, découvrez l'assistant IA de Unity AI, connectez vos outils préférés via Unity AI Gateway et commencez à tester votre flux de travail de développement avec un agent IA intégré capable de s'adapter à votre projet.
Inscrivez-vous et découvrez nos offres, nos tarifs et notre politique de confidentialité sur unity.com/features/ai
La documentation complète est disponible dans la documentation Unity AI, accessible depuis l'éditeur, ou sur docs.unity3d.com.
Unity AI Assistant est actuellement en version bêta ouverte. Par conséquent, les fonctionnalités, le comportement et la disponibilité décrits dans cet article sont en cours de développement et sont susceptibles d'être modifiés, limités ou supprimés sans préavis.