# Unity MCP — AI Game Developer Wiki

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.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/unity).

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](https://github.com/IvanMurzak/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](https://ai-game.dev/pt-br/docs/wiki/unity/tools-and-rql).

## Como as peças se encaixam

| Peça | O que ele faz |
| --- | --- |
| Plugin Unity MCP | Roda no Unity Editor, expõe as ferramentas de IA e se conecta a um servidor MCP. |
| Servidor MCP | O 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 IA | Claude Code, Claude Desktop, Cursor, VS Code Copilot, Codex, Gemini, Rider e outros. Ele se conecta ao mesmo servidor. |
| `unity-mcp-cli` | A 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 Dev | O 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](https://ai-game.dev/pt-br/docs/wiki/unity/configuration) 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](https://ai-game.dev/docs/app).

## Início rápido

O caminho mais fácil é o aplicativo desktop: [baixe-o](https://ai-game.dev/pt-br/download), faça login e abra seu projeto Unity. Ele instala o plugin e o conecta para você. A [wiki do app](https://ai-game.dev/pt-br/docs/wiki/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:

```bash
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](https://ai-game.dev/pt-br/docs/wiki/unity/getting-started) percorre os mesmos passos com explicações.

## Páginas desta seção

- [Instalação](https://ai-game.dev/pt-br/docs/wiki/unity/installation): todas as formas de instalar o plugin (o app, `unity-mcp-cli`, OpenUPM, o instalador `.unitypackage`) e como desinstalá-lo.
- [Primeiros passos](https://ai-game.dev/pt-br/docs/wiki/unity/getting-started): sua primeira conexão e seus primeiros prompts.
- [Conectando clientes de IA](https://ai-game.dev/pt-br/docs/wiki/unity/connecting-ai-clients): endpoints Cloud vs locais, login, URLs fixadas e o configurador de cada agente.
- [Configuração](https://ai-game.dev/pt-br/docs/wiki/unity/configuration): 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](https://ai-game.dev/pt-br/docs/wiki/unity/tools-and-rql): o que o agente pode fazer no Editor.
- [Ferramentas personalizadas](https://ai-game.dev/pt-br/docs/wiki/unity/custom-tools): transforme seus próprios métodos C# em ferramentas de IA, prompts e skills, inclusive em um jogo em execução.
- [Extensões](https://ai-game.dev/pt-br/docs/wiki/unity/extensions): pacotes opcionais para Animation, Cinemachine, Input System, Navigation, ProBuilder, Terrain, Tilemap, Timeline e mais.
- [Referência do unity-mcp-cli](https://ai-game.dev/pt-br/docs/wiki/unity/cli): todos os comandos e flags.
- [Solução de problemas](https://ai-game.dev/pt-br/docs/wiki/unity/troubleshooting): correções para problemas comuns.
- [FAQ](https://ai-game.dev/pt-br/docs/wiki/unity/faq): respostas curtas para perguntas comuns.

## Mais no site

- [Catálogo de ferramentas do Unity](https://ai-game.dev/docs/tools/unity) e a [referência de RQL](https://ai-game.dev/docs/rql).
- [Catálogo de extensões do Unity](https://ai-game.dev/docs/extensions/unity).
- [Boas práticas de Unity](https://ai-game.dev/docs/best-practices/unity) para prompts e configuração do projeto.
- [Endpoint MCP](https://ai-game.dev/pt-br/mcp-endpoint-info) com trechos de configuração para cada cliente suportado.
- [Autenticação](https://ai-game.dev/docs/auth), o [início rápido](https://ai-game.dev/pt-br/docs/quickstart) e a [página da engine Unity](https://ai-game.dev/pt-br/engines/unity).
- As outras engines: [Unreal MCP](https://ai-game.dev/pt-br/docs/wiki/unreal) e [Godot MCP](https://ai-game.dev/pt-br/docs/wiki/godot).

- [**Instalação** Instale o Unity MCP (AI Game Developer) em um projeto Unity com o app desktop, unity-mcp-cli, OpenUPM ou o instalador .unitypackage.](https://ai-game.dev/pt-br/docs/wiki/unity/installation)
- [**Primeiros passos** Conecte seu primeiro agente de IA ao Unity Editor com o Unity MCP, verifique a conexão e teste seus primeiros prompts no Claude Code, Cursor ou Copilot.](https://ai-game.dev/pt-br/docs/wiki/unity/getting-started)
- [**Conectando clientes de IA** Conecte Claude Code, Cursor, Copilot, Codex, Gemini e outros clientes MCP ao Unity MCP via endpoint de nuvem do ai-game.dev ou servidor local.](https://ai-game.dev/pt-br/docs/wiki/unity/connecting-ai-clients)
- [**Configuração** Configure o Unity MCP na janela do AI Game Developer: modos Cloud e Custom, servidor local, porta, transporte, autorização, ferramentas e CI.](https://ai-game.dev/pt-br/docs/wiki/unity/configuration)
- [**Ferramentas e RQL** O que um agente de IA pode fazer no Unity Editor com Unity MCP: consultas e mutações RQL, capturas de tela, scripts C#, testes, pacotes e profiling.](https://ai-game.dev/pt-br/docs/wiki/unity/tools-and-rql)
- [**Ferramentas personalizadas** Crie ferramentas, prompts, recursos e skills do Unity MCP em C# com os atributos AiTool, rode na thread principal e use em um jogo compilado.](https://ai-game.dev/pt-br/docs/wiki/unity/custom-tools)
- [**Extensões** Extensões do Unity MCP adicionam IA a Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline e partículas.](https://ai-game.dev/pt-br/docs/wiki/unity/extensions)
- [**Referência do unity-mcp-cli** Referência do unity-mcp-cli: instale o MCP, faça login, configure agentes de IA, abra o Unity headless e execute ferramentas e C# pelo terminal.](https://ai-game.dev/pt-br/docs/wiki/unity/cli)
- [**Solução de problemas** Resolva problemas comuns do Unity MCP: ferramentas ausentes no cliente de IA, erros de login e conexão, falhas de download e conflitos de porta.](https://ai-game.dev/pt-br/docs/wiki/unity/troubleshooting)
- [**FAQ** Respostas para perguntas comuns sobre o Unity MCP: versões compatíveis do Unity, modo Cloud vs local, custo, privacidade, builds, CI e RQL.](https://ai-game.dev/pt-br/docs/wiki/unity/faq)

---

Source (HTML): https://ai-game.dev/pt-br/docs/wiki/unity

Machine-translated (pt-BR) from the English page: https://ai-game.dev/docs/wiki/unity