Setup Godot MCP

Capisci quale connessione fornisce MCP

Coding-Solo/godot-mcp documenta strumenti per eseguire progetti Godot, recuperare output di debug e operare sulle scene. È un bridge mantenuto dal progetto, non un servizio modello né una distribuzione ufficiale Godot. L'agente necessita comunque di accesso al proprio modello e di permessi locali appropriati.

Mantieni nel record di setup tre identità: client, revisione del server MCP ed eseguibile Godot. Un errore in una non dimostra che le altre non siano disponibili. Usa il diagramma di connessione per decidere dove ispezionare un problema: autenticazione provider, configurazione client, processo locale dello strumento o progetto engine.

Inventaria i prerequisiti senza cambiarli in silenzio

Prima dell'installazione, ispeziona i requisiti service e seleziona una versione o revisione specifica del server per la revisione. Conferma che engine e runtime esistenti siano trovabili dal processo client e non solo dalla shell interattiva. Registra sistema operativo e directory di progetto prevista.

Rivedi la procedura d'installazione service prima di consentire cambiamenti alle dipendenze. Nomina runtime, revisione del server e posizione d'installazione e conserva un modo per ripristinare l'ambiente precedente. Dopo il setup, registra le versioni risolte e non solo l'URL sorgente mobile. Questo aiuta a riprodurre una connessione funzionante quando client o engine verranno aggiornati.

Usa l'entry point documentato per il build locale

La README service supporta un build da sorgente con build/index.js come entry point del client e GODOT_PATH come override esplicito dell'eseguibile. Il JSON sotto illustra quel percorso già costruito con placeholder. Sostituisci ogni percorso con l'installazione locale revisionata e controlla che il processo client possa leggerlo.

Usa lo schema effettivamente supportato dal tuo client. Un oggetto generico mcpServers non è automaticamente un file di configurazione Codex. Traduci solo tramite le impostazioni documentate del client e tieni le credenziali del modello fuori da questo blocco engine-tool. Un percorso Node assoluto può essere utile quando l'ambiente del client GUI differisce dal terminale.

{
  "mcpServers": {
    "godot": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/reviewed-godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/absolute/path/to/godot"
      }
    }
  }
}

Verifica prima un percorso di strumento read-only

Ispeziona gli strumenti restituiti dal server configurato invece di affidarti a un elenco ricordato. La README nomina get_godot_version e get_project_info come operazioni d'ispezione utili. Controlla lo schema dei parametri scoperto, poi indirizza solo la directory di progetto approvata.

Confronta le informazioni restituite su engine e progetto con il record di setup. Conserva risultati ed errori strutturati. Non approvare la creazione di scene finché l'osservazione non identifica il workspace previsto. Se il client mostra un badge connesso ma non completa questa lettura, la connessione non è pronta per un esperimento di gameplay. Il solo badge non mostra quale processo o progetto è stato raggiunto.

Autorizza un miniflow di scena reversibile

Dopo aver verificato l'accesso in lettura, usa una scena usa-e-getta di tua proprietà per la prima scrittura. Registra stato iniziale, richiedi una modifica visibile, ispeziona la scena salvata, eseguila, recupera l'output e ferma il progetto. Conserva insieme diff del file e osservazioni.

La condizione d'accettazione è una catena dalla modifica richiesta alla risorsa salvata e al comportamento runtime visibile. Se uno strumento segnala successo ma la scena non cambia, ispeziona targeting del progetto e percorsi di salvataggio prima di una seconda mutazione. Riapri la scena dopo il salvataggio per coprire persistenza oltre allo stato in memoria.

Diagnostica i guasti al confine corretto

Se l'avvio del processo fallisce, ispeziona runtime e percorsi dell'entry point. Se Godot non viene trovato, verifica l'override dell'eseguibile dall'ambiente del client. Se un progetto non può essere ispezionato, controlla che il percorso identifichi la directory contenente project.godot e sia leggibile dal processo.

Quando il progetto gira, tratta errori di scena o gameplay come problemi dell'engine con contesto di riproduzione. Non cambiare credenziali del provider per risolvere problemi di percorso locale. Cattura con attenzione i log del server: sanifica dettagli sensibili del filesystem prima di condividerli e mantieni temporaneo il debug dettagliato invece di registrare indiscriminatamente ogni operazione.

Mantieni stretti i confini di approvazione e rete

Uno strumento engine può modificare un progetto funzionante o avviare codice. Concedi accesso alla directory più piccola appropriata e rivedi le richieste di mutazione finché il comportamento non è compreso. Non copiare ampie liste di auto-approvazione solo perché compaiono in un esempio.

Tratta script importati, plugin e output degli strumenti come materiale da ispezionare, non come istruzioni che possono ampliare l'autorità. Download di pacchetti, eliminazione di file fuori dalla scena posseduta, cambi di credenziali e pubblicazione richiedono decisioni esplicite. Il primo miniflow riuscito è una base per rivedere una policy, non un motivo per consentire ogni futura azione dello strumento.

Registra i limiti del setup verificato

Un record di setup completato dovrebbe identificare revisione del server, client, versione dell'engine, percorso del progetto, strumenti scoperti, lettura completata, modifica reversibile e risultato runtime. Indica quali azioni restano non testate. Conservalo con le prove del gioco invece di presentare una garanzia universale di compatibilità.

Il livello successivo è il loop di produzione: implementare una funzione, riprodurne il comportamento, esportarla e testarla sulla piattaforma target. La configurazione qui segue la documentazione service e deve essere validata per client e versioni scelti. Mantieni il risultato circoscritto nel progetto e riusa lo stesso gate d'ispezione quando cambiano server, engine o client.

Domande frequenti