Guia de Instalação do Cocos Creator 2.x MCP: Instale via pacotes e conecte uma IDE de IA
Instale o VberAI Cocos Creator 2.x MCP Pro passo a passo—descompacte na pasta packages do projeto, reinicie e ative, inicie o servidor MCP local e verifique a …
- cocos
- cocos-creator
- mcp
- cursor
- tutorial
- cocos-mcp
- ai
O que este guia cobre
Siga estes cinco passos para conectar o Cocos Creator 2.x MCP (VberAI Pro) a um projeto local do Creator 2.x para que o Cursor (ou outra IDE de IA compatível com MCP—mesma ideia) possa operar, visualizar e depurar o editor—não apenas editar scripts no disco.
Ao final, você deverá ser capaz de:
- Descompactar o plugin na pasta
packagesdo projeto - Reiniciar o Creator e ativar com uma conta VberAI ou e-mail + código de ativação
- Iniciar o Cocos MCP Server local
- Usar Configuração rápida → Configuração automática para registrar o servidor no Cursor e confirmar a conexão
Página do produto: VberAI Cocos MCP 2.x
Este artigo usa o Cursor como exemplo. Claude Code, Windsurf, Cline e outros clientes MCP seguem um fluxo semelhante.
Pré-requisitos
| Item | Observações |
|---|---|
| Cocos Creator | 2.4.x+ / outros projetos 2.x (não misture com o pacote 3.x) |
| Pacote do plugin | Arquivo Cocos Creator 2.x MCP Pro do site oficial |
| Ativação | Conta VberAI + senha, ou e-mail + código de ativação |
| IDE de IA | Cursor recomendado; outros clientes MCP também funcionam |
| Rede local | A ponte MCP geralmente roda em 127.0.0.1—não exponha a porta publicamente |
Passo 1: Baixe o Cocos Creator 2.x MCP
Baixe a versão Pro do site da VberAI:
Página de download: [https://www.vberai.com/pt/game-engines/cocos2x?ch=CQZLC2FG)
Fluxo sugerido:
- Abra a página e baixe o Cocos MCP 2.x Pro com as permissões da sua conta
- Salve o arquivo localmente e prepare-se para extraí-lo
- Confirme que o projeto é Creator 2.x—não misture com o pacote 3.x MCP
As diferenças entre OSS e Pro e a cobrança seguem o texto atual do site.
Passo 2: Instale o Plugin (em packages)
Ao contrário do 3.x (Gerenciador de Extensões → Importar Extensão), o 2.x instala colocando arquivos no projeto:
- Extraia o arquivo na sua máquina
- Mova a pasta do plugin extraído para o diretório
packagesna raiz do projeto Cocos Creator- Se
packagesainda não existir, crie-o primeiro
- Se
- Confirme que o layout é
packages/<nome-do-plugin>/e não aninhado em um nível extra de descompactação
Não configure ainda: reinicie o Creator para que a extensão carregue corretamente (próximo passo).
Passo 3: Ative o cocos-mcp-server
- Reinicie completamente o Cocos Creator e abra o projeto que contém o plugin
- Menu: Extensão → MCP Server
- Na tela de ativação, use um dos seguintes:
- Conta VberAI + senha
- E-mail + código de ativação
- Após a ativação ser bem-sucedida, abra a página de configurações do MCP Server (próximo passo)
Sem ativação, o servidor geralmente não inicia. Confirme se seu plano ou código corresponde à versão Pro atual.

Passo 4: Inicie o cocos-mcp-server
- Após a ativação, abra as configurações do MCP Server
- Ajuste conforme necessário:
- Porta: use o padrão do painel ou sua convenção local
- Idioma: corresponda à sua preferência de interface
- Inicialização: use as opções do painel (por exemplo, iniciar automaticamente com o editor, se disponível)
- Clique em Iniciar serviço
- Quando o painel mostrar Em execução, o Cocos MCP Server está ativo
Agora você tem uma ponte MCP local. Em seguida, entregue-a à sua IDE de IA.

Passo 5: Configuração da IDE de IA com um clique (Exemplo com Cursor)
- Abra o Gerenciador de ferramentas
- Revise as ferramentas expostas pelo Cocos MCP Server
- Ative apenas o que você quer que a IA use
- Abra a Configuração rápida
- Escolha sua IDE (por exemplo, Cursor)
- Clique em Configuração automática
- Confirme que a interface mostra um estado configurado
- Abra o Cursor
- Na lista de MCP / ferramentas, você deve ver cocos-creator (ou o nome mostrado no painel) conectado
- Se estiver ausente, clique em Recarregar (ou o equivalente de recarga de MCP) no Cursor e verifique novamente
Outras IDEs seguem o mesmo caminho—basta escolher um cliente diferente na Configuração rápida.

Verificação rápida após conectar
No Cursor, comece com uma verificação somente leitura, por exemplo:
Liste os nós raiz da cena atualmente aberta no Cocos Creator.
Se a resposta corresponder à hierarquia do editor, a ponte funciona. Em seguida, tente uma pequena escrita (crie um nó temporário e exclua-o) para confirmar permissões e seleção de ferramentas.
FAQ
Os arquivos estão em packages, mas não há menu Extensão → MCP Server?
Confirme que você reiniciou completamente o Creator (não apenas recarregou a cena). Verifique se a pasta está em packages/<nome-do-plugin>/ sem um aninhamento extra de zip. Confirme se você baixou o pacote 2.x, não o 3.x.
A ativação continua falhando?
Confirme os direitos do Pro, ou se o código de ativação é válido e vinculado ao e-mail correto. Verifique o centro da conta no site e tente novamente no painel.
Cliquei em Iniciar serviço, mas nunca vejo Em execução?
Confirme se a porta está livre e se o localhost não está bloqueado. Certifique-se de que o Passo 3 foi concluído com sucesso.
O Cursor não mostra cocos-creator?
No Creator, confirme se o servidor ainda está Em execução, execute Configuração rápida → Configuração automática novamente e recarregue o MCP no Cursor. Se ainda falhar, verifique se a configuração MCP do Cursor inclui o endereço da ponte local.
Próximos passos
- Use linguagem natural para uma consulta de cena ou uma pequena edição para aprender os limites da ferramenta
- Faça commit antes de grandes mudanças; mantenha a ponte apenas no localhost
- Para UI de design para engine, combine com o VberAI Studio e depois itere no editor com MCP
Para o Creator 3.x, siga o guia de instalação do Cocos Creator 3.x MCP—não misture pacotes. Para esclarecer limites e a diferença do vago “Cocos Creator AI”, veja O que é Cocos Creator MCP. Para mais contexto sobre MCP, veja o guia em vídeo do Cocos Creator MCP.
Continuar lendo
Mais guias que podem interessar
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…
- unity
- unity-mcp
- mcp
- cursor
Crie um Plataforma 2D com Godot MCP: Movimento, Fases e Inimigos
Entregue um protótipo de plataforma Godot 4 via MCP: sensação CharacterBody2D, fases TileMap, inimigos simples; use o VberAI Studio quando precisar de HUD/títu…
- Godot MCP
- 2D platformer
- Godot 4
- GDScript
Godot MCP vs Scripts Manuais: Quando o Controle do Motor por IA Faz Sentido
Guia prático de decisão: use VberAI Godot MCP para protótipos e código repetitivo, mantenha GDScript manual para caminhos críticos—com base em práticas de cena…
- godot-mcp
- vberai
- comparison
- GDScript