Assistant IA Unreal Engine : configuration et sécurité de MCP dans UE 5.8

Réponse directe : comment fonctionne Unreal MCP dans Unreal Engine 5.8

Unreal Engine 5.8 intègre un Plugin Unreal MCP expérimental qui intègre un serveur Model Context Protocol dans le processus Unreal Editor. Activez Unreal MCP dans Édition > Plugins, redémarrez l'éditeur, choisissez si le serveur doit se lancer automatiquement, générez la configuration client pour votre agent IA, et lancez cet agent depuis la racine du projet. Le point de terminaison par défaut est http://127.0.0.1:8000/mcp. Traitez chaque appel d’outil comme une action d’éditeur effectuée en votre nom : gardez la connexion locale, partez d’une révision propre en contrôle de version, demandez un changement borné, inspectez le diff et l’Output Log, exécutez la validation Unreal correspondante et annulez ce que vous ne pouvez pas expliquer.

C’est la réponse pratique derrière les recherches « Unreal Engine 5.8 MCP », « Unreal MCP setup » et « Unreal MCP plugin ». Ce n’est pas une promesse qu’un agent IA peut construire ou publier de manière sûre un jeu complet sans surveillance. Epic qualifie le plugin d’Experimental, indique que les fonctionnalités et formats de données peuvent évoluer, et ne documente aucune couche d’authentification pour le serveur local par défaut. Utilisez-le comme une surface d’automatisation d’éditeur contrôlée, pas comme un service de production à distance.

Ce que Epic a réellement publié dans UE 5.8

d’Epic Documentation Unreal MCP décrit un serveur qui fonctionne à l'intérieur d'Unreal et expose les fonctionnalités de l'éditeur comme des outils MCP. Les exemples documentés incluent l'apparition d'Actors, la configuration de l'éclairage, la création d'instances de matériau, l'inspection de widgets Slate et l'exécution de tests d'automatisation. Tout client compatible MCP peut se connecter via HTTP local ; Epic cite explicitement les chemins de configuration Claude Code, Cursor, MCP Inspector, Gemini, VS Code et Codex.

La distinction entre le serveur et ses outils compte. Unreal MCP gère le serveur de protocole, les paramètres et les commandes. Le Toolset Registry et le plugin AllToolsets fournissent les jeux d'outils éditeur qui deviennent des outils MCP appelables. Si un client se connecte mais liste aucun outil utile, ne supposez pas que le modèle est défectueux : vérifiez d'abord que les plugins de jeux d'outils dépendants sont activés et actualisez la liste des outils.

d’Epic Annonce UE 5.8 MCP prend en charge l’option Experimental et indique que le plugin peut connecter les systèmes LLM au contexte du moteur et du projet. Le Notes de version 5.8 restent l’autorité de version. Ce guide resserre ces affirmations générales en un flux de configuration et de revue ; il ne les transforme pas en claims non pris en charge sur un shipping autonome, une certification de plateforme ou la prise de contrôle d’Unreal Editor par SEELE.

Préparez un projet réversible avant d'activer un agent

Effectuez le travail de sécurité avant le prompt intéressant. Utilisez une copie, une branche ou un changelist pouvant être abandonnés. Fermez les modifications non liées, enregistrez la map actuelle et notez précisément la version UE 5.8 exacte et l’état du plugin. Décidez quel dossier, niveau, acteur, matériau ou test l’agent peut modifier. Une demande du type « modifier toute la scène » n’est pas un critère d’acceptation ; « créer une Point Light dans le niveau sandbox et s’arrêter » l’est.

Conservez la première tâche locale et jetable. L'écouteur MCP par défaut est en loopback uniquement et ne comporte pas de couche d'authentification. Epic indique qu'il n'est pas conçu pour une utilisation à distance. Ne rendez pas le port 8000 accessible via un tunnel, une adresse de liaison publique, une machine de build partagée ou une règle de pare-feu entrante uniquement pour qu'un client puisse se connecter. Si votre organisation a besoin d'automatisation à distance, concevez séparément une authentification, une isolation réseau, une journalisation d'audit et une frontière d'approbation au lieu de considérer le mode expérimental par défaut comme une infrastructure de production.

Rédigez un registre d’acceptation de cinq lignes avant le premier appel :

• Révision de départ : commit, changelist ou état propre de working-tree.
• Périmètre autorisé : un niveau, un dossier d’actifs, un test ou un sous-système de l’éditeur.
• Changement attendu : l'Actor, la propriété, l'asset ou le résultat de test exact.
• Modification interdite : les paramètres du projet, les plugins, les fichiers source, les suppressions, ou les commandes externes, sauf s'ils ont été examinés explicitement.
• Rollback: annulez le diff, restaurez la map, ou supprimez la branche.

Ce petit contrat est plus utile qu’un long prompt car il permet à un réviseur de distinguer un appel d’outil correct d’un résultat séduisant mais incontrôlé.

Configurer Unreal MCP en cinq étapes vérifiables

Effectuez la configuration suivante dans l’ordre et vérifiez chaque limite avant de passer à la suite. La première connexion réussie ne doit prouver qu’une découverte locale et une action réversible dans l’éditeur ; elle ne doit pas étendre l’autorité de l’agent ni devenir un service distant.

1. Activez le plugin et redémarrez

Ouvrez Edit > Plugins, recherchez Unreal MCP, activez-le, et redémarrez lorsque cela vous est demandé. Epic documente que la dépendance du Toolset Registry est activée automatiquement. Vérifiez que le nom convivial du plugin est Unreal MCP ; l’identifiant interne utilisé par les sources du moteur, les commandes console et les symboles C++ est ModelContextProtocol.

2. Démarrez le serveur local

Ouvrez Edit > Editor Preferences > General > Model Context Protocol. Activez Démarrage automatique du serveur si ce projet doit démarrer le serveur avec l’éditeur. La valeur par défaut documentée est http://127.0.0.1:8000/mcp. Si le port 8000 entre en conflit avec un autre service local, changez le port d'écoute à cet endroit plutôt que de supposer qu'une erreur côté client est une défaillance d'Unreal.

Pour une session à la demande, désactivez le démarrage automatique et exécutez ModelContextProtocol.StartServer dans la console Unreal. Epic documente également un argument de port facultatif, par exemple ModelContextProtocol.StartServer 8000. Vérifiez que le journal de sortie affiche l'adresse de liaison, le port et le chemin avant d’ouvrir le client IA.

3. Générer la configuration du client

Dans la console Unreal, générez la configuration du client que vous utiliserez réellement. Epic documente ModelContextProtocol.GenerateClientConfig ClaudeCode et prend en charge ClaudeCode, Cursor, VSCode, Gemini, Codex, ou All. Le point d'entrée HTTP généré pointe vers le point final local et utilise le nom du serveur unreal-mcp.

Les configurations JSON du client sont fusionnées avec les entrées existantes, selon Epic. Le chemin TOML de Codex CLI est intentionnellement en mode écriture unique : une entrée obsolète doit être vérifiée et supprimée manuellement au lieu d’être réécrite silencieusement. Vérifiez le fichier généré avant de l’intégrer au contrôle de version ; la configuration de l’agent local peut contenir des chemins ou choix spécifiques à la machine qui ne doivent pas figurer dans le projet partagé.

4. Lancez l’agent depuis la racine du projet

Lancez le client IA sélectionné à partir de la racine du projet ou de l'espace de travail où Unreal a écrit la configuration. Si le client ne peut pas trouver unreal-mcp, vérifiez son répertoire de travail avant de regénérer les fichiers ou de réinstaller des plugins. Connectez-vous uniquement après le lancement de l’éditeur et du serveur pour que le client découvre le schéma d’outil actuel.

5. Prouvez la découverte avec une tâche de lecture préalable

Demandez au client de lister ou de rechercher les outils disponibles avant de demander une écriture. Puis choisissez une inspection en lecture seule, comme l’identification des Actors sélectionnés ou le rapport des propriétés d’un asset nommé. Conservez le nom de l’outil, les arguments, le résultat et l’horodatage. Une réponse de chat réussie ne prouve pas que l’état Unreal a changé ; vérifiez l’objet dans l’éditeur et dans le diff de contrôle de version.

Comprendre la limite entre appel d’outil et game thread

Le protocole MCP définit comment un client découvre et appelle des outils typés. L’implémentation d’Epic synchronise les requêtes externes avec le thread de jeu Unreal et exécute les invocations d’outils en série. Les clients ne doivent pas envoyer d’appels d’outils qui se chevauchent. Il s’agit d’une contrainte de correction, pas seulement d’un conseil de performance : deux demandes simultanées qui supposent toutes deux qu’elles détiennent la sélection, l’état des assets ou une transaction de l’éditeur peuvent produire des résultats inattendus.

Utilisez une séquence délibérée :

1. Découvrez le schéma d’outil actuel.
2. Lisez l’état cible.
3. Effectuez un seul appel d’outil borné.
4. Attendez son résultat avant d’envoyer un autre appel.
5. Relisez la cible et inspectez la transaction Unreal ou le diff de la source.
6. Enregistrez uniquement après que la condition d'acceptation est remplie.

Si vous ajoutez un ensemble d’outils ou modifiez une fonction d’outil, exécutez ModelContextProtocol.RefreshTools et reconnectez le client. Epic indique que Live Coding ne propage pas les nouvelles déclarations UFUNCTION, donc l’ajout d’un nouvel outil nécessite un redémarrage de l’éditeur. Ne continuez pas à demander des prompts contre un ancien schéma puis reprochez au modèle des incohérences de paramètres.

Utilisez un flux de travail centré sur l'éditeur, pas une promesse autonome

MCP ne rend pas un mesh importé, une texture ou un asset généré prêt à la production. Pour les entrées FBX, GLB, OBJ ou 3D packagées, conservez le workflow réel visible : importer, prévisualiser, corriger, optimiser, convertir, exporter, puis valider dans Unreal. Avant l'importation dans Unreal, inspectez l'échelle, le pivot, l'orientation, les normales, les UV, les emplacements de matériau, les références de texture, le poids des polygones, les besoins de collision, les besoins de LOD et le format d'exportation. Le Optimiseur d’actifs 3D Unreal peut prendre en charge cette revue pré-import sans prétendre modifier un .uproject.

Dans Unreal, utilisez MCP pour une opération d'éditeur délimitée uniquement après avoir compris l'actif. Par exemple, demandez d'abord à l'agent d'inspecter un asset Static Mesh nommé et d'en rapporter les champs, puis approuvez une seule tâche réversible de placement ou d'instance de matériau. Validez l'échelle par rapport à une référence connue, inspectez l'éclairage et les emplacements de matériau, lancez des vérifications de collision et de navigation, profilez des vues représentatives, et empaquetez une petite build cible lorsque le changement peut affecter le comportement d'exécution.

SEELE peut aider à planifier la scène, nettoyer un actif exporté, ou comparer une direction jouable dans le navigateur. Il n'installe pas Unreal MCP, n'opère pas votre éditeur, n'exporte pas un jeu Unreal natif, ne compile pas automatiquement du Blueprint ou du C++, ne configure pas Nanite ou Lumen, et ne prouve pas qu'une version empaquetée réussit. Ces étapes restent dans le vrai jeu Unreal sous revue humaine.

Déboguer la connexion, la découverte et les échecs de schéma périmé

Lorsque le serveur ne semble pas démarrer, consultez d'abord le journal de sortie Unreal. Epic fait transiter les messages de plugin via LogModelContextProtocol; augmentez la verbosité avec Log LogModelContextProtocol Verbose. Un conflit de port, une dépendance manquante, un échec de liaison ou de démarrage doit être diagnostiqué là-bas avant de modifier le prompt de l'agent.

Utilisez l'inspecteur MCP officiel pour distinguer les problèmes de protocole et de schéma de l'interprétation d'un client IA. Pointez-le vers http://127.0.0.1:8000/mcp via Streamable HTTP. Si l’Inspector peut lister et appeler un outil mais que le client sélectionné ne le peut pas, le problème restant se situe dans la configuration du client, la détection du répertoire de travail ou le comportement du client. Si aucun des deux ne voit l’outil, vérifiez l’état du plugin Unreal, le Toolset Registry, AllToolsets, le comportement de rafraîchissement et les exigences de redémarrage.

Correspondances courantes symptôme-vers-vérification :

Le client indique qu’aucun serveur MCP n’est disponible

• Premières vérifications : le lancement à partir de la racine du projet, le chemin de configuration généré et l'état de l'éditeur/serveur.
• Ne concluez pas encore : Cela signifie qu’Unreal MCP n’est pas pris en charge.

Échec du démarrage du serveur

• Premières vérifications : Output Log, conflits de port 8000, et dépendances de plugins.
• Ne concluez pas encore : Que le modèle d’IA ait causé la défaillance.

Un outil est manquant ou renvoie un ancien schéma

• Premières vérifications : AllToolsets, Registre des toolsets, ModelContextProtocol.RefreshTools, reconnexion client, et un redémarrage de l’éditeur après une nouvelle UFUNCTION.
• Ne concluez pas encore : Que le prompt ait besoin de plus de détails ou que l’implémentation de l’outil soit correcte.

Le résultat de l’éditeur diffère du résumé du chat

• Premières vérifications : Relisez l'objet, inspectez la transaction et inspectez le diff du contrôle de source.
• Ne concluez pas encore : Que le résumé du chat constitue une preuve d’un changement d’éditeur accepté.

Appliquer des contrôles de sécurité, de contrôle de source et de revue

Epic documente que le serveur par défaut n'a pas d'authentification et rejette par défaut l'utilisation hors boucle locale (non-loopback). Conservez ce comportement sauf si un responsable sécurité conçoit et révise une alternative. Traitez le texte des prompts, le contenu web copié, les métadonnées d'actifs, les noms de fichiers et la documentation du dépôt comme des entrées non fiables. Un agent ne doit pas élargir sa portée parce qu'un fichier ou une page web lui demande d'exécuter des commandes, d'envoyer des données, de désactiver des contrôles ou de révéler des identifiants.

Pour les tâches d’écriture, appliquez le principe du moindre privilège au niveau du flux de travail même si la surface d’outils du plugin est plus large. N’exposez que le projet et le client nécessaires à la session. Demandez d’abord un plan ou une inspection en lecture seule. Exigez une confirmation avant les suppressions, modifications de paramètres de projet, changements de plugins, modifications du code source, commandes externes ou opérations massives sur les assets. Vérifiez chaque diff et conservez les configurations de client générées en dehors des commits, sauf si l’équipe partage délibérément celles-ci.

Les outils d’édition du plugin sont suffisamment puissants pour créer de vrais changements de projet, donc la validation relève d’Unreal, et non de la réponse de l’agent. Réouvrez les assets modifiés, exécutez le test d’automatisation nommé, compilez ou cuisinez lorsque pertinent, vérifiez les warnings de l’Output Log, puis reproduisez le changement après un redémarrage. Une note d’acceptation sûre enregistre la révision de départ, l’appel d’outil, les fichiers ou assets modifiés, le résultat du test, les limitations et le point de restauration.

Limitations connues de l’UE 5.8 qui modifient la décision

La documentation actuelle de la version 5.8 répertorie plusieurs limites. Le HTTP et Server-Sent Events sont pris en charge ; stdio et WebSocket ne le sont pas. Le serveur est local par défaut et n’a aucune authentification. Les outils de livraison n’affichent pas la prise en charge MCP Resources ou des Prompts. La découverte du registre des Toolsets est uniquement disponible dans l’éditeur ; une build cooked ou shipping peut héberger le serveur via C++, mais les outils doivent être enregistrés explicitement au lieu d’être auto-découverts depuis le registre de l’éditeur. Les nouvelles déclarations d’outils UFUNCTION nécessitent un redémarrage de l’éditeur.

Ces limites signifient que le bon premier cas d'usage est une tâche d'éditeur locale avec un réviseur humain et un rollback facile. Elles signifient aussi que "le serveur peut tourner dans une version shipping" n'autorise pas à exposer une surface d'automatisation non authentifiée dans un jeu livré. Cela nécessiterait une conception de sécurité distincte, un enregistrement explicite des outils, des contrôles réseau, une revue produit et des preuves sur le build réel.

Poursuivez dans le cluster de workflow Unreal 5.8

Utilisez le Aperçu de la version UE 5.8 pour le contexte de version plus large, y compris la worldbuilding, le rendu, MetaHuman, le mobile et les systèmes prêts pour la production. Utilisez le Plan de compatibilité Kimi K3 et UE 5.8 MCP lors de l’évaluation d’une combinaison modèle-client nommée plutôt que de supposer que chaque client MCP se comporte de la même manière. Comparez le meilleurs assistants IA et outils MCP pour Unreal avant de choisir un client, et gardez les assets binaires et les changements générés révisables avec le Guide de contrôle de version Unreal.

Pour le protocole lui-même, utilisez le Documentation Model Context Protocol. Pour le comportement d'Unreal, privilégiez la documentation versionnée d'Epic et les notes de version. Les tutoriels communautaires peuvent aider avec des captures d'écran et l'ergonomie propre à certains clients, mais ils ne remplacent pas les labels de statut, les valeurs par défaut ou les limitations connues d'Epic.

Questions fréquemment posées

Unreal Engine 5.8 dispose-t-il d’un plugin MCP officiel ?

Oui. Epic documente qu'Unreal MCP est un plugin Expérimental dans Unreal Engine 5.8. Il intègre un serveur MCP dans le processus Unreal et expose les capacités du moteur via des outils. Expérimental signifie que les API, formats et couvertures peuvent changer, donc gardez les tâches bornées et vérifiez le comportement avec la documentation versionnée d'Epic.

Comment activer Unreal MCP dans UE 5.8 ?

Ouvrez Edit > Plugins, recherchez Unreal MCP, activez-le, puis redémarrez l’éditeur. Ensuite, ouvrez Editor Preferences > General > Model Context Protocol pour configurer le démarrage automatique, le port et le chemin. Confirmez l’endpoint du serveur dans l’Output Log avant de générer la configuration du client.

Quels clients IA peuvent se connecter à Unreal MCP ?

Tout client MCP compatible peut utiliser l’endpoint HTTP. Epic documente la génération de configuration pour Claude Code, Cursor, VS Code, Gemini, Codex et une option All. La prise en charge d’un client ne garantit pas un comportement identique des outils ; validez la découverte, les schémas, les approbations et les diffs avec la version exacte du client que vous comptez utiliser.

Est-il sûr d’exposer le serveur Unreal MCP à distance ?

Non, pas avec la configuration UE 5.8 par défaut. Epic indique que le serveur se lie à la loopback par défaut, rejette les origines non-loopback et n’a pas de couche d’authentification. Gardez-le en local. L’usage à distance nécessite une architecture de sécurité distincte avec authentification, isolement réseau, journaux d’audit, outils à périmètre contrôlé, validations, et un plan de retour arrière en cas d’incident.

Pourquoi mon client Unreal MCP n’a-t-il pas d’outils ?

Vérifiez que Unreal MCP, Toolset Registry et le contenu AllToolsets requis sont activés. Consultez la sortie LogModelContextProtocol, exécutez ModelContextProtocol.RefreshTools après les modifications de jeux d'outils, reconnectez le client et redémarrez l'éditeur après avoir ajouté de nouvelles déclarations UFUNCTION. Utilisez MCP Inspector pour distinguer les échecs serveur/schéma des erreurs d'interprétation du client.

SEELE AI peut-il configurer Unreal MCP ou modifier mon .uproject ?

Non. SEELE peut aider à planifier un prototype de style Unreal ou à examiner des actifs 3D exportés avant l'importation, mais il n'installe pas de plugins, ne contrôle pas l'éditeur Unreal, ne modifie pas un fichier .uproject natif, ne compile pas de Blueprint ou de C++, ne configure pas Nanite ou Lumen, et ne teste pas une version packagée. Ces actions doivent être réalisées et validées dans le jeu Unreal réel.