Um servidor MCP para Unity permite que o Claude Code leia o Console, edite scripts em C# e monte cenas dentro do Editor. Veja os comandos de configuração da CLI do Unity, do MCP for Unity e do Coplay, os preços reais dos planos do Claude e dos tokens da API, e as rotas gratuitas que funcionam.
Digitar "adicione um ponto de spawn e corrija a null reference no meu script de inventário" em um terminal e ver o Unity Editor fazer isso sozinho parece truque de demonstração. Não é. Um servidor MCP para Unity dá ao Claude Code mãos dentro do Editor: ele consegue ler o Console, criar GameObjects, editar scripts em C# e rodar testes sem que você precise copiar e colar nada de um lado para o outro. O que a maioria dos tutoriais deixa de lado é que o cenário mudou. O Unity descontinuou o servidor MCP do próprio pacote AI Assistant, os servidores gratuitos da comunidade continuaram crescendo, e a conta real depende muito menos do servidor do que do modelo ao qual você se conecta.
Esta página percorre a configuração de cada rota, o custo real em dólares e em tokens, e as opções gratuitas que se sustentam no uso diário. Comandos, versões e preços foram conferidos em outubro de 2026 na documentação do Unity, nos repositórios dos projetos e na página de preços do Claude.
💡 Resposta curta: todo servidor MCP para Unity listado aqui é gratuito. O Claude Code não é, porque exige um plano pago do Claude ou crédito na API. A configuração mais barata e sólida é um servidor gratuito da comunidade somado ao plano do Claude que você talvez já tenha.
Quatro nomes aparecem em quase todas as buscas. Um é oficial e agora descontinuado. Os outros três são de código aberto e não foram afetados por esse aviso. Escolher entre eles depende da sua versão do Unity, de preferir Python ou Node na máquina e de quanto você quer acompanhar o roadmap próprio do Unity.
O Unity traz um servidor MCP dentro do pacote com.unity.ai.assistant. Ele exige Unity 6 (6000.0) ou posterior e fica em Edit > Project Settings > AI > Unity MCP. A documentação atual abre com uma frase direta: "Unity MCP server is deprecated. Use the Unity command-line interface (CLI) instead."
Leia o escopo com atenção, porque ele é mais restrito do que parece:
| Sua configuração | Afetada pela descontinuação? |
|---|---|
| Pacote AI Assistant no Editor com o servidor MCP ativado | Sim |
| Um pacote MCP de terceiros instalado a partir do GitHub | Não |
unity mcp ou unity command pela CLI do Unity | Não |
A CLI do Unity traz o próprio servidor MCP, construído sobre o pacote Unity Pipeline, e ele fala o mesmo protocolo, então seu cliente se conecta do mesmo jeito que se conecta hoje. O Unity afirma que esse modo MCP não faz parte da descontinuação e que "remains fully supported".
| Servidor | Licença | Versões do Unity | Requisitos | Conexão |
|---|---|---|---|---|
| MCP for Unity (CoplayDev) | MIT | 2021.3 LTS até 6.x | Python 3.10+ com uv | Configurado pelo menu do Editor |
| Unity-MCP, "AI Game Developer" (IvanMurzak) | Apache-2.0 | Não informado no README | Binário do servidor pré-compilado | stdio, porta padrão 8080 |
| mcp-unity (CoderGamester) | MIT | Unity 6+ | Node.js 18+, npm 9+ | WebSocket, porta padrão 8090 |
O MCP for Unity expõe 48 pontos de entrada de ferramentas para cenas, GameObjects, scripts em C#, assets, testes, profiling e builds. Ele também funciona com Claude Desktop, VS Code, Cursor, Windsurf, Cline e Gemini CLI, então uma única instalação atende o cliente que você testar depois. O Unity-MCP anuncia mais de 70 ferramentas integradas em projeto e assets, cena e hierarquia, scripting e editor, e profiling. O mcp-unity acrescenta operações em lote com rollback, útil quando um agente mexe em muitos objetos de uma vez.
Uma regra prática: no Unity 2021 ou 2022, escolha o MCP for Unity. No Unity 6 com o Node já instalado, o mcp-unity é a opção mais simples. Se você quer o maior número de ferramentas logo de início, dê uma olhada no Unity-MCP.
Se ainda não instalou o Claude Code, instale primeiro: npm install -g @anthropic-ai/claude-code, depois execute claude --version para confirmar que ele responde.
É para cá que o Unity agora encaminha todo mundo, e não custa nada. O Unity afirma que a CLI "is free and separate from Unity AI" e não exige assinatura do Unity AI. Para controlar um Editor em execução, o projeto precisa usar Unity 6.0 LTS ou posterior.
unity pipeline install para adicionar o pacote Unity Pipeline.unity mcp configure claude para gravar a configuração do Claude Code.unity mcp configure --list para ver todos os clientes suportados e o status de cada um.unity skill install <agent-name> para adicionar as skills do Unity ao seu agente.O servidor local do pipeline aceita conexões apenas em localhost, e a CLI controla um Editor local sem precisar de internet.
💡 O Claude Code pode executar comandos de shell, então talvez você nem precise do MCP.
unity commandeunity evalcontrolam o Editor diretamente e, segundo o Unity, são mais rápidos e usam menos tokens que o MCP. Mantenha o modo MCP para ambientes que não conseguem executar comandos de shell.
Ainda usa o servidor antigo do Editor? Abra Edit > Project Settings > AI > Unity MCP, confirme que o Unity Bridge mostra Running, expanda Integrations, selecione Claude Code e pressione Configure. Para uma entrada manual, aponte o Claude Code para o binário do relay com o argumento --mcp: %USERPROFILE%\.unity\relay\relay_win.exe no Windows. A primeira conexão mostra um pedido pendente no Unity, e você pressiona Accept uma vez. A própria página do Unity também lista uma assinatura ou teste ativo das ferramentas de IA da empresa como pré-requisito para esse servidor.
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main. A alternativa pelo OpenUPM é openupm add com.coplaydev.unity-mcp.uv.claude mcp list para confirmar a conexão.O Coplay publica um tutorial separado para o Claude Code. Ele pede Unity 2022 ou posterior, Node.js com npm e Python 3.11 ou mais recente. Adicione o pacote do Unity a partir de https://github.com/CoplayDev/unity-plugin.git#beta e depois registre o servidor em uma linha:
claude mcp add --scope user --transport stdio coplay-mcp --env MCP_TOOL_TIMEOUT=720000 -- uvx --python ">=3.11" coplay-mcp-server@latest
O valor MCP_TOOL_TIMEOUT=720000 dá doze minutos a cada chamada de ferramenta, o que importa em builds longos e execuções de teste. Esse tutorial não traz preços, então confira o site do Coplay antes de depender dele em uma equipe.
O Unity-MCP se registra com um único comando, em que o binário fica dentro da pasta Library do seu projeto:
claude mcp add ai-game-developer "<unityProjectPath>/Library/mcp-server/win-x64/gamedev-mcp-server.exe" port=<port> client-transport=stdio
O mcp-unity instala a partir de https://github.com/CoderGamester/mcp-unity.git, inicia em Tools > MCP Unity > Server Window e lê um arquivo .mcp.json na raiz do projeto:
{
"mcpServers": {
"mcp-unity": {
"command": "node",
"args": ["Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"]
}
}
}
Substitua <hash> pelo nome real da pasta no seu cache de pacotes.
Execute claude mcp list. Uma entrada saudável tem a aparência de coplay-mcp: ✓ Connected. Depois teste a cadeia inteira com o prompt que o próprio Unity sugere: "Read the Unity console messages and summarize any warnings or errors." Se o Claude devolver o conteúdo real do seu Console, a ponte funciona.
O servidor é a parte barata. O modelo por trás dele é que manda a conta.
O MCP for Unity e o mcp-unity usam a licença MIT. O Unity-MCP usa a Apache-2.0. A CLI do Unity também é gratuita, e instalá-la não exige assinatura do Unity AI. Nenhuma delas cobra por chamada, por assento ou por cena.
O Claude Code está incluído em todos os planos pagos do Claude e compartilha os limites de uso desse plano, o que deixa de fora o plano Free.
| Opção | Preço | Indicado para |
|---|---|---|
| Claude Pro | US$ 20/mês, US$ 17 no plano anual | Desenvolvedores solo, sessões regulares |
| Claude Max | A partir de US$ 100/mês (5x ou 20x de uso) | Uso intenso diário |
| Team, assento Standard | US$ 25/mês, US$ 20 no plano anual | Pequenos estúdios |
| API, Sonnet 5.5 | US$ 2 de entrada, US$ 10 de saída por milhão de tokens | Uso ocasional ou por script |
| API, Haiku 4.5 | US$ 1 de entrada, US$ 5 de saída por milhão de tokens | Edições rotineiras e baratas |
A conta da API é fácil de checar. Uma sessão que lê 400.000 tokens de entrada e escreve 40.000 tokens de saída no Sonnet 5.5 custa US$ 0,80 mais US$ 0,40, ou seja, US$ 1,20. As hierarquias de cena e os despejos do Console são o que infla o lado da entrada, então peça leituras restritas, como uma cena ou um script por vez.
O produto de IA do próprio Unity é uma compra à parte. Usuários individuais ganham um teste de 14 dias com 1.000 créditos e depois pagam US$ 10 por mês, a menos que cancelem. Assentos Pro, Enterprise e Industry incluem uma cota mensal de créditos que não acumula. O gateway de IA do Unity permite que o Claude Code se conecte com a sua assinatura Anthropic existente, sem gastar Créditos do Unity AI, então um plano do Claude mais a CLI evita pagar duas vezes.
"Grátis" precisa de uma definição aqui. Os servidores são gratuitos. O modelo é a parte que você paga, a menos que você já pague por ele.
Como o MCP for Unity funciona com Claude Desktop, VS Code, Cursor, Windsurf, Cline e Gemini CLI, você pode conectá-lo ao assistente que já paga. A camada MCP custa US$ 0. Se você tem um plano Claude Pro, o Claude Code já está incluído nele, e o conjunto inteiro de ferramentas custa os US$ 20 que você já gastava.
Alguns clientes MCP conseguem direcionar as requisições para um modelo de pesos abertos hospedado por você. Trate isso como um projeto de fim de semana, não como uma configuração pronta para uso: a chamada de ferramentas é onde os modelos locais pequenos costumam tropeçar, e o próprio Unity observa que alguns modelos não montam linhas de comando de forma confiável. Teste com o prompt de resumo do Console acima antes de confiar um deles em uma cena.
A CLI do Unity também funciona sem agente nenhum. Ela instala e gerencia versões do Editor, gerencia projetos, executa builds sem interface e roda suítes de teste, o que a torna, por si só, uma ferramenta gratuita de integração contínua.
Para a parte de raciocínio, como rascunhar um script em C# ou interpretar um texto de erro, modelos de chat hospedados na PicassoIA como GPT OSS 20B ou Granite 8B Code Instruct 128K podem substituir. Eles nunca tocam no seu Editor, então você copia o código manualmente.
A maioria das falhas vem de uma incompatibilidade de versão ou de um caminho, não do Claude. Percorra esta lista na ordem.
| Sintoma | Causa provável | Correção |
|---|---|---|
claude mcp list não mostra ✓ Connected | Runtime ausente ou caminho de comando errado | Verifique Python 3.10+ (3.11+ para o Coplay), Node 18+ e se uv ou uvx está no seu PATH |
| O Unity Bridge não está Running | A ponte oficial do Editor parou | Pressione Start em Project Settings > AI > Unity MCP |
| O Claude conecta, mas as ferramentas não fazem nada | A primeira conexão ainda está pendente | Pressione Accept nas configurações do MCP |
| Builds longos falham no meio | Timeout padrão da ferramenta curto demais | Defina MCP_TOOL_TIMEOUT=720000 como no comando do Coplay |
| O mcp-unity quebra depois de uma atualização de pacote | O caminho .mcp.json inclui um hash de cache | Confira de novo o nome da pasta em Library/PackageCache |
| O servidor oficial não inicia | O projeto está no Unity 2021 ou 2022 | Use o MCP for Unity (2021.3+) ou o Coplay (2022+) |
| Dois servidores brigam por uma porta | Ambos estão na mesma porta, como 8080 | Mude a porta de um e reinicie esse servidor. No mcp-unity, use a Server Window |
💡 Mude uma coisa de cada vez e rode de novo o prompt de resumo do Console depois de cada mudança. Chutar entre três configurações ao mesmo tempo é o que transforma um conserto de dez minutos em uma noite inteira.
Um servidor MCP movimenta objetos pelo Editor. Ele não pinta suas texturas nem esculpe seus props, então esses assets vêm de outro lugar.
Os modelos de imagem preenchem a lacuna entre "preciso de uma parede de pedra coberta de musgo" e um arquivo na sua pasta Assets. Gere imagens de referência ou candidatos de textura plana com Seedream 4.5, Qwen Image 3 ou GPT Image 2, corrija falhas com o PicassoIA Image Editor Pro, depois importe os arquivos e peça ao Claude, via MCP, que crie um material e o atribua aos objetos certos.
Verifique as emendas antes de repetir qualquer textura em mosaico. Uma única imagem gerada não tem garantia de se repetir sem costuras, então teste o material em uma superfície grande antes.
O catálogo da PicassoIA é voltado a modelos de imagem, vídeo, áudio e linguagem, e uma busca na categoria 3D não retornou modelos no momento em que escrevemos, então ele não vai entregar uma malha pronta. O que ele pode fazer são as referências de que um artista 3D ou uma ferramenta de malha precisa, como vistas frontal, lateral e de três quartos de um prop. Enquanto isso, o Claude pode esboçar um nível com formas básicas via MCP, e você troca pelas malhas reais conforme elas chegarem.
O Claude Sonnet 5 não vai controlar o seu Editor, mas é uma forma rápida de rascunhar e depurar C# antes de um script chegar ao Unity.
low, que pula o pensamento estendido para obter a resposta mais rápida e barata. Use high quando um bug atravessar vários scripts, e max para os casos mais difíceis.💡 A entrada de imagem reduz as fotos para 0,5 megapixel por padrão. Se o texto do Console parecer borrado na resposta, recorte a captura de tela só nas linhas do erro em vez de enviar a janela inteira.
Prefere outro modelo? Claude Opus 4.7, Claude 4.5 Haiku e Claude Fable 5 estão todos na mesma coleção de modelos de linguagem.
Agora você tem um caminho funcional, de uma frase no terminal até uma cena alterada, e uma visão clara do que cada parte custa. A metade que falta é a arte que preenche a cena.
Abra a Picasso IA e teste no seu próprio projeto. Comece com um prop que você vive adiando, escreva um prompt curto para ele no Seedream 4.5, compare com o mesmo prompt no Qwen Image 3 e fique com o que se encaixa na sua cena. Depois deixe seu servidor MCP para Unity posicioná-lo. Veja a lista completa em picassoia.com/en/all-models e faça alguns experimentos antes do seu próximo build.
Escolha seu idioma
