Risoluzione dei Problemi di Connessione Cocos MCP: Cursor Non Mostra cocos-creator
Correzioni basate sui sintomi per Cocos Creator 2.x/3.x MCP: estensione mancante, attivazione fallita, server non in esecuzione, conflitti di porta, MCP di Cur…
- cocos
- cocos-creator
- mcp
- cursor
- troubleshooting
- cocos-mcp
Se dici “Cursor è rotto / non si connette”, parti dai sintomi in Cursor: Cursor rotto dopo Cocos Creator MCP.
Se non è ancora chiaro cosa fa MCP e come differisce da “Cocos Creator AI”, leggi prima Cos’è Cocos Creator MCP.
Quando si collega Cocos MCP a Cursor (o a un altro client MCP), il blocco usuale non sono i “prompt sbagliati”—è che il ponte non si connette mai: il server dell’editor è giù, o l’IDE AI non elenca mai cocos-creator.
Questa guida segue sintomo → causa → correzione per Creator 2.x e 3.x. Flussi di installazione completi:
Gli esempi usano Cursor; Claude Code, Codex e client simili seguono gli stessi controlli di ricaricamento/configurazione.
Prima: quale livello ha fallito?
Il percorso MCP ha quattro livelli. Un fallimento in qualsiasi livello appare come “impossibile connettersi”:
1. Estensione installata e abilitata
↓
2. Pannello attivato (account / codice licenza)
↓
3. Server MCP mostra In esecuzione (localhost)
↓
4. Configurazione IDE AI scritta e elenco MCP mostra connesso
| Cosa vedi | Controlla prima |
|---|---|
| Nessun menu Estensione → Cocos MCP Server / MCP Server | Livello 1: versione pacchetto, percorso di importazione, riavvio |
| Il pannello si apre ma non può avviarsi / rimane non attivato | Livello 2: account e licenza |
| Cliccato Avvia ma mai In esecuzione | Livello 3: porta, firewall, attivazione |
Creator mostra In esecuzione, Cursor non ha cocos-creator | Livello 4: configurazione rapida, ricaricamento MCP, file di configurazione |
| Cursor mostra connesso ma non può elencare i nodi della scena | Prompt di verifica, interruttori strumenti, progetto corretto aperto |
Sintomo A: Nessuna estensione MCP nel menu
Cause probabili
- Pacchetti 2.x / 3.x mescolati
- 3.x: non importato in Gestione Estensioni, o ancora disabilitato
- 2.x: non sotto
packages/<nome-plugin>/, o un livello di annidamento extra dopo l’unzip - 2.x: file posizionati ma Creator non riavviato completamente
Correzioni
Creator 3.x:
- Scarica da Cocos MCP 3.x—non il pacchetto 2.x
- Apri il progetto → Estensione → Gestione Estensioni → Importa → seleziona lo zip 3.x
- Conferma che
cocos-mcp-serverè abilitato; abilitalo se disabilitato - Se il menu manca ancora: esci da Creator e riapri lo stesso progetto
Creator 2.x:
- Scarica da Cocos MCP 2.x
- Dopo l’unzip, la struttura dovrebbe apparire così:
radice-del-tuo-progetto/
packages/
<nome-plugin>/ ← file del plugin direttamente qui
package.json ← dovrebbe esistere a questo percorso (nome secondo pacchetto)
- Annidamento errato esempio:
packages/
xxx-mcp-unzip/
<nome-plugin>/
package.json
- Correggi il percorso, poi esci e riavvia Creator (non solo aggiorna la scena). Controlla Estensione → MCP Server.
Sintomo B: Il pannello si apre, ma l’attivazione fallisce o il servizio non si avvia
Cause probabili
- L’account non ha il diritto Pro corrispondente
- Codice licenza scaduto o email non corrispondente
- Cliccato Avvia prima dell’attivazione
Correzioni
- Apri il pannello MCP (3.x:
Estensione → Cocos MCP Server → Apri Pannello MCP; 2.x:Estensione → MCP Server) - Attiva con uno dei seguenti:
- Account VberAI + password
- Email + codice licenza
- Conferma piano / codice sul centro account ufficiale, poi riprova nel pannello
- Solo dopo l’attivazione apri le impostazioni del server MCP e clicca Avvia
Senza attivazione, il server di solito non raggiunge mai In esecuzione. Correggi il lato editor prima di incolpare Cursor.
Sintomo C: Cliccato Avvia, ma mai In esecuzione
Cause probabili
- Ancora non attivato (vedi sintomo B)
- Porta in uso (3.x spesso predefinita
3000; 2.x segue il pannello) - Firewall / software di sicurezza blocca l’ascolto su localhost
Correzioni
- Annota la porta sulla pagina delle impostazioni del server MCP (esempi sotto usano
3000—sostituisci con il valore del tuo pannello) - Controlla se qualcosa è già in ascolto:
macOS / Linux:
lsof -iTCP:3000 -sTCP:LISTEN
Windows (PowerShell):
netstat -ano | findstr :3000
- Se un altro processo occupa la porta:
- ferma quel processo, oppure
- scegli una porta libera nel pannello MCP, poi Avvia di nuovo
- Assicurati che il firewall permetta
127.0.0.1(non esporre MCP a internet pubblico) - Quando il pannello mostra In esecuzione, configura l’IDE AI
Sintomo D: Creator è In esecuzione, Cursor non ha cocos-creator
La maggior parte dei rapporti di “connessione fallita” si ferma qui: editor OK, client non ha mai ingerito la configurazione.
Correzioni (in ordine)
- In Creator, conferma che il pannello MCP sia ancora In esecuzione (cambi di porta o riavvii dell’editor possono fermarlo)
- Apri Gestione Strumenti e abilita gli strumenti necessari
- Apri Configurazione Rapida → scegli Cursor → Configurazione Automatica finché l’interfaccia non mostra Configurato
- In Cursor → elenco MCP / strumenti:
- Dovresti vedere
cocos-creator(o il nome mostrato nel pannello) - Se manca: Ricarica MCP (o riavvia Cursor) e controlla di nuovo
- Dovresti vedere
- Ancora manca: verifica che la configurazione MCP di Cursor contenga il ponte locale (
127.0.0.1+ porta del pannello)
L’output della Configurazione Automatica varia a seconda della versione di Cursor. Quando ispezioni manualmente:
- Il nome del servizio corrisponde a Cocos MCP (es.
cocos-creator) - L’host è
127.0.0.1olocalhost, la porta corrisponde a Creator - Non un IP LAN o pubblico per errore
Dopo qualsiasi modifica alla configurazione, ricarica MCP di nuovo o l’interfaccia mantiene lo stato vecchio.
Altri IDE AI
In Configurazione Rapida, scegli Claude Code, Codex, Windsurf, Cline, ecc., poi Configurazione Automatica → ricarica MCP in quel client. Configurare Cursor non collega ogni IDE.
Sintomo E: Mostra connesso, ma non può elencare la scena / modificare i nodi
Cause probabili
- Il progetto / scena aperto in Creator non corrisponde a ciò che hai chiesto
- Strumenti necessari non selezionati in Gestione Strumenti
- Hai verificato solo “file su disco,” non contesto editor
Verifica
Invia un prompt sola lettura in Cursor:
Elenca i nomi dei nodi radice della scena attualmente aperta in Cocos Creator.
| Risultato | Significato |
|---|---|
| Corrisponde alla Gerarchia | Ponte OK; prova una piccola scrittura dopo |
| Errore chiaro / nessuno strumento | Torna ai sintomi C/D |
| Nomi di nodi inventati | MCP probabilmente non usato; controlla connessione e interruttori strumenti |
Poi prova una piccola scrittura (crea un nodo temporaneo e cancellalo). Fai commit prima di modifiche grandi.
Tabella rapida 2.x vs 3.x
| Elemento | Creator 3.x | Creator 2.x |
|---|---|---|
| Pagina prodotto | cocos (3.x) | cocos2x |
| Installazione | Gestione Estensioni → Importa | Decomprimi in packages/ del progetto |
| Dopo installazione | Abilita nell’elenco | Devi riavviare Creator |
| Pacchetto | Solo 3.x | Solo 2.x |
| Passi completi | Installazione 3.x | Installazione 2.x |
Pacchetti mescolati spesso mostrano “nessun menu” o “importazione fallita”—usa questa tabella prima.
Ordine consigliato (checklist di 5 minuti)
Spunta in ordine; la maggior parte dei fallimenti si trova nei primi quattro:
- La versione principale di Creator corrisponde allo zip MCP (2.x ↔ 2.x, 3.x ↔ 3.x)
- Estensione abilitata / percorso
packagescorretto; 2.x riavviato - Pannello attivato con successo
- Pannello mostra In esecuzione; porta libera
- Configurazione Rapida → Configurazione Automatica per l’IDE corrente
- Ricaricato MCP nell’IDE AI;
cocos-creatorelencato - Prompt sola lettura elenca le radici della scena attualmente aperta
Se fallisce ancora, cattura questo
Quando chiedi supporto o a un collega, includi:
- Versione esatta di Creator (es. 3.8.x / 2.4.x)
- Tipo di pacchetto MCP (2.x o 3.x Pro)
- Se il pannello è In esecuzione, e la porta
- Nome/versione IDE AI e screenshot dell’elenco MCP
- Prompt esatto di sola lettura e risposta
Mantieni il ponte solo su localhost; non pubblicare la porta MCP.
Documenti correlati
Continua a leggere
Altre guide che potrebbero interessarti
Cursor Rotto Dopo Cocos Creator MCP: Risolvi la Connessione in Base al Sintomo
Cursor sembra 'rotto' dopo aver collegato VberAI Cocos Creator MCP: servizio mancante, errori MCP rossi, connesso ma senza strumenti. Controlla prima Cursor, p…
- cocos
- cocos-creator
- mcp
- cursor
Livelli Audio di AI Studio: Colonna Sonora, Voce ed Effetti Sonori sulla Stessa Tela
Come AI Studio di VberAI gestisce l'audio di gioco: livelli audio e strumenti fluttuanti, musica/voce/effetti sonori, librerie e gestione asset, modifica tracc…
- AI Studio
- VberAI
- game audio
- SFX
Plugin MCP per Unity Game Engine: Potenzia il tuo flusso di lavoro di sviluppo di giochi
Scopri la demo del plugin Unity MCP di VberAI: collega Unity agli strumenti AI tramite MCP e controlla GameObject, script e scene con il linguaggio naturale.
- video
- tutorial
- unity
- mcp