Assistant IA Unreal Engine : Guide d'installation UE 5.8 MCP | SEELE AI

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

Unreal Engine 5.8 fournit un Experimental Unreal MCP plugin qui intègre un serveur de protocole de contexte modèle dans le processus Unreal Editor. Activez Unreal MCP dans Edit > Plugins, redémarrez l’éditeur, choisissez si le serveur doit démarrer 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 pour vous : garder la connexion locale, partir d’une révision proprement contrôlée de source source, demander un changement borné, inspecter le diff et le journal de sortie, exécuter la validation Unreal pertinente, et annuler tout ce que vous ne pouvez pas expliquer.

C’est la réponse pratique derrière les recherches pour « Unreal Engine 5.8 MCP », « Unreal MCP setup » et « Unreal MCP plugin ». Ce n’est pas une promesse qu’un agent IA puisse construire ou livrer un jeu entier en toute sécurité sans surveillance. Epic étiquette le plugin comme Expérimental, indique que les fonctionnalités et les formats de données peuvent changer, et ne documente aucune couche d’authentification pour le serveur local par défaut. Utilisez-le comme une surface contrôlée d’automatisation de l’éditeur, pas comme un service de production distant.

Ce qu’Epic a réellement sorti en UE 5.8

La documentation MCP Unreal MCP d'Epic décrit un serveur qui fonctionne à l'intérieur d'Unreal et expose des fonctionnalités d'éditeur sous forme d'outils MCP. Les exemples documentés incluent la génération d'Acteurs, la configuration de l'éclairage, la création d'instances de matériaux, l'inspection des widgets Slate et la réalisation de tests d'automatisation. Tout client compatible MCP peut se connecter via HTTP local ; Epic nomme explicitement Claude Code, Cursor, MCP Inspector, Gemini, VS Code et les chemins de configuration du Codex.

La distinction entre le serveur et ses outils est importante. Unreal MCP possède le serveur de protocoles, les paramètres et les commandes. Le Toolset Registry et le plugin AllToolsets fournissent l’éditeur des ensembles d’outils qui deviennent des outils MCP appelables. Si un client se connecte mais ne liste aucun outil utile, ne supposez pas que le modèle est défaillant : commencez par confirmer que les plugins dépendants sont activés et rafraîchir la liste d’outils.

L'annonce UE 5.8 appelle le support MCP Expérimental et indique que le plugin peut connecter les systèmes LLM au moteur et au contexte du projet. Les 5.8 notes de version restent l'autorité de version. Ce guide réduit ces affirmations générales à un flux de travail de configuration et de revue ; il ne les étend pas en affirmations non supportées concernant la livraison autonome, la certification de plateforme ou SEELE contrôlant Unreal Editor.

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

Faites le travail de sécurité avant la consigne intéressante. Utilisez une copie, une branche ou une liste de modifications qui peut être supprimée. Fermez les modifications non liées, enregistrez la carte actuelle et enregistrez l’état exact de la compilation et du plugin UE 5.8. Décidez quel dossier, niveau, Acteur, matériau ou test l’agent peut toucher. Une demande comme « changer toute la scène » n’est pas un critère d’acceptation ; « créer un Point Light dans le niveau bac à sable et arrêter » l’est.

Gardez la première tâche locale et jetable. L’écouteur MCP par défaut est uniquement en boucle et n’a pas de couche d’authentification. Epic indique qu’il n’est pas conçu pour un usage distant. N’exposez pas le port 8000 via un tunnel, une adresse de liaison publique, une machine de compilation partagée ou une règle de pare-feu entrant juste pour faire se connecter un client. Si votre organisation a besoin d’automatisation à distance, créez l’authentification, l’isolation réseau, la journalisation des audits et une frontière d’approbation séparément, au lieu de traiter le port par défaut expérimental comme une infrastructure de production.

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

• Révision initiale : commit, changelist ou état d’arbre de travail clean.
• Portée autorisée : un niveau, dossier d’actifs, test ou sous-système éditeur.
• Changement attendu : l’Acteur exact, la propriété, l’actif ou le résultat du test.
• Changement interdit : paramètres de projet, plugins, fichiers sources, suppressions ou commandes externes sauf si cela est explicitement révisé.
• Retour en arrière : inverser le diff, restaurer la carte ou supprimer la branche.

Ce petit contrat est plus utile qu’un long prompt car il permet à un évaluateur de distinguer une invocation d’outil correcte d’un résultat attrayant mais non contrôlé.

Configurez Unreal MCP en cinq étapes vérifiables

Complétez la configuration suivante dans l'ordre et vérifiez chaque frontière avant de continuer. La première connexion réussie ne devrait prouver que la découverte locale et une action réversible de l'éditeur ; elle ne doit pas étendre l'autorité de l'agent ni devenir un service distant.

1. Activez le plugin et redémarrez

Ouvrir Modifier > Plugins, chercher Unreal MCP, l’activer, et redémarrer quand on le demande. Epic documente que la dépendance au Toolset Registry est activée automatiquement. Vérifie que le nom amical du plugin est Unreal MCP ; l’identifiant interne utilisé par la source du moteur, les commandes console et les symboles C est ModelContextProtocol.

2. Démarrer le serveur local

Ouvrir les préférences d’édition > de l’éditeur > le protocole général de contexte > modèle. Activez Serveur de démarrage automatique si ce projet doit démarrer le serveur avec l’éditeur. Le défaut documenté 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 un échec Unreal.

Pour une session à la demande, laissez le démarrage automatique désactivé et exécutez ModelContextProtocol.StartServer dans la console Unreal. Epic documente également un argument de port optionnel, par exemple ModelContextProtocol.StartServer 8000. Confirmez que le journal de sortie rapporte l’adresse de liaison, le port et le chemin avant d’ouvrir le client IA.

3. Générer la configuration client

Dans la console Unreal, générez la configuration pour le client que vous allez réellement utiliser. Epic documente ModelContextProtocol.GenerateClientConfig ClaudeCode et supporte ClaudeCode, Cursor, VSCode, Gemini, Codex, ou All. Le HTTP généré pointe vers le point de terminaison local et utilise le nom serveur unreal-mcp.

Les configurations client JSON sont fusionnées avec les entrées existantes, selon Epic. Le chemin TOML du Codex CLI est intentionnellement write-once-once : une entrée obsolète doit être examinée et supprimée manuellement au lieu d’être silencieusement écrasée. Inspectez le fichier généré avant de l’accepter dans le contrôle de version ; la configuration locale de l’agent peut contenir des chemins ou des choix spécifiques à la machine qui n’appartiennent pas au projet partagé.

4. Lancez l’agent à partir de la racine du projet

Démarrez le client IA sélectionné depuis la racine du projet ou de l’espace de travail où Unreal a écrit la configuration. Si le client ne trouve pas unreal-mcp, vérifiez son répertoire de travail avant de régénérer des fichiers ou de réinstaller des plugins. Connectez-vous seulement après que l’éditeur et le serveur soient en cours d’exécution afin que le client découvre le schéma de l’outil actuel.

5. Prouver la découverte avec une tâche de lecture en premier

Demandez au client de lister ou de rechercher les outils disponibles avant de demander une écriture. Choisissez ensuite une inspection en lecture seule, comme identifier des acteurs sélectionnés ou rapporter les propriétés d'un asset nommé. Conservez le nom de l'outil, les arguments, le résultat et l'horodatage. Une réponse réussie dans le chat ne prouve pas qu'Unreal State a changé ; vérifiez l'objet dans l'éditeur et dans la diff.

Comprendre la frontière entre l’appel d’outils et le thread de jeu

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 Unreal Game et exécute les invocations d'outils en série. Les clients ne doivent pas émettre d'appels d'outils qui se chevauchent. C'est une contrainte de correction, pas seulement un indice de performance : deux requêtes concurrentes qui supposent toutes deux posséder une sélection, un état d'asset ou une transaction d'éditeur peuvent produire des résultats qu'aucune des deux invites n'avait anticipés.

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

1. Découvrez le schéma actuel de l’outil.
2. Lisez l’état cible.
3. Faites un appel d’outil borné.
4. Attendez le résultat avant d’envoyer un autre appel.
5. Relisez la cible et inspectez la transaction Unreal ou la différence source.
6. Sauvegardez seulement après que la condition d’acceptation soit remplie.

Si vous ajoutez un ensemble d’outils ou modifiez une fonction d’outil, exécutez ModelContextProtocol.RefreshTools et reconnectez le client. Epic note que le Live Coding ne propage pas de nouvelles déclarations d’UFUNCTION, donc ajouter un nouvel outil nécessite un redémarrage de l’éditeur. Ne continuez pas à solliciter un ancien schéma pour ensuite blâmer le modèle pour les incompatibilités de paramètres.

Utilisez un flux de travail axé sur les assets de 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 packées, gardez le flux de travail réel visible : uploader ou importer, prévisualiser, corriger, optimiser, convertir, exporter, puis valider dans Unreal. Avant l’importation Unreal, inspectez l’échelle, le pivot, l’orientation, les normales, les UV, les emplacements matériaux, les références de textures, le poids des polygones, les besoins de collision, les besoins en LOD et le format d’exportation. Le Unreal 3D asset optimizer peut supporter cette revue pré-importation sans prétendre modifier un .uproject.

Dans Unreal, utilisez MCP pour une opération d’éditeur borné seulement après que l’asset a été compris. Par exemple, demandez à l’agent d’inspecter d’abord un asset Static Mesh nommé et des champs de rapport ; puis approuvez une tâche de placement réversible ou d’instance de matériau. Validez l’échelle par rapport à une référence connue, inspectez les ombrages et les emplacements de matériaux, effectuez des vérifications de collision et de navigation, profilez des vues représentatives, et empaquetez une petite construction cible lorsque le changement peut affecter le comportement à l’exécution.

SEELE AI génère un projet natif Unreal Engine, incluant ses fichiers .uproject et projet, et présente l'application Unreal en cours d'exécution dans le navigateur via Pixel Streaming. Ce flux de travail produit est distinct de la configuration du plugin Unreal MCP d'Epic dans un éditeur local spécifique. Considérez l'installation du plugin, l'exposition locale du serveur, les approbations d'outils éditeurs et l'acceptation des compilations packed comme des étapes à revoir indépendamment. Examinez le code généré, les Blueprints, les assets, les plugins, les dépendances, la version du moteur, les performances, le packaging et les exigences de la plateforme cible avant la sortie.

Débogage de connexion, découverte et défaillances de schéma obsolet

Lorsque le serveur ne semble pas démarrer, lisez d’abord le journal de sortie Unreal. Epic fait passer les messages du plugin via LogModelContextProtocol ; augmentez la verbosité avec Log LogModelContextProtocol Verbose. Un conflit de port, une dépendance manquante, une défaillance de liaison ou un problème de démarrage doivent être diagnostiqués à cet endroit avant de modifier l’invite de l’agent.

Utilisez l'Inspecteur MCP officiel pour séparer 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 HTTP Streamable. Si l'Inspecteur peut lister et appeler un outil mais que le client sélectionné ne le peut pas, le problème restant appartient à la configuration client, à la découverte de répertoires de travail ou au comportement client. Si aucun des deux ne peut voir l'outil, inspectez l'état du plugin Unreal, le registre des outils, AllToolsets, le comportement de rafraîchissement et les exigences de redémarrage.

Mappages courants entre les symptômes et les vérifications :

Le client signale l’absence de serveur MCP

• Premières vérifications : Lancement de la phase de projet root, chemin de configuration généré, et état de l’éditeur/serveur.
• Ne concluez pas encore : Que Unreal MCP n’est pas supporté.

Le serveur ne démarre pas

• Premières vérifications : Journal de sortie, conflits de port 8000 et dépendances des plugins.
• Ne concluez pas encore : Que le modèle IA a causé l’échec.

Un outil manque ou renvoie un ancien schéma

• Premières vérifications : AllToolssets, Toolset Registry, ModelContextProtocol.RefreshTools, reconnexion client, et redémarrage d’un éditeur après une nouvelle UFUNCTION.
• Ne concluez pas encore : Que l’invite nécessite plus de détails ou que l’implémentation de l’outil est correcte.

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

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

Appliquer des portes de sécurité, de contrôle de sources et de révision

Epic documente que le serveur par défaut n’a pas d’authentification et rejette par défaut l’utilisation non-loopback. Gardez-le ainsi à moins qu’un responsable de la sécurité ne conçoive et examine une alternative. Considérez le texte d’invitation, 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 la portée parce qu’un fichier ou une page web lui ordonne d’exécuter des commandes, de télécharger des données, de désactiver des vérifications ou de révéler des identifiants.

Pour les tâches d'écriture, utilisez le minimum de privilèges au niveau du workflow même si la surface de l'outil du plugin est plus large. Exposez uniquement le projet et le client nécessaires pour la session. Demandez d'abord un plan ou une inspection en lecture seule. Exigez une confirmation avant les suppressions, les changements de paramètres de projet, les modifications du plugin, les modifications de source, les commandes externes ou les opérations massives d'assets. Révisez chaque diff et gardez les configurations clients générées hors du commit, sauf si l'équipe les partage délibérément.

Les outils éditeurs du plugin sont suffisamment puissants pour créer de vrais changements de projet, donc la validation appartient à Unreal, pas à la réponse de l'agent. Rouvrez les assets modifiés, exécutez le test d'automatisation nommé, compilez ou cuisinez quand c'est pertinent, vérifiez les avertissements du journal de sortie, et reproduisez la modification après un redémarrage. Une note d'acceptation sécurisée enregistre la révision de départ, l'appel à l'outil, les fichiers ou assets modifiés, le résultat du test, les limitations et le point de rollback.

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

La documentation actuelle de la 5.8 mentionne plusieurs limites. Les événements HTTP et envoyés par serveur sont pris en charge ; les transports stdio et WebSocket ne le sont pas. Le serveur est uniquement local par défaut et n’a aucune authentification. Les ensembles d’outils de livraison ne font pas la publicité des ressources ou invites MCP. La découverte du registre des outils se fait uniquement par l’éditeur ; une compilation cuisinée ou livrée peut héberger le serveur via C , mais les outils doivent être enregistrés explicitement plutôt que d’être découverts automatiquement depuis le registre des éditeurs. Les nouvelles déclarations d’outils UFUNCTION nécessitent un redémarrage de l’éditeur.

Ces limites signifient que le bon premier cas d’utilisation est une tâche d’éditeur local avec un relecteur humain et un retour en arrière facile. Elles signifient aussi que « le serveur peut fonctionner dans une version expédiée » n’est pas une permission pour intégrer une surface d’automatisation non authentifiée dans un jeu sorti. Cela nécessiterait un design de sécurité séparé, une inscription explicite des outils, des contrôles réseau, une revue produit, et des preuves de la version réelle.

Poursuivez à travers le cluster de workflow Unreal 5.8

Utilise leAperçu de la sortie UE 5.8pour le contexte de la version étendue, y compris la création de mondes, le rendu, MetaHuman, le mobile et les systèmes prêts pour la production. Utilise lePlan de compatibilité Kimi K3 et UE 5.8 MCPlorsqu'on évalue une combinaison modèle-client spécifique plutôt que de supposer que tous les clients MCP se comportent de la même manière. Comparez lemeilleurs assistants IA et outils MCP pour Unrealavant de choisir un client, et garder les actifs binaires et les changements générés révisables avec leGuide de contrôle de version Unreal.

Pour le protocole lui-même, utilisez la documentation Model Context Protocol. Pour le comportement Unreal, privilégiez la documentation versionnée et les notes de version d'Epic. Les tutoriels communautaires peuvent aider avec les captures d'écran et l'ergonomie spécifique au client, mais ils ne supplantent pas les étiquettes de statut, les paramètres par défaut ou les limitations connues d'Epic.

FAQ

Est-ce que Unreal Engine 5.8 possède un plugin MCP officiel ?

Oui. Epic documente Unreal MCP en tant que 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 limitées et vérifiez le comportement par rapport à la documentation versionnée d’Epic.

Comment puis-je activer Unreal MCP dans UE 5.8 ?

Ouvrez Edit > Plugins, cherchez Unreal MCP, activez-le, puis redémarrez l’éditeur. Ouvrez ensuite les Préférences de l’éditeur > General > Model Context Protocol pour configurer le démarrage automatique, le port et le chemin. Confirmez le point d’accès serveur dans le Journal de sortie avant de générer la configuration client.

Quels clients IA peuvent se connecter à Unreal MCP ?

Tout client MCP compatible peut utiliser le point de terminaison HTTP. Epic documente la génération de configuration pour Claude Code, Cursor, VS Code, Gemini, Codex et une option All. Le support client ne garantit pas un comportement identique à l’outil, donc validez la découverte, les schémas, les approbations et les diffs avec la version cliente exacte que vous envisagez d’utiliser.

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

Non, pas avec la configuration UE 5.8 par défaut. Epic indique que le serveur se lie à la boucle par défaut, rejette les origines non-loopback, et n’a pas de couche d’authentification. Gardez la localité. L’utilisation à distance nécessite une architecture de sécurité séparée avec authentification, isolation réseau, journaux d’audit, outils de périmètre, approbations et un plan de retour en arrière d’incident.

Pourquoi mon client Unreal MCP manque-t-il d’outils ?

Vérifie que le MCP Unreal, le registre de l’outil et le contenu AllToolsets requis sont activés. Lis la sortie de LogModelContextProtocol, exécute ModelContextProtocol.RefreshTools après des changements dans l’outil, reconnecte le client et redémarre l’éditeur après avoir ajouté de nouvelles déclarations UFUNCTION. Utilise MCP Inspector pour séparer les échecs serveur/schéma de l’interprétation côté client.

Comment la génération de projet natif SEELE AI est-elle liée au MCP Unreal ?

SEELE AI génère un projet natif Unreal Engine, y compris son fichier .uproject et les fichiers de projet, et montre l’application en cours d’exécution dans le navigateur via Pixel Streaming. Le MCP Unreal est une intégration séparée de l’éditeur pour connecter un client MCP à une session spécifique de l’éditeur Unreal ; configure et valide cette intégration locale indépendamment, avec revue du contrôle de version et permissions d’outil limitées.