Unity MCP avec Claude Code et Cursor : Piloter l'éditeur sans écrire chaque modification à la main

La limite de « l’IA écrit du C# dans un dossier »

Les outils de codage basés sur le chat sont efficaces pour générer des scripts. L’IA qui ne modifie que des fichiers manque toujours l’état en direct de l’éditeur : scènes ouvertes, GameObjects sélectionnés, variantes de prefabs, comportement en mode Play et erreurs de la Console.

Si le modèle ne voit que les fichiers sur disque, il devine la hiérarchie et ne peut pas cliquer sur Play, renommer un nœud dans la Hiérarchie ou inspecter une référence manquante. Les équipes ont besoin de l’assistant dans la boucle du moteur, pas seulement dans le dépôt.

Model Context Protocol (MCP) est un standard permettant aux clients IA d’appeler des outils. Un serveur Unity MCP expose des actions de l’éditeur via un pont local, permettant à des clients comme Claude Code, Cursor et les workflows de type Codex de lire et modifier le projet pendant qu’Unity est en cours d’exécution.

VberAI fournit un plugin Unity MCP pour ce pont. Ce guide est un parcours pratique de configuration et d’utilisation, pas une liste de fonctionnalités.

Ce que Unity MCP change dans le travail quotidien

Sans MCP	Avec Unity MCP
Collez des scripts générés, puis corrigez vous-même les erreurs de compilation	Demandez au client de créer un script et de l’attacher à un GameObject nommé
Dupliquez manuellement les panneaux UI	Invite : « Clone Panel_Shop sous Canvas et renomme les enfants »
Décrivez les erreurs de la Console dans le chat	Laissez le client lire les journaux récents / le contexte de sélection (là où le plugin l’expose)
Devinez la disposition de la scène à partir du YAML	Interrogez la hiérarchie, puis modifiez avec confirmation

Vous examinez toujours les diffs et les résultats en mode Play. Vous arrêtez de taper chaque clic d’éditeur qu’un agent peut faire en toute sécurité.

Prérequis

• Projet Unity ouvert (LTS recommandé pour le travail en équipe)
• Un client compatible MCP : Claude Code, Cursor, Windsurf ou similaire
• Accès réseau local à 127.0.0.1 (le pont reste généralement sur loopback)
• Le package VberAI Unity MCP pour votre version d’Unity (téléchargement / docs)

Optionnel mais utile : une petite scène d’exemple (Canvas vide + deux boutons) pour vérifier facilement les premières invites.

Liste de vérification de configuration

1. Installer le plugin Unity MCP

1. Importez le package dans votre projet (ou installez-le via le workflow de package de votre équipe)
2. Activez l’extension / l’entrée de menu (les noms varient légèrement selon la version – cherchez MCP ou AI Bridge)
3. Rechargez l’éditeur si Unity le demande

2. Démarrer le pont MCP local

Ouvrez le panneau du plugin et démarrez le serveur. Confirmez :

• Le statut indique en cours d’exécution
• L’hôte est localhost (n’exposez pas le port publiquement)
• Le chemin du projet correspond au projet Unity que vous souhaitez modifier

3. Enregistrer le serveur dans votre client IA

Dans Cursor ou Claude Code, ajoutez une entrée de serveur MCP pointant vers le pont Unity local (stdio ou HTTP/SSE – suivez la documentation actuelle du plugin).

Redémarrez le client si les outils n’apparaissent pas. Vous devriez voir des outils liés à Unity (lecture de scène, opérations sur les nœuds, etc.).

4. Effectuer un test de fumée en lecture seule

Demandez :

Listez les GameObjects racines dans la scène active.

Si la réponse correspond à la Hiérarchie, le pont fonctionne. Ce n’est qu’ensuite que vous essayez les actions d’écriture.

5. Effectuer un petit test d’écriture

Demandez :

Créez un GameObject vide nommé MCP_SmokeTest sous la racine de la scène.

Trouvez-le dans la Hiérarchie, puis supprimez-le. Privilégiez les tests réversibles avant les grandes refactorisations.

Modèles d’invite qui fonctionnent bien

Structure d’abord

Affiche les enfants de Canvas/HUD et résume lesquels sont des LayoutGroups.

Écritures ciblées

Sous Canvas/Menu, renomme Button en Btn_Start et définis le texte du label TMP sur Start.

Boucle de débogage

Après avoir appuyé sur Play, résume les erreurs de la Console liées à PlayerController et suggère la plus petite correction.

Associer avec l’UI générée

Si vous avez importé un écran depuis AI Studio, utilisez MCP pour câbler les écouteurs onClick ou aligner les noms avec vos conventions C# – sans reconstruire le prefab à la main.

Habitudes de sécurité

• Gardez le pont sur localhost uniquement
• Préférez lire → planifier → écrire plutôt qu’une seule invite géante « reconstruire le jeu »
• Validez avant les grandes modifications de l’agent
• Ne collez pas de secrets dans les invites ; MCP ne remplace pas le contrôle d’accès
• Traitez le mode Play et l’actualisation de la base de données d’actifs comme des points de contrôle humains

MCP réduit les clics manuels dans l’éditeur. Il ne supprime pas la revue de code.

Relation avec les assistants IA intégrés d’Unity

Les assistants Unity intégrés et les plugins Unity MCP tiers résolvent des tâches qui se chevauchent. Évaluez-les de la même manière :

1. L’outil peut-il voir la hiérarchie / la sélection en direct ?
2. Peut-il effectuer des modifications réversibles que vous pouvez auditer ?
3. Fonctionne-t-il avec le client IA que votre équipe utilise déjà (Claude Code, Cursor, …) ?

Unity MCP est le plus pertinent lorsque votre équipe vit déjà dans ces clients et souhaite un protocole unique entre les moteurs (de nombreux studios utilisent aussi Godot ou Cocos MCP avec la même habitude).

FAQ

Dois-je toujours écrire du C# ?
Oui. MCP est le meilleur pour les opérations de l’éditeur et le scaffolding. Les systèmes de gameplay, le réseau et les performances nécessitent toujours des ingénieurs.

Claude Code vs Cursor ?
Les deux fonctionnent s’ils prennent en charge MCP et que vous les pointez vers le même serveur Unity local. Choisissez le client que votre dépôt utilise déjà ; le pont est la pièce partagée.

Est-ce uniquement pour l’UI ?
Non. La hiérarchie, les composants et les opérations de scène s’appliquent aussi aux objets de gameplay. L’UI est simplement une première démo facile.

Où est la vidéo de démonstration ?
Voir Plugin Unity Game Engine MCP (guide vidéo) sur le chemin de la chaîne VberAI pour un enregistrement de configuration.

Prochaines étapes

1. Installez Unity MCP dans une scène jetable
2. Connectez Claude Code ou Cursor et réussissez le test de fumée en lecture seule
3. Automatisez une tâche que vous détestez (renommage par lot, duplication de panneau, attachement de script)

Lorsque le goulot d’étranglement est le passage du design au prefab plutôt que les opérations de l’éditeur, associez cela au flux de travail Figma → Unity AI Studio.