Cursor Quebrado Após Cocos Creator MCP: Corrija a Conexão por Sintoma

Primeiro: O Cursor Está Quebrado ou a Ponte?

O que você sente	Causa mais provável
O Cursor ainda escreve código normal, mas não consegue alcançar cenas/nós do Cocos	MCP não conectado ou ferramentas não habilitadas
A lista MCP não tem cocos-creator (ou o nome do Quick configure)	Config não escrita, ou Reload necessário
O nome do serviço existe, mas mostra erro / desconectado	Creator não está em execução, URL/porta errada, ou reload necessário
Mostra conectado, mas não consegue listar nós da cena aberta	Projeto errado, ferramentas desmarcadas, ou verificação de somente leitura ruim

Claude Code, Codex e clientes MCP similares seguem a mesma ideia: confirme que o cliente tem uma entrada de serviço saudável e depois verifique o Creator.

Passo 1: Olhe Apenas para o MCP Dentro do Cursor

Abra as configurações de MCP / ferramentas do Cursor (os rótulos do menu podem variar por versão) e verifique:

1. Se cocos-creator aparece (ou o nome escrito pelo Quick configure do Creator)
2. Se o status está conectado / utilizável — não travado em erro, desconectado ou em branco
3. Se você acabou de alterar a configuração ou executou o Auto configure no Creator: faça um Reload Window (ou reload MCP equivalente) e depois verifique a lista novamente

Um caso comum: o Creator já mostra Running, mas o Cursor ainda mantém uma configuração obsoleta — sem reload, parece “quebrado de repente”.

Passo 2: Confirme que a URL Aponta para o Creator Local

A entrada MCP do Cursor deve apontar para uma URL de ponte local, geralmente:

• http://127.0.0.1:3000/mcp
• ou http://localhost:3000/mcp

Use a porta mostrada no painel MCP do Creator (geralmente 3000 por padrão; se você alterou, corresponda ao painel).

Abra também o Cocos Creator e confirme que o painel MCP está Running para o mesmo projeto. Se o painel não estiver em execução, Reload no Cursor não vai expor as ferramentas magicamente.

Páginas de produto (escolha o pacote para a sua versão principal; não misture):

• Cocos MCP 3.x
• Cocos MCP 2.x

Passo 3: Se Ainda Falhar, Pule por Camada

O caminho MCP tem quatro camadas. Falha em qualquer camada pode parecer “Cursor quebrado / não conecta”:

1. Plugin no projeto e habilitado
        ↓
2. Painel ativado (conta / código de licença)
        ↓
3. Servidor MCP mostra Running (localhost)
        ↓
4. Cursor tem configuração escrita e lista MCP mostra conectado

O que você vê no Cursor	Vá aqui primeiro
Nenhuma entrada de serviço	Camada 4: volte ao Creator → Quick configure → Auto configure, depois Reload; detalhes no guia geral
Entrada existe, mas erro / não conecta	Camada 3: o Creator está Running, a porta corresponde, localhost está bloqueado
Nenhum menu MCP dentro do Creator	Camada 1: mistura de pacotes 2.x/3.x, caminho de importação, reiniciar (sintoma A do guia geral)
Painel não inicia / não ativado	Camada 2: conta e ativação (guia geral)
Conectado, mas não lista nós	Confirme que o projeto certo está aberto; execute o teste de somente leitura abaixo; depois verifique os interruptores de ferramentas

Instalação completa:

• Instalação do Cocos Creator 3.x MCP
• Instalação do Cocos Creator 2.x MCP

Passo 4: Teste Rápido (Confirme que Está Corrigido)

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. Opcionalmente, faça uma escrita reversível (crie um nó temporário e exclua-o). Faça commit antes de edições grandes; mantenha a ponte apenas em localhost — não exponha a porta MCP à internet pública.

Perguntas frequentes

O que “Cursor quebrado” após o Cocos Creator MCP geralmente significa?
Sinais típicos: nenhuma entrada de serviço MCP, status vermelho/erro, ou conectado sem ferramentas/nós. A maioria dos casos não é uma falha do Cursor—é uma camada ausente na ponte de quatro camadas.

Devo verificar o Cursor ou o Creator primeiro?
Comece pela lista MCP do Cursor (ausente vs vermelho). Depois verifique o Creator: plugin importado/habilitado, painel ativado, servidor em Execução, porta correspondente à configuração. Use a tabela de sintomas neste artigo.

Conectado mas sem nós—o que fazer?
Confirme que o projeto/cena correto está aberto; execute um teste de fumaça somente leitura (liste nós raiz). Se ainda falhar, verifique alternâncias de ferramentas e permissões. Caminho completo: solução de problemas de conexão.

Preciso reinstalar o Cursor?
Geralmente não. Prefira “configuração rápida → configuração automática” do Creator, recarregue o MCP e verifique a porta localhost. Limite de categoria: O que é Cocos Creator MCP.