← Retour au blog

Connecter Codex ou ChatGPT à Unity MCP

Connectez Codex ou ChatGPT à Unity MCP : étapes Unity alignées sur le guide d'installation. Codex Open/Copy. ChatGPT STDIO : relais, --port, racine Assets. Vér…

Publié le
  • unity
  • mcp
  • codex
  • chatgpt
  • tutorial
  • unity-mcp
  • ai

Ce que couvre ce guide

Comment connecter Codex ou ChatGPT à Unity MCP ? Les étapes côté Unity (importation, activation, démarrage du serveur) correspondent à l’installation de Unity MCP et à Claude Code + Unity MCP. Ce guide porte uniquement sur la configuration MCP du client — Codex Open/Copy et la configuration STDIO de ChatGPT.

Deux chemins :

  1. Codex CLI — dans One-click Configuration, choisissez Codex CLI, puis Open (automatique) ou Copy d’un extrait config.toml
  2. ChatGPT desktop ou web — pas de Open ; reportez les paramètres du relais copiés dans le formulaire MCP STDIO (commande, arguments, répertoire de travail du projet Unity)

À la fin, vous devriez avoir :

  • Unity MCP Server en état Running dans l’éditeur, avec le port affiché dans le panneau
  • unity-mcp (ou équivalent) enregistré dans le client avec les outils visibles
  • Une invite en lecture seule qui liste les GameObject racines de la Hierarchy de la scène active

Produit : Unity MCP

Prérequis

ÉlémentNotes
Unity2022.3+ / Unity 6 recommandé (voir les notes de support actuelles de l’éditeur)
Unity MCPImporté et activé (guide d’installation)
Serveur en cours d’exécutionLe panneau affiche Running ; notez le port (6589 est un défaut courant — utilisez celui de votre panneau)
Codex CLI ou ChatGPTSupport MCP avec un serveur STDIO personnalisé
Projet UnityLe projet que vous voulez confier à l’agent est ouvert dans Unity
Réseau localLe pont écoute généralement sur 127.0.0.1 — n’exposez pas le port sur l’internet public

La valeur de --port doit correspondre au panneau Unity MCP, et non à un numéro fixe tiré d’un blog ou d’une capture d’écran.

Partie 1 : Unity (identique au guide d’installation)

Si Unity MCP n’est pas encore configuré, suivez l’installation de Unity MCP : Add package from disk → activation dans le panneau MCP → Start service jusqu’à Running → activation des outils sous Tool management.

Les étapes ci-dessous supposent qu’Unity est déjà en état Running.

Partie 2 : Codex CLI

  1. Panneau Unity MCP → One-click Configuration → Codex CLI
  2. Open pour écrire la configuration MCP, ou Copy pour un config.toml manuel
  3. Exemple de forme uniquement — utilisez vos chemins et port copiés (les chemins Windows diffèrent de macOS) :
[mcp_servers.unity-mcp]
command = "/Users/<you>/.unitymcp/relay/<relay-id>/unity-mcp-relay"
args = ["--stdio", "--port", "<panel-port>"]
  1. Redémarrez Codex CLI ou rechargez MCP selon la documentation de Codex
  2. Confirmez que unity-mcp et ses outils apparaissent

Pour le contexte complet Unity + CLI, voir Claude Code + Unity MCP (mêmes étapes Unity, client différent).

Partie 3 : ChatGPT desktop ou web

Dans le panneau Unity MCP, utilisez Codex CLI → Copy pour les paramètres du relais, puis reportez les champs TOML dans ChatGPT. Lors de l’ajout d’un serveur, vous pouvez définir Name et Type (STDIO). Lors de la mise à jour d’une entrée Unity-mcp existante, les champs ci-dessous correspondent à la capture d’écran.

Interface ChatGPT (anglais)Valeur
Name (lors de l’ajout)unity-mcp (identique au nom de section TOML)
Type (lors de l’ajout)STDIO (pas HTTP/SSE)
Start commandChemin complet issu de command = "..." vers unity-mcp-relay (utilisez la sortie Copy sous Windows, Linux ou macOS)
ParametersTrois lignes : --stdio → --port → port numérique du panneau
Environment variablesLaisser vide
Environment variable inheritanceLaisser vide
Working directoryRacine du projet Unity (dossier contenant Assets). Évitez les valeurs par défaut génériques comme ~/code

Référence de l’interface ChatGPT desktop

ChatGPT desktop : Plug-ins → MCP → Update Unity-mcp — start command, trois paramètres (--stdio, --port, numéro de port) et working directory comme dans le tableau

Le chemin du relais, le port et le dossier du projet dans la capture ne sont que des exemples — utilisez la sortie Copy de votre panneau et le chemin parent local de votre Assets.

Cliquez sur Save, puis quittez complètement et redémarrez l’application ChatGPT desktop (sur le web, actualisez et démarrez une nouvelle session avant de tester MCP).

Pourquoi le répertoire de travail est important

Le relais communique avec ChatGPT via STDIO mais a toujours besoin de la racine du projet Unity pour l’éditeur que vous avez ouvert. Modifiez ce chemin lorsque vous changez de projet.

Ce que signifient les paramètres copiés

  • unity-mcp-relay — relais local entre le client MCP et Unity MCP Server dans l’éditeur
  • --stdio — exécute le relais comme sous-processus avec entrée/sortie standard
  • --port — doit correspondre au port du service Running ; un mauvais port ou un serveur arrêté provoque des échecs ou des délais d’attente

Vérifier la connexion

Envoyez d’abord une invite en lecture seule, par exemple :

Liste les GameObject racines de la scène Unity active via MCP.

Si la réponse correspond à la Hierarchy d’Unity, essayez une petite écriture (par exemple créer un GameObject vide MCP_SmokeTest, puis le supprimer). Validez dans le contrôle de version avant les modifications importantes.

Si le serveur est Running mais que l’éditeur est absent des instances actives, consultez la FAQ d’installation de Unity MCP.

Aide-mémoire client

ClientAction typique dans le panneau
Cursorauto configure en un clic
Claude Code / Gemini CLICopy CLI command → exécuter dans le terminal
Codex CLIOpen ou Copy → config.toml
ChatGPT desktop / webCopy des paramètres du relais → formulaire STDIO + working directory

Vue d’ensemble : Quels clients IA Unity MCP prend en charge

FAQ

Le Copy de Codex fonctionne-t-il pour ChatGPT ? Oui — mêmes command et arguments ; ChatGPT a aussi besoin du bon working directory.

La connexion MCP a échoué dans ChatGPT ? Vérifiez : Unity Running ; --port correspond au panneau ; le chemin du relais existe et est exécutable ; le working directory est le parent de Assets ; Save puis redémarrez le client.

Aucun outil Unity dans Codex ? Essayez à nouveau Open dans le panneau, ou recollez Copy dans config.toml et redémarrez Codex. Toujours bloqué → instances actives.

Dois-je encore écrire tout le C# à la main ? Pour les scripts du quotidien, l’IA peut créer et attacher des composants via MCP — vous révisez les modifications, compilez et testez en Play mode. Conservez la propriété humaine de l’architecture, du réseau et des chemins critiques (FAQ clients).

Étapes suivantes

D’autres guides qui pourraient vous intéresser