Esta página foi traduzida automaticamente do inglês. Leia o original em inglês.

Unity MCP

O Unity MCP conecta Claude Code, Cursor, Copilot e outros agentes de IA ao Unity Editor. Instalação, configuração, ferramentas, extensões e CLI.

Atualizado em 4 de novembro de 2026 Ver como Markdown

O Unity MCP é o plugin de Unity do AI Game Developer. Ele coloca a IA no Unity Editor: um agente como Claude Code, Cursor, GitHub Copilot, Codex ou Gemini pode ler e alterar suas cenas, GameObjects, componentes, prefabs e assets, escrever scripts C#, executar trechos de C#, rodar seus testes EditMode e PlayMode, ler o Console e tirar capturas de tela que ele consegue ver. Esta wiki explica como instalar o plugin, conectar um cliente de IA e usá-lo no dia a dia.

O que é o Unity MCP

O Unity MCP é um pacote Unity, com.ivanmurzak.unity.mcp, exibido no Package Manager como AI Game Developer — MCP. Ele roda dentro do Unity Editor (e, se você quiser, dentro do seu jogo compilado). Ele expõe um conjunto de ferramentas por meio do Model Context Protocol (MCP), o padrão aberto que clientes de IA usam para chamar ferramentas externas. O agente com quem você conversa vê essas ferramentas e as chama para fazer o trabalho que você pedir.

O plugin é open source sob a licença Apache-2.0 e fica no repositório Unity-MCP. Ele compartilha suas bibliotecas de MCP e de reflexão com o Unreal MCP e o Godot MCP, então os três plugins de engine funcionam da mesma forma e usam a mesma conta ai-game.dev.

Desde a versão 1.0.0, a maior parte do trabalho no Editor passa pelo RQL, uma linguagem de consulta sobre os dados do Editor: uma ferramenta rql-query lê, uma ferramenta rql-mutate altera e rql-schema descreve o que está disponível. Um pequeno conjunto de ferramentas específicas cobre capturas de tela, scripts, testes e pacotes. Veja Ferramentas e RQL.

Como as peças se encaixam

PeçaO que ele faz
Plugin Unity MCPRoda no Unity Editor, expõe as ferramentas de IA e se conecta a um servidor MCP.
Servidor MCPO servidor hospedado em ai-game.dev (modo Cloud, o padrão) ou um gamedev-mcp-server local que o plugin baixa e inicia para você (modo Custom).
Cliente de IAClaude Code, Claude Desktop, Cursor, VS Code Copilot, Codex, Gemini, Rider e outros. Ele se conecta ao mesmo servidor.
unity-mcp-cliA ferramenta de linha de comando npm que instala o plugin, faz seu login, grava as configurações dos clientes de IA, abre o Unity e chama ferramentas a partir de um terminal.
App AI Game DevO aplicativo desktop que instala o plugin, abre o Editor e executa o agente de IA para você.

No modo Cloud, o Editor e seu cliente de IA se conectam a https://ai-game.dev/mcp, e você faz login uma vez com sua conta ai-game.dev. No modo Custom, o plugin executa um servidor MCP local na sua máquina, então tudo fica no seu computador. Configuração explica os dois.

Requisitos em resumo

  • Unity 2022.3 ou mais recente, incluindo o Unity 6.
  • Um caminho de projeto sem espaços (o plugin registra um erro na inicialização se o caminho contiver um).
  • Acesso à internet no primeiro uso: o plugin baixa suas dependências .NET do NuGet e, no modo Custom, o binário do seu servidor MCP.
  • Um cliente de IA que fale MCP, ou o app AI Game Dev.

Início rápido

O caminho mais fácil é o aplicativo desktop: baixe-o, faça login e abra seu projeto Unity. Ele instala o plugin e o conecta para você. A wiki do app cobre esse fluxo.

Se você prefere um terminal e seu próprio cliente de IA, estes comandos levam um projeto Unity até um agente conectado:

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject
unity-mcp-cli login
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
unity-mcp-cli open ./MyUnityProject

Depois, peça ao seu agente algo como "Crie 3 cubos em um círculo com raio 2". Primeiros passos percorre os mesmos passos com explicações.

Páginas desta seção

  • Instalação: todas as formas de instalar o plugin (o app, unity-mcp-cli, OpenUPM, o instalador .unitypackage) e como desinstalá-lo.
  • Primeiros passos: sua primeira conexão e seus primeiros prompts.
  • Conectando clientes de IA: endpoints Cloud vs locais, login, URLs fixadas e o configurador de cada agente.
  • Configuração: a janela do AI Game Developer, modos de conexão, portas, o arquivo de configuração, substituições por variáveis de ambiente e builds.
  • Ferramentas e RQL: o que o agente pode fazer no Editor.
  • Ferramentas personalizadas: transforme seus próprios métodos C# em ferramentas de IA, prompts e skills, inclusive em um jogo em execução.
  • Extensões: pacotes opcionais para Animation, Cinemachine, Input System, Navigation, ProBuilder, Terrain, Tilemap, Timeline e mais.
  • Referência do unity-mcp-cli: todos os comandos e flags.
  • Solução de problemas: correções para problemas comuns.
  • FAQ: respostas curtas para perguntas comuns.

Mais no site