← Voltar ao blog

Unity MCP: clientes IA (Cursor, Claude)

Quais ferramentas IA funcionam com Unity MCP: um servidor unity-mcp local para Cursor, Claude Code, Codex, Windsurf e Gemini CLI—mesmo setup Unity, smoke tests…

Publicado · Updated
  • unity
  • unity-mcp
  • mcp
  • cursor
  • claude-code
  • codex
  • vberai

Quais clientes de IA o Unity MCP suporta? Muitos acham que cada assistente precisa de um plugin Unity próprio. Na prática o Unity roda um MCP Server local (geralmente unity-mcp no painel). Cursor, Claude Code, Codex, Windsurf, Cline e Gemini CLI—qualquer cliente Model Context Protocol—conecta na mesma ponte. O que muda é a config MCP do cliente, não pacotes duplicados no Unity.

Confira portas e rótulos no seu build VberAI Unity MCP. Download: Unity MCP

Lado Unity: três passos para todo cliente

  1. Package Manager → Add package from disk (instalar Unity MCP)
  2. Ative no Mcp Panel; Unity MCP Server em Running (porta padrão geralmente 6589)
  3. Quick setup no painel para seu cliente, ou cole endpoint / stdio na lista MCP do cliente

Sem Running, toda IA só vê .cs no disco, não Hierarchy / Console / seleção.

Smoke test compartilhado

  1. Somente leitura: listar GameObjects raiz da cena ativa
  2. Escrita pequena: criar vazio MCP_SmokeTest, depois apagar
  3. Commit antes de edits grandes do agente; Play mode e erros de compile ficam com você

Comparação de clientes

Cliente IAConexão típicaAprofundar
CursorUm clique no painel → unity-mcp no MCP do Cursor (Reload se preciso)Fluxo Cursor + Unity MCP
Claude CodeQuick setup → Copy CLI commandClaude Code + Unity MCP
CodexApós Running, adicione unity-mcp no MCP do Codex (igual ao painel)FAQ abaixo; active instances
Windsurf / Cline / ContinueEntrada MCP + Reload, padrão CursorGuia de fluxo
Gemini CLIQuick setup → Gemini CLI → copiar comandoFluxo CLI em guia Claude

Melhor IA para Unity MCP? MCP não está preso a um LLM—use o cliente que o repo já usa. Running estável + tools visíveis importa mais que trocar modelo.

Três passos mínimos por cliente (após Running)

Cursor

  1. Quick setup → Cursor → toast de sucesso
  2. Cursor Settings → MCP → unity-mcp + tools
  3. Lista de nós raiz somente leitura

Claude Code

  1. Quick setup → Copy CLI command
  2. Executar no ambiente CLI do Claude
  3. Lista de nós raiz somente leitura

Codex

  1. Copiar URL ou stdio do painel
  2. Colar na config MCP do Codex
  3. Reiniciar Codex; tools vazios → active instances

Escopo

DentroFora
Hierarchy, componentes, scripts, Console (conforme tools)Builds, netcode, tuning de performance
Trocar clientes no mesmo servidorUm plugin Unity por marca de IA
Fiar UI após import StudioFigma → Prefab sem AI Studio

Decisão Godot: Precisa de Godot MCP?

Próximos passos

  1. Não instalado → instalar Unity MCP
  2. Running → Quick setup + smoke test para seu cliente
  3. Vídeo → guia do plugin Unity MCP

FAQ

Qual IA funciona com Unity MCP?
Qualquer cliente MCP que alcance unity-mcp local—comum Cursor, Claude Code, Codex, Windsurf, Cline, Gemini CLI. Veja tabela comparativa.

Dois plugins Unity para Cursor e Claude?
Não. Um servidor no Unity; registre MCP em cada cliente.

Codex não vê tools Unity?
Cheque Running, config igual ao painel, reinício; depois active instances.

Preciso escrever todo C# à mão?
Para scripts de gameplay do dia a dia, em geral não: a IA pode criar e editar C# via Unity MCP, anexar scripts a GameObjects e ajustar Inspector (dentro dos tools do plugin). Você foca em revisão de diff, erros de compile e checagens em Play mode. Arquitetura, netcode e hot paths ainda merecem julgamento humano explícito—não porque MCP não escreve código, mas porque essas áreas exigem responsabilidade clara.

Mais guias que podem interessar