Guida all'installazione di Cocos Creator 3.x MCP: importa l'estensione e connetti un IDE AI

Cosa copre questa guida

Segui questi cinque passaggi per connettere Cocos Creator 3.x MCP (VberAI Pro) a un progetto Creator locale, così che Cursor (o un altro IDE AI compatibile con MCP — stessa idea) possa operare, visualizzare in anteprima e fare debug dell’editor, non solo modificare script su disco.

Al termine, dovresti essere in grado di:

• Importare e abilitare cocos-mcp-server tramite Extension Manager
• Attivare con un account VberAI o email + codice di attivazione
• Avviare il Cocos MCP Server locale (porta predefinita 3000)
• Usare Quick configure → Auto configure per registrare il server in Cursor e confermare la connessione

Pagina del prodotto: VberAI Cocos MCP 3.x

Questo articolo usa Cursor come esempio. Claude Code, Windsurf, Cline e altri client MCP seguono un flusso simile.

Prerequisiti

Elemento	Note
Cocos Creator	3.0+ (qualsiasi progetto 3.x)
Pacchetto plugin	Archivio Cocos Creator 3.x MCP Pro dal sito ufficiale
Attivazione	Account VberAI + password, oppure email + codice di attivazione
IDE AI	Cursor consigliato; altri client MCP funzionano anche
Rete locale	Il bridge MCP di solito gira su 127.0.0.1 — non esporre la porta pubblicamente

Passo 1: Scarica Cocos Creator 3.x MCP

Scarica la build Pro dal sito VberAI:

Pagina di download: https://www.vberai.com/game-engines/cocos?ch=CQZLC2FG

Flusso suggerito:

1. Apri la pagina e scarica Cocos MCP 3.x Pro con i permessi del tuo account
2. Salva l’archivio localmente — non è necessario estrarlo nel progetto (il prossimo passo importa l’archivio)
3. Conferma che il progetto sia Creator 3.0 o successivo; non mescolare con il pacchetto 2.x

Le differenze OSS vs Pro e la fatturazione seguono il testo attuale del sito.

Passo 2: Importa l’estensione

1. Apri il tuo progetto Cocos Creator 3.x
2. Menu: Extension → Extension Manager → Import Extension
3. Seleziona l’archivio Cocos Creator 3.x MCP che hai appena scaricato
4. Dopo un’importazione riuscita, l’elenco delle estensioni dovrebbe mostrare cocos-mcp-server abilitato

Se appare disabilitato, abilitalo prima di continuare.

Passo 3: Attiva cocos-mcp-server

1. Menu: Extension → Cocos MCP Server → Open Mcp Panel
2. Nella schermata di attivazione, usa uno dei seguenti:
   • Account VberAI + password
   • Email + codice di attivazione
3. Dopo che l’attivazione riesce, apri la pagina delle impostazioni del server MCP (prossimo passo)

Senza attivazione, il server di solito non si avvia. Conferma che il tuo piano o codice corrisponda alla build Pro corrente.

Passo 4: Avvia cocos-mcp-server

1. Dopo l’attivazione, apri Impostazioni del server MCP
2. Regola come necessario:
   • Porta: predefinita 3000
   • Lingua: corrispondi alla tua preferenza UI
   • Avvio: usa le opzioni del pannello (ad esempio avvio automatico con l’editor, se disponibile)
3. Clicca Start service
4. Quando il pannello mostra Running, Cocos MCP Server è attivo

Ora hai un bridge MCP locale. Successivamente, passalo al tuo IDE AI.

Passo 5: Configurazione AI IDE in un clic (esempio Cursor)

1. Apri Tool manager
   • Rivedi gli strumenti esposti da Cocos MCP Server
   • Abilita solo ciò che vuoi che l’AI usi
2. Apri Quick configure
   • Scegli il tuo IDE (ad esempio Cursor)
   • Clicca Auto configure
   • Conferma che la UI mostri uno stato configurato
3. Apri Cursor
   • Nell’elenco MCP / strumenti dovresti vedere cocos-creator (o il nome mostrato nel pannello) connesso
   • Se manca, clicca Reload (o l’equivalente ricarica MCP) in Cursor e controlla di nuovo

Altri IDE seguono lo stesso percorso — basta scegliere un client diverso in Quick configure.

Verifica rapida dopo la connessione

In Cursor, inizia con un controllo di sola lettura, ad esempio:

Elenca i nodi radice della scena attualmente aperta in Cocos Creator.

Se la risposta corrisponde alla gerarchia dell’editor, il bridge funziona. Poi prova una piccola scrittura (crea un nodo temporaneo ed eliminalo) per confermare i permessi e la selezione degli strumenti.

FAQ

Importazione fallita, o cocos-mcp-server manca dall’elenco?
Usa l’archivio ufficiale 3.x (non 2.x). Creator deve essere 3.0+. Se rimane disabilitato, abilitalo in Extension Manager e riavvia Creator.

L’attivazione continua a fallire?
Conferma i diritti Pro, o che il codice di attivazione sia valido e legato all’email corretta. Controlla il centro account sul sito, poi riprova nel pannello.

Ho cliccato Start service ma non vedo mai Running?
Conferma che la porta 3000 (o la tua porta personalizzata) sia libera e che localhost non sia bloccato. Assicurati che il Passo 3 sia completato con successo.

Cursor non mostra cocos-creator?
In Creator, conferma che il server sia ancora Running, esegui di nuovo Quick configure → Auto configure, poi ricarica MCP in Cursor. Se fallisce ancora, controlla che la configurazione MCP di Cursor includa l’indirizzo del bridge locale.

Passi successivi

• Usa il linguaggio naturale per una query sulla scena o una piccola modifica per imparare i limiti degli strumenti
• Fai commit prima di modifiche grandi; mantieni il bridge solo su localhost
• Per UI da design a engine, abbina con VberAI Studio, poi itera nell’editor con MCP

Per Creator 2.x, segui la guida all’installazione di Cocos Creator 2.x MCP — non mescolare i pacchetti. Per chiarire i limiti e la differenza dal vago “Cocos Creator AI”, vedi Cos’è Cocos Creator MCP. Per più contesto su MCP, vedi la guida video su Cocos Creator MCP.