Guia de Instalação do Cocos Creator 2.x MCP: Instale via pacotes e conecte uma IDE de IA

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 packages do 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/game-engines/cocos2x?ch=CQZLC2FG

Fluxo sugerido:

1. Abra a página e baixe o Cocos MCP 2.x Pro com as permissões da sua conta
2. Salve o arquivo localmente e prepare-se para extraí-lo
3. 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:

1. Extraia o arquivo na sua máquina
2. Mova a pasta do plugin extraído para o diretório packages na raiz do projeto Cocos Creator
   • Se packages ainda não existir, crie-o primeiro
3. 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

1. Reinicie completamente o Cocos Creator e abra o projeto que contém o plugin
2. Menu: Extensão → MCP Server
3. Na tela de ativação, use um dos seguintes:
   • Conta VberAI + senha
   • E-mail + código de ativação
4. 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

1. Após a ativação, abra as configurações do MCP Server
2. 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)
3. Clique em Iniciar serviço
4. 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)

1. Abra o Gerenciador de ferramentas
   • Revise as ferramentas expostas pelo Cocos MCP Server
   • Ative apenas o que você quer que a IA use
2. 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
3. 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.