← Torna al blog

Connetti Codex o ChatGPT a Unity MCP

Connetti Codex o ChatGPT a Unity MCP: i passaggi in Unity seguono la guida all'installazione. Codex Open/Copy. ChatGPT STDIO: relay, --port, radice Assets. Ver…

Pubblicato
  • unity
  • mcp
  • codex
  • chatgpt
  • tutorial
  • unity-mcp
  • ai

Cosa copre questa guida

Come si collegano Codex o ChatGPT a Unity MCP? I passaggi lato Unity (importazione, attivazione, avvio del server) corrispondono a Installazione di Unity MCP e a Claude Code + Unity MCP. Questa guida riguarda solo la configurazione MCP del client: Codex Open/Copy e ChatGPT configurazione STDIO.

Due percorsi:

  1. Codex CLI — in One-click Configuration, scegli Codex CLI, poi Open (automatico) oppure Copy di uno snippet config.toml
  2. ChatGPT desktop o web — nessun Open; inserisci le impostazioni del relay copiate nel modulo MCP STDIO (comando, argomenti, directory di lavoro del progetto Unity)

Al termine dovresti avere:

  • Unity MCP Server in stato Running nell’editor, con la porta mostrata nel pannello
  • unity-mcp (o equivalente) registrato nel client con i tool visibili
  • Un prompt di sola lettura che elenca i GameObject radice nella Hierarchy della scena attiva

Prodotto: Unity MCP

Prerequisiti

VoceNote
Unity2022.3+ / Unity 6 consigliati (vedi le note di supporto attuali del fornitore)
Unity MCPImportato e attivato (guida all’installazione)
Server in esecuzioneIl pannello mostra Running; annota la porta (6589 è un default comune: usa quella del tuo pannello)
Codex CLI o ChatGPTSupporto MCP con un server STDIO personalizzato
Progetto UnityIl progetto che vuoi usare con l’agente è aperto in Unity
Rete localeIl bridge di solito ascolta su 127.0.0.1: non esporre la porta su internet pubblico

Il valore di --port deve corrispondere al pannello di Unity MCP, non a un numero fisso preso da un blog o da uno screenshot.

Parte 1: Unity (come nella guida all’installazione)

Se Unity MCP non è ancora configurato, segui Installazione di Unity MCP: Add package from disk → attiva nel pannello MCP → Start service finché non è Running → abilita i tool in Tool management.

I passaggi seguenti presuppongono che Unity sia già Running.

Parte 2: Codex CLI

  1. Pannello di Unity MCP → One-click Configuration → Codex CLI
  2. Open per scrivere la configurazione MCP, oppure Copy per il config.toml manuale
  3. Esempio solo indicativo: usa i percorsi e la porta che hai copiato (i percorsi Windows differiscono da macOS):
[mcp_servers.unity-mcp]
command = "/Users/<you>/.unitymcp/relay/<relay-id>/unity-mcp-relay"
args = ["--stdio", "--port", "<panel-port>"]
  1. Riavvia Codex CLI o ricarica MCP secondo la documentazione di Codex
  2. Verifica che unity-mcp e i suoi tool compaiano

Per il contesto completo Unity + CLI, vedi Claude Code + Unity MCP (stessi passaggi in Unity, client diverso).

Parte 3: ChatGPT desktop o web

Nel pannello di Unity MCP, usa Codex CLI → Copy per le impostazioni del relay, poi mappa i campi TOML su ChatGPT. Quando aggiungi un server puoi impostare Name e Type (STDIO). Quando aggiorni una voce Unity-mcp esistente, i campi seguenti corrispondono allo screenshot.

UI di ChatGPT (inglese)Valore
Name (in fase di aggiunta)unity-mcp (uguale al nome della sezione TOML)
Type (in fase di aggiunta)STDIO (non HTTP/SSE)
Start commandPercorso completo da command = "..." a unity-mcp-relay (usa l’output di Copy su Windows, Linux o macOS)
ParametersTre righe: --stdio → --port → porta numerica dal pannello
Environment variablesLascia vuoto
Environment variable inheritanceLascia vuoto
Working directoryRadice del progetto Unity (la cartella che contiene Assets). Evita default generici come ~/code

Riferimento UI di ChatGPT desktop

ChatGPT desktop: Plug-ins → MCP → Update Unity-mcp — comando di avvio, tre parametri (--stdio, --port, numero di porta) e directory di lavoro come nella tabella

Percorso del relay, porta e cartella del progetto nello screenshot sono solo esempi: usa l’output Copy del tuo pannello e il percorso locale della cartella che contiene Assets.

Clicca Save, poi chiudi completamente e riavvia l’app ChatGPT desktop (sul web, aggiorna e avvia una nuova sessione prima di testare MCP).

Perché la directory di lavoro è importante

Il relay comunica con ChatGPT via STDIO ma ha comunque bisogno della radice del progetto Unity dell’editor che hai aperto. Cambia questo percorso quando passi a un altro progetto.

Cosa significano le impostazioni copiate

  • unity-mcp-relay — relay locale tra il client MCP e Unity MCP Server nell’editor
  • --stdio — esegue il relay come sottoprocesso con input/output standard
  • --port — deve corrispondere alla porta del servizio Running; una porta errata o un server fermo causano errori o timeout

Verifica la connessione

Invia prima un prompt di sola lettura, ad esempio:

Elenca i GameObject radice della scena Unity attiva tramite MCP.

Se la risposta corrisponde alla Hierarchy di Unity, prova una piccola scrittura (ad esempio crea un GameObject vuoto MCP_SmokeTest, poi eliminalo). Fai commit nel controllo di versione prima di modifiche importanti.

Se il server è Running ma l’editor manca dalle istanze attive, vedi le FAQ sull’installazione di Unity MCP.

Promemoria per i client

ClientAzione tipica nel pannello
Cursorauto configure con un clic
Claude Code / Gemini CLICopy CLI command → esegui nel terminale
Codex CLIOpen o Copy → config.toml
ChatGPT desktop / webCopy delle impostazioni del relay → modulo STDIO + working directory

Panoramica: Quali client AI supporta Unity MCP

FAQ

Il Copy di Codex funziona per ChatGPT?
Sì: stesso command e stessi arguments; ChatGPT ha bisogno anche della working directory corretta.

Connessione MCP non riuscita in ChatGPT?
Controlla: Unity Running; --port corrisponde al pannello; il percorso del relay esiste ed è eseguibile; la working directory è la cartella che contiene Assets; Save e riavvio del client.

Nessun tool Unity in Codex?
Prova di nuovo Open nel pannello, oppure incolla di nuovo Copy in config.toml e riavvia Codex. Ancora bloccato → istanze attive.

Devo ancora scrivere tutto il C# a mano?
Per gli script quotidiani, l’AI può creare e allegare componenti via MCP: tu rivedi le modifiche, compili e testi in Play mode. Mantieni la supervisione umana su architettura, networking e hot path (FAQ sui client).

Prossimi passi

Altre guide che potrebbero interessarti