Come abilitare il plugin MCP in Godot: dal download agli strumenti in Cursor

Come abilitarlo: cosa copre questa guida

Abilitare il plugin MCP non è solo una spunta: serve il server locale in esecuzione e tool visibili in Cursor (o altro IDE MCP). Cinque passi: scaricare → addons → abilitare plugin → Start Server → verificare in Cursor.

Al termine potrai:

• Mettere il plugin in addons e abilitarlo in Project Settings
• Avviare il Godot MCP Server locale (porta 3000 di default)
• Usare la configurazione in un clic e confermare godot-mcp in Cursor

Checklist di abilitazione (scorri prima)

1. Cartella plugin in addons/<nome>/ (senza annidamento extra)
2. Project Settings → Plugins: Godot MCP Server abilitato
3. Pannello GodotMCP su Running
4. Elenco MCP di Cursor mostra godot-mcp (Reload se serve)
5. Prompt in sola lettura elenca i nodi root della scena attiva

Repo: DaxianLee/godot-mcp · Prodotto: Godot MCP

Prerequisiti

Elemento	Note
Godot	Installato, con un progetto che puoi aprire
Pacchetto plugin	Release di godot-mcp o ZIP sorgente da GitHub
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 Godot MCP

Scarica Godot MCP open source da GitHub:

Repository: https://github.com/DaxianLee/godot-mcp

Flusso suggerito:

1. Apri il repository e usa Code → Download ZIP, oppure prendi l’ultimo pacchetto da Releases
2. Salva l’archivio localmente e preparati a estrarlo
3. Conferma che il pacchetto assomigli a un plugin Godot (una cartella relativa a addons, o una cartella plugin che puoi trascinare in addons)

Passo 2: Aggiungi Godot MCP al tuo progetto

1. Estrai l’archivio sul tuo computer
2. Sposta la cartella del plugin estratto nella directory addons alla radice del progetto Godot
   • Se addons non esiste ancora, creala prima
3. Apri (o ricarica) il progetto in Godot e conferma che i file del plugin appaiano nel dock FileSystem

Esempio di struttura del progetto dopo l’importazione:

Passo 3: Abilita il plugin Godot MCP in Project Settings

1. Apri Progetto → Impostazioni di progetto (o l’equivalente per la tua versione di Godot)
2. Vai alla scheda Plugin
3. Trova Godot MCP Server (il nome può variare leggermente nell’interfaccia)
4. Abilitalo

Dopo l’abilitazione, una voce Godot MCP dovrebbe apparire in un pannello laterale o dock, così puoi impostare la porta e avviare il server nel passaggio successivo.

Passo 4: Avvia Godot MCP Server

1. Nel pannello destro dell’editor Godot, apri il dock GodotMCP
2. Rivedi e regola come necessario:
   • Porta: predefinita 3000
   • Lingua: scegli quella che corrisponde alle tue preferenze UI
   • Avvio: puoi abilitare avvio automatico così il server si avvia quando apri il progetto
3. Clicca Avvia
4. Quando il pannello mostra In esecuzione (o l’equivalente localizzato), Godot MCP Server è attivo

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

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

1. Nel pannello GodotMCP, apri Strumenti
   • Rivedi gli strumenti esposti dal server
   • Abilita solo le funzionalità che vuoi che l’AI usi
2. Apri Configura
   • Scegli il tuo IDE (ad esempio Cursor)
   • Clicca Configura in un clic
   • Attendi un messaggio di configurazione riuscita
3. Apri Cursor
   • Nell’elenco MCP / strumenti dovresti vedere godot-mcp connesso automaticamente
   • Se non appare, clicca Ricarica (o l’azione equivalente di ricaricamento MCP) in Cursor e controlla di nuovo

Configurazione e connessione:

Verifica rapida dopo la connessione

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

Elenca i nodi radice della scena Godot attiva.

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

Ho copiato i file in addons, ma Godot MCP Server manca dall’elenco dei plugin?
Assicurati che la cartella si trovi in addons/<nome-plugin>/ e non sia annidata a un livello di estrazione extra. Ricarica il progetto o riavvia Godot.

Ho cliccato Avvia ma non vedo mai In esecuzione?
Conferma che la porta 3000 (o la tua porta personalizzata) sia libera, poi riprova. Controlla che nulla blocchi localhost.

Cursor non mostra godot-mcp?
In Godot, conferma che il server sia ancora In esecuzione, esegui di nuovo la configurazione in un clic, poi ricarica MCP in Cursor. Se fallisce ancora, controlla che la configurazione MCP di Cursor includa l’indirizzo del bridge locale.

L’avvio automatico è attivo, ma devo comunque avviare manualmente?
Alcune build richiedono un primo avvio manuale riuscito. Conferma che la casella sia salvata, poi riapri lo stesso progetto e verifica.

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 grandi modifiche; mantieni il bridge solo su localhost
• Per il passaggio da design a motore UI, abbinalo a VberAI Studio, poi itera nell’editor con MCP

Per ulteriori informazioni su Godot + MCP, vedi Come abbiamo costruito un server MCP in tempo reale per Godot.