← Voltar ao blog

Conecte o Codex ou o ChatGPT ao Unity MCP

Conecte o Codex ou o ChatGPT ao Unity MCP: etapas no Unity iguais ao guia de instalação. Codex Abrir/Copiar. ChatGPT STDIO: relay, --port, raiz Assets. Verifiq…

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

O que este guia cobre

Como você conecta o Codex ou o ChatGPT ao Unity MCP? As etapas no lado do Unity (importar, ativar, iniciar o servidor) são as mesmas de instalação do Unity MCP e Claude Code + Unity MCP. Este guia trata apenas da configuração do cliente MCP — Codex Abrir/Copiar e configuração STDIO do ChatGPT.

Dois caminhos:

  1. Codex CLI — em Configuração com um clique, escolha Codex CLI, depois Abrir (automático) ou Copiar um trecho de config.toml
  2. ChatGPT desktop ou web — sem Abrir; mapeie as configurações de relay copiadas no formulário MCP STDIO (comando, argumentos, diretório de trabalho do projeto Unity)

Ao terminar, você deve ter:

  • Unity MCP Server Em execução no editor, com a porta exibida no painel
  • unity-mcp (ou equivalente) registrado no cliente com as ferramentas visíveis
  • Um prompt somente leitura que lista os GameObjects raiz na Hierarchy da cena ativa

Produto: Unity MCP

Pré-requisitos

ItemObservações
Unity2022.3+ / Unity 6 recomendado (consulte as notas de suporte atuais do fornecedor)
Unity MCPImportado e ativado (guia de instalação)
Servidor em execuçãoO painel mostra Em execução; anote a porta (6589 é um padrão comum — use a do seu painel)
Codex CLI ou ChatGPTSuporte a MCP com um servidor STDIO personalizado
Projeto UnityO projeto que você quer que o agente use está aberto no Unity
Rede localO bridge normalmente escuta em 127.0.0.1 — não exponha a porta na internet pública

O valor de --port deve corresponder ao painel do Unity MCP, não a um número fixo de um blog ou captura de tela.

Parte 1: Unity (igual ao guia de instalação)

Se o Unity MCP ainda não estiver configurado, siga instalação do Unity MCP: Adicionar pacote do disco → ativar no painel MCP → Iniciar serviço até Em execução → habilitar ferramentas em Gerenciamento de ferramentas.

As etapas abaixo pressupõem que o Unity já está Em execução.

Parte 2: Codex CLI

  1. Painel do Unity MCP → Configuração com um clique → Codex CLI
  2. Abrir para gravar a configuração MCP, ou Copiar para config.toml manual
  3. Apenas exemplo de formato — use seus caminhos e porta copiados (caminhos do Windows diferem do macOS):
[mcp_servers.unity-mcp]
command = "/Users/<you>/.unitymcp/relay/<relay-id>/unity-mcp-relay"
args = ["--stdio", "--port", "<panel-port>"]
  1. Reinicie o Codex CLI ou recarregue o MCP conforme a documentação do Codex
  2. Confirme que unity-mcp e suas ferramentas aparecem

Para contexto completo de Unity + CLI, veja Claude Code + Unity MCP (mesmas etapas no Unity, cliente diferente).

Parte 3: ChatGPT desktop ou web

No painel do Unity MCP, use Codex CLI → Copiar para obter as configurações de relay e depois mapeie os campos TOML para o ChatGPT. Ao adicionar um servidor, você pode definir Nome e Tipo (STDIO). Ao atualizar uma entrada Unity-mcp existente, os campos abaixo correspondem à captura de tela.

Interface do ChatGPT (inglês)Valor
Name (ao adicionar)unity-mcp (igual ao nome da seção TOML)
Type (ao adicionar)STDIO (não HTTP/SSE)
Start commandCaminho completo de command = "..." até unity-mcp-relay (use a saída de Copiar no Windows, Linux ou macOS)
ParametersTrês linhas: --stdio → --port → porta numérica do painel
Environment variablesDeixe vazio
Environment variable inheritanceDeixe vazio
Working directoryRaiz do projeto Unity (pasta que contém Assets). Evite padrões genéricos como ~/code

Referência da interface do ChatGPT desktop

ChatGPT desktop: Plug-ins → MCP → Update Unity-mcp — start command, três parâmetros (--stdio, --port, número da porta) e diretório de trabalho conforme a tabela

Caminho do relay, porta e pasta do projeto na captura de tela são apenas exemplos — use a saída de Copiar do seu painel e o caminho local pai de Assets.

Clique em Salvar e depois encerre completamente e reinicie o app ChatGPT desktop (na web, atualize e inicie uma nova sessão antes de testar o MCP).

Por que o diretório de trabalho importa

O relay se comunica com o ChatGPT via STDIO, mas ainda precisa da raiz do projeto Unity do editor que você tem aberto. Altere esse caminho quando trocar de projeto.

O que significam as configurações copiadas

  • unity-mcp-relay — relay local entre o cliente MCP e o Unity MCP Server no editor
  • --stdio — executa o relay como subprocesso com entrada/saída padrão
  • --port — deve corresponder à porta do serviço Em execução; porta errada ou servidor parado causa falhas ou timeouts

Verifique a conexão

Envie primeiro um prompt somente leitura, por exemplo:

Liste os GameObjects raiz da cena Unity ativa via MCP.

Se a resposta corresponder à Hierarchy do Unity, tente uma pequena escrita (por exemplo, criar um GameObject vazio MCP_SmokeTest e depois excluí-lo). Faça commit no controle de versão antes de grandes alterações.

Se o servidor estiver Em execução mas o editor não aparecer nas instâncias ativas, consulte o FAQ de instalação do Unity MCP.

Guia rápido de clientes

ClienteAção típica no painel
CursorConfiguração automática com um clique
Claude Code / Gemini CLICopiar comando CLI → executar no terminal
Codex CLIAbrir ou Copiar → config.toml
ChatGPT desktop / webCopiar configurações de relay → formulário STDIO + diretório de trabalho

Visão geral: Quais clientes de IA o Unity MCP suporta

Perguntas frequentes

O Copiar do Codex funciona para o ChatGPT?
Sim — o mesmo comando e argumentos; o ChatGPT também precisa do diretório de trabalho correto.

Falha na conexão MCP no ChatGPT?
Verifique: Unity Em execução; --port corresponde ao painel; o caminho do relay existe e é executável; o diretório de trabalho é o pai de Assets; Salve e reinicie o cliente.

Sem ferramentas do Unity no Codex?
Tente Abrir novamente no painel, ou cole de novo o Copiar em config.toml e reinicie o Codex. Ainda travado → instâncias ativas.

Ainda preciso escrever todo o C# manualmente?
Para scripts do dia a dia, a IA pode criar e anexar componentes via MCP — você revisa as alterações, compila e testa no modo Play. Mantenha a responsabilidade humana sobre arquitetura, rede e caminhos críticos (FAQ de clientes).

Próximos passos

Mais guias que podem interessar