Godot MCP instellen

Begrijp welke verbinding MCP levert

Coding-Solo/godot-mcp documenteert tools om Godot-projecten te starten, debugoutput op te halen en scenes te bedienen. Het is een door het project onderhouden bridge, geen modelservice of officiële Godot-distributie. De agent heeft nog steeds eigen modeltoegang en passende lokale machtigingen nodig.

Houd in je setuprecord drie identiteiten bij: de client, de revisie van de MCP-server en de Godot-executable. Een fout in één daarvan is geen bewijs dat de andere niet beschikbaar zijn. Gebruik het verbindingsdiagram om te bepalen waar je een probleem inspecteert: providerauthenticatie, clientconfiguratie, lokaal toolproces of engineproject.

Inventariseer vereisten zonder ze stilzwijgend te wijzigen

Inspecteer vóór installatie de vereisten service en selecteer een specifieke serverversie of revisie voor review. Controleer of de bestaande engine en runtime vanuit het clientproces gevonden kunnen worden, niet alleen vanuit je interactieve shell. Leg besturingssysteem en beoogde projectdirectory vast.

Review de service-installatieprocedure voordat je dependencywijzigingen toestaat. Benoem runtime, serverrevisie en installatielocatie en houd een manier om de vorige omgeving te herstellen. Leg na de setup de opgeloste versies vast en niet alleen de bewegende source-URL. Zo kun je een werkende verbinding reproduceren wanneer de client of engine later wordt geüpgraded.

Gebruik het gedocumenteerde lokale build-entrypoint

De service-README ondersteunt een source-build met build/index.js als client-entrypoint en GODOT_PATH als expliciete executable override. De JSON hieronder illustreert die al gebouwde route met placeholders. Vervang elk pad door de gereviewde lokale installatie en controleer of het clientproces het kan lezen.

Gebruik het schema dat je client daadwerkelijk ondersteunt. Een generiek mcpServers-object is niet automatisch een Codex-configuratiebestand. Vertaal dit alleen via de gedocumenteerde instellingen van die client en houd modelcredentials buiten dit engine-toolblok. Een absoluut Node-pad kan nuttig zijn wanneer de omgeving van de GUI-client verschilt van de terminal.

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

Verifieer eerst een read-only toolpad

Inspecteer de tools die de geconfigureerde server teruggeeft in plaats van te vertrouwen op een onthouden lijst. De README noemt get_godot_version en get_project_info als nuttige inspectiebewerkingen. Controleer hun ontdekte parameterschema en richt je daarna alleen op de goedgekeurde projectdirectory.

Vergelijk geretourneerde engine- en projectinformatie met het setuprecord. Bewaar gestructureerde resultaten en fouten. Keur geen scenecreatie goed voordat de observatie de bedoelde workspace identificeert. Als de client een connected-badge toont maar deze read niet kan voltooien, is de verbinding niet klaar voor een gameplayexperiment. Een badge toont niet welk proces of project is bereikt.

Geef één omkeerbare scene-miniflow toestemming

Gebruik na verificatie van readtoegang een disposable scene die je beheert voor de eerste write. Leg de oorspronkelijke status vast, vraag één zichtbare wijziging, inspecteer de opgeslagen scene, voer haar uit, haal output op en stop het project. Bewaar de resulterende filediff en observaties samen.

De acceptatievoorwaarde is een keten van gevraagde wijziging naar opgeslagen resource en zichtbaar runtimegedrag. Wanneer een tool succes meldt maar de scene niet verandert, inspecteer projecttargeting en opgeslagen paden voordat je een tweede mutatie probeert. Open de scene na opslaan opnieuw zodat de controle zowel persistentie als de huidige in-memory-status omvat.

Diagnosticeer fouten aan de juiste grens

Inspecteer bij een mislukte processtart runtime- en entrypointpaden. Controleer als Godot niet gevonden kan worden de executable override vanuit de clientomgeving. Controleer als een project niet kan worden geïnspecteerd of het pad de directory met project.godot identificeert en voor het proces leesbaar is.

Behandel scene- of gameplayfouten zodra het project draait als engineproblemen met reproductiecontext. Wijzig providerc credentials niet om lokale padproblemen op te lossen. Leg serverlogs zorgvuldig vast: maak gevoelige bestandssysteemdetails onschadelijk voordat je ze deelt en houd gedetailleerde debugging tijdelijk in plaats van elke projectbewerking zonder onderscheid vast te leggen.

Houd goedkeurings- en netwerkgrenzen smal

Een enginetool kan een werkend project wijzigen of code starten. Geef toegang tot de kleinst passende directory en review mutatieverzoeken totdat je het gedrag begrijpt. Kopieer geen brede auto-approval-lijsten alleen omdat ze in een voorbeeldconfiguratie staan.

Behandel geïmporteerde scripts, plugins en tooloutput als materiaal om te inspecteren, niet als instructies die bevoegdheid kunnen uitbreiden. Package-downloads, bestanden verwijderen buiten de beheerde scene, credentialwijzigingen en publiceren vereisen expliciete beslissingen. De eerste geslaagde miniflow is een basis voor beleidsreview en geen reden om elke toekomstige toolactie toe te staan.

Leg de grenzen van de geverifieerde setup vast

Een voltooid setuprecord moet serverrevisie, client, engineversie, projectpad, ontdekte tools, voltooide read, omkeerbare wijziging en runtime-resultaat identificeren. Vermeld welke acties nog niet getest zijn. Bewaar het bij de game-evidence in plaats van een universele compatibiliteitsgarantie te presenteren.

De volgende laag is de productieloop: een feature implementeren, gedrag reproduceren, exporteren en op het doelplatform testen. De configuratie hier volgt upstreamdocumentatie en moet voor je gekozen client en versies worden gevalideerd. Bewaar dit afgebakende resultaat bij het project en hergebruik dezelfde inspectiepoort wanneer server, engine of client wijzigt.

Veelgestelde vragen