Connecter l'IA à Godot 4
Configurez MCP Pro en 5 minutes et laissez Claude ou Cursor piloter directement votre éditeur Godot. Installez le plugin, compilez le serveur, configurez votre client IA — et vous êtes prêt.
get_project_info get_scene_treeGodot MCP Pro est un serveur MCP doté de 175 outils qui connecte les assistants IA comme Claude et Cursor directement à l'éditeur Godot 4 via WebSocket. Il permet à l'IA de créer des scènes, d'écrire du GDScript, de simuler les entrées du joueur, d'inspecter des jeux en cours d'exécution, de construire des environnements 3D, de configurer la physique, de gérer les particules et l'audio — le tout depuis une seule conversation. Achat unique de $15, fonctionne sous Windows, macOS et Linux.
Achat unique de $15 · Mises à jour à vieUne seule requête → l'IA construit un jeu de Reversi complet, le lance et le teste à la souris.
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor
Communication bidirectionnelle en temps réel. Aucune interrogation de fichiers. Aucun sous-processus CLI. Juste un retour instantané.
Des guides Godot 4 pratiques propulsés par l'IA. Aucune information obsolète de Godot 3 — tout ici est testé sur Godot 4.4+.
Configurez MCP Pro en 5 minutes et laissez Claude ou Cursor piloter directement votre éditeur Godot. Installez le plugin, compilez le serveur, configurez votre client IA — et vous êtes prêt.
get_project_info get_scene_treeDemandez à l'IA de créer un jeu 2D complet — scènes, scripts, signaux, interface. Ce guide détaille la construction d'un jeu de plateau Reversi en une seule conversation avec l'IA, du projet vide au jeu jouable.
create_scene add_node create_script connect_signal play_sceneConstruisez un contrôleur de personnage à la troisième personne avec des animations Mixamo, une machine à états AnimationTree, une caméra SpringArm3D et un terrain — le tout créé par l'IA. Couvre CharacterBody3D, les couches de physique et le mélange d'animations dans Godot 4.
add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3dGodot 4 a entièrement revu les signaux par rapport à Godot 3. Fini le connect("signal", obj, "method") — on utilise signal.connect(callable). Laissez l'IA auditer votre architecture de signaux, repérer les signaux non connectés et visualiser le flux des signaux dans tout votre projet.
analyze_signal_flow find_signal_connections get_signals connect_signalLaissez l'IA tester votre jeu. Lancez le jeu, simulez les entrées clavier/souris, capturez des captures d'écran, vérifiez l'état du jeu et exécutez des tests de charge avec des entrées aléatoires. Aucun framework de test requis — MCP Pro gère tout au niveau de l'éditeur.
play_scene simulate_key capture_frames assert_node_state run_stress_testL'AnimationTree de Godot 4 est puissant mais complexe. Laissez l'IA créer des machines à états avec transitions, mettre en place des arbres de mélange, configurer des conditions et câbler les paramètres — l'obstacle le plus courant pour les débutants Godot, résolu en quelques minutes.
create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameterGodot 4 a renommé PhysicsBody en CharacterBody/RigidBody et modifié les API des couches de collision. Laissez l'IA configurer les formes de collision, paramétrer correctement les couches de physique, ajouter des raycasts et auditer votre configuration de collisions — en évitant les bugs de physique les plus courants.
setup_collision set_physics_layers setup_physics_body get_collision_infoGodot 4 a remplacé les CPUParticles par défaut par les GPUParticles2D/3D. Créez du feu, de la fumée, de la pluie, de la neige et des étincelles avec des préréglages intégrés, ou affinez la forme d'émission, les courbes de vélocité et les dégradés de couleur — le tout via des requêtes en langage naturel.
create_particles apply_particle_preset set_particle_color_gradient set_particle_materialConnectez votre assistant IA à Godot en moins de 5 minutes.
Copiez addons/godot_mcp/ dans votre projet Godot. Activez-le dans Projet > Paramètres du projet > Extensions. Le plugin démarre automatiquement un serveur WebSocket à l'intérieur de l'éditeur.
Exécutez npm install && npm run build dans le répertoire server/. Cela compile le serveur MCP TypeScript qui fait le pont entre votre client IA et le plugin Godot.
Ajoutez le serveur à la configuration MCP de votre client IA. Ouvrez Godot, et votre assistant IA a désormais un accès en temps réel à 175 outils — création de scènes, édition de scripts, simulation d'entrées et analyse de votre jeu en cours d'exécution.
Tout ce qu'il faut pour laisser l'IA construire, inspecter, tester et modifier votre projet Godot en 2D et en 3D.
get_project_info metadata & autoloadsget_filesystem_tree recursive file treesearch_files fuzzy/glob searchget/set_project_settings read & writeuid_to_project_path UID conversionproject_path_to_uid path conversionget_scene_tree live hierarchyget_scene_file_content raw .tscncreate_scene new scenesopen_scene delete_scene save_sceneadd_scene_instance prefab-like instancingplay_scene stop_sceneadd_node delete_node rename_nodeduplicate_node deep copymove_node reparentupdate_property smart type parsingget_node_properties inspect all propsadd_resource shapes, materialsset_anchor_preset UI anchorsconnect_signal disconnect_signallist_scripts project-wide overviewread_script create_scriptedit_script search/replace & insertattach_script attach to nodesget_open_scripts editor awarenessget_editor_errors errors & stack tracesget_editor_screenshot editor viewportget_game_screenshot running gamecompare_screenshots visual diff NEWexecute_editor_script run GDScriptget_signals inspect signal connectionsreload_plugin reload_projectclear_outputsimulate_key keyboard with modifierssimulate_mouse_click positioned clickssimulate_mouse_move absolute/relativesimulate_action Godot InputActionssimulate_sequence multi-event combosget_game_scene_tree live game hierarchyget/set_game_node_properties runtime inspection & tweakingexecute_game_script run code in live gamecapture_frames multi-frame screenshotsmonitor_properties property timelinestart/stop/replay_recording input recording & replay NEWfind_nodes_by_script get_autoloadfind_ui_elements click_button_by_text NEWwait_for_node batch_get_properties NEWlist_animations create_animationadd_animation_track value/position/bezierset_animation_keyframe insert keysget_animation_info tracks & keyframesremove_animationcreate_animation_tree with state machine rootget_animation_tree_structure full tree inspectionadd/remove_state_machine_state manage statesadd/remove_state_machine_transition with conditionsset_blend_tree_node Add2, Blend2, TimeScaleset_tree_parameter conditions & blendstilemap_set_cell place tilestilemap_fill_rect fill regionstilemap_get_cell read tile datatilemap_clear clear alltilemap_get_info tile set sourcestilemap_get_used_cells query used cellsadd_mesh_instance primitives & .glb/.gltf importsetup_lighting sun/indoor/dramatic presetsset_material_3d full PBR material setupsetup_environment sky, fog, glow, SSAO, SSRsetup_camera_3d projection, FOV, cull maskadd_gridmap GridMap with MeshLibrarysetup_collision auto-detect 2D/3D shapesset/get_physics_layers layer & mask managementadd_raycast RayCast2D/3Dsetup_physics_body CharacterBody & RigidBody configget_collision_info full collision auditcreate_particles GPUParticles 2D/3Dset_particle_material direction, velocity, emission shapeset_particle_color_gradient color ramp stopsapply_particle_preset fire, smoke, rain, snow, sparksget_particle_info full config inspectionsetup_navigation_region auto-detect 2D/3Dbake_navigation_mesh mesh baking & polygon gensetup_navigation_agent pathfinding & avoidanceset_navigation_layers layer managementget_navigation_info full nav auditget_audio_bus_layout full bus overviewadd_audio_bus set_audio_bus create & configureadd_audio_bus_effect reverb, delay, compressor, EQadd_audio_player 2D/3D audio playersget_audio_info subtree audio auditcreate_theme new Theme resourceset_theme_color color overridesset_theme_constant constant overridesset_theme_font_size font sizesset_theme_stylebox StyleBoxFlatget_theme_info inspect overridescreate_shader with templatesread_shader edit_shaderassign_shader_material to nodesset_shader_param set uniformsget_shader_params read all paramsread_resource inspect .tres propertiesedit_resource modify & savecreate_resource new .tres of any typefind_nodes_by_type search by classfind_signal_connections audit signalsbatch_set_property bulk changesfind_node_references cross-file searchget_scene_dependencies dependency graphcross_scene_set_property project-wide changes NEWrun_test_scenario automated test sequencesassert_node_state property assertionsassert_screen_text UI text verificationrun_stress_test random input fuzzingget_test_report pass/fail summaryfind_unused_resources dead asset detectionanalyze_signal_flow signal graph mappinganalyze_scene_complexity node count & depthfind_script_references cross-project searchdetect_circular_dependencies cycle detectionget_project_statistics full project overviewget_performance_monitors FPS, memory, physicsget_editor_performance quick summarylist_export_presets configured presetsexport_project build commandsget_export_info paths & templatesDes fonctionnalités absentes des alternatives gratuites.
Connectez, déconnectez et inspectez les signaux entre les nœuds. Aucun concurrent ne le propose. Essentiel pour l'architecture événementielle de Godot.
Chaque modification passe par le système UndoRedo de Godot. Annulez avec Ctrl+Z tout ce que fait l'IA. Les alternatives gratuites modifient les scènes directement, sans possibilité d'annulation.
Vector2(100,200), #ff0000, Color(1,0,0) — l'IA envoie des chaînes de caractères, et nous les convertissons automatiquement en types Godot appropriés.
WebSocket avec heartbeat, reconnexion automatique (backoff exponentiel) et balayage automatique des ports. Aucune connexion perdue, aucun redémarrage manuel.
Les erreurs incluent des codes structurés et des suggestions concrètes. L'IA peut s'auto-corriger au lieu de rester bloquée sur des échecs cryptiques.
11 outils de nœuds : ajouter, supprimer, renommer, dupliquer, déplacer/re-parenter, mettre à jour les propriétés, ajouter des ressources, définir les ancres. Aucun concurrent ne couvre tout cela.
Laissez l'IA jouer à votre jeu. Simulez le clavier, la souris et les InputActions. Enregistrez des sessions d'entrées et rejouez-les pour des tests de régression au timing précis à la frame.
15 outils pour inspecter le jeu en direct. Lisez et modifiez les propriétés à l'exécution, capturez des frames, surveillez les changements de propriétés, trouvez les éléments d'interface, cliquez sur les boutons par leur texte et attendez l'apparition des nœuds.
Créez des animations, ajoutez des pistes, insérez des images-clés. Construisez des machines à états avec transitions et conditions. Configurez des arbres de mélange avec les nœuds Add2, Blend2 et TimeScale.
Ajoutez des maillages (primitives ou .glb/.gltf), configurez l'éclairage avec des préréglages, paramétrez des matériaux PBR, créez des environnements avec ciel/brouillard/SSAO/SSR, placez des caméras et construisez des GridMaps.
Configurez les formes de collision, paramétrez les corps physiques, gérez les couches de collision, ajoutez des raycasts. Créez des régions de navigation, générez des maillages de nav, configurez des agents de recherche de chemin.
Créez des systèmes de particules GPU avec des préréglages (feu, fumée, pluie, neige). Gérez les bus audio, ajoutez des effets (réverbération, delay, compresseur) et placez des lecteurs audio 2D/3D.
Créez des shaders à partir de modèles, éditez le code GLSL, assignez des ShaderMaterials et ajustez les uniformes à l'exécution. Un workflow de shader complet sans quitter le chat IA.
Exécutez des scénarios de test automatisés avec simulation d'entrées et assertions. Vérifiez le texte de l'interface à l'écran. Testez la robustesse par fuzzing d'entrées aléatoires. Générez des rapports de test réussite/échec.
Trouvez les ressources inutilisées, cartographiez les flux de signaux, analysez la complexité des scènes, détectez les dépendances circulaires, recherchez les références de scripts et obtenez des statistiques complètes du projet.
Trouvez des nœuds par type, auditez les connexions de signaux, définissez des propriétés en masse à travers les scènes, effectuez des recherches dans tous les fichiers du projet et analysez les dépendances. Refactorisez à grande échelle.
Des exemples concrets de ce que vous pouvez demander à votre assistant IA — et ça fonctionne, tout simplement.
L'IA crée les scènes, écrit les scripts, connecte les signaux, met en place l'interface et lance le jeu — le tout dans une seule conversation. Regardez la vidéo de démo.
L'IA ajoute des maillages, configure les préréglages d'éclairage, paramètre les matériaux PBR et ajuste les réglages d'environnement — le tout via l'API de l'éditeur avec annulation/rétablissement complets.
L'IA lance le jeu, simule les entrées clavier, capture des captures d'écran, inspecte les propriétés des nœuds à l'exécution et vérifie l'état du jeu — permettant des workflows d'assurance qualité automatisés.
L'IA lit la sortie d'erreurs de l'éditeur et les erreurs de compilation des scripts, identifie le problème, modifie le script pour le corriger et vérifie la correction — une boucle de rétroaction serrée sans copier-coller de messages d'erreur.
L'IA crée des particules GPU, configure la forme d'émission et la vélocité, applique des dégradés de couleur, ou utilise des préréglages intégrés (feu, fumée, pluie, neige, étincelles) pour des résultats instantanés.
L'IA effectue des recherches dans toutes les scènes, trouve les nœuds correspondants et applique des changements de propriétés en masse — des tâches qui prendraient des minutes de clics manuels réalisées en quelques secondes.
Comment Godot MCP Pro se compare aux alternatives.
| Fonctionnalité | Godot MCP Pro | GDAI MCP ($19) | godot-mcp (free) |
|---|---|---|---|
| Nombre total d'outils | 175 | ~30 | 13 |
| Catégories | 23 | ~8 | 4 |
| Connexion | WebSocket + heartbeat | stdio (Python) | Headless CLI |
| Undo/Redo | Yes | Yes | No |
| Gestion des signaux | Yes | No | No |
| Renommer/Dupliquer/Déplacer des nœuds | Yes | No | No |
| Analyse intelligente des types | Yes | Limited | No |
| Simulation d'entrées | Key / Mouse / Action / Sequence | Yes (basic) | No |
| Analyse à l'exécution | 15 outils (arbre, propriétés, frames, interface, enregistrement) | No | No |
| Outils de scène 3D | Mesh, Lighting, PBR, Environment, Camera | No | No |
| Configuration de la physique | Collision, Layers, Raycasts, Bodies | No | No |
| Particules | GPU 2D/3D with presets | No | No |
| Navigation | Region, Mesh baking, Agent | No | No |
| Audio | Buses, Effects, Players | No | No |
| AnimationTree | State machine, Blend tree | No | No |
| Tests automatisés | Scénarios, assertions, tests de charge | No | No |
| Analyse de code | Ressources inutilisées, flux de signaux, complexité | No | No |
| Captures d'écran | Éditeur + Jeu + Différence visuelle | Yes | No |
Questions fréquentes sur Godot MCP Pro.
Godot MCP Pro est un serveur MCP (Model Context Protocol) premium qui connecte les assistants IA comme Claude, Cursor et Cline directement à l'éditeur Godot 4 via WebSocket. Il fournit 175 outils répartis en 23 catégories pour la manipulation de scènes, l'animation, la modélisation 3D, la configuration de la physique, les effets de particules, la gestion de l'audio, l'édition de shaders, la simulation d'entrées, l'analyse à l'exécution et les tests automatisés.
Installez le plugin Godot MCP Pro dans votre projet, activez-le dans Paramètres du projet > Extensions, compilez le serveur MCP avec npm install && npm run build, et ajoutez-le à votre .mcp.json. Claude (Code ou Desktop) se connectera automatiquement à l'éditeur Godot via WebSocket et aura accès à l'ensemble des 175 outils.
Tout client IA compatible MCP fonctionne, y compris Claude Code, Claude Desktop, Cursor, VS Code avec l'extension Cline, Windsurf et d'autres outils qui prennent en charge le standard Model Context Protocol. Le protocole MCP est un standard ouvert, de nouveaux clients sont donc ajoutés régulièrement.
Oui. Godot MCP Pro inclut des outils 3D dédiés pour ajouter des primitives de maillage ou importer des modèles .glb/.gltf, configurer l'éclairage avec des préréglages, paramétrer des matériaux PBR, créer des environnements avec ciel/brouillard/SSAO/SSR, placer des caméras et construire des GridMaps. Combinés aux outils de physique, de navigation et de particules, l'IA peut construire des scènes de jeu 3D complètes.
Oui. La suite d'analyse à l'exécution comprend 15 outils qui permettent à l'IA de lancer votre jeu, de simuler les entrées clavier/souris/action, de capturer des captures d'écran, d'inspecter l'arbre de scène en direct, de lire et modifier les propriétés à l'exécution, d'enregistrer et rejouer des sessions d'entrées, de trouver les éléments d'interface, de cliquer sur les boutons par leur texte et d'exécuter des scénarios de test automatisés avec assertions.
Oui. Godot MCP Pro fonctionne avec Cursor, VS Code + Cline, Windsurf, Claude Code CLI, Claude Desktop et tout autre client compatible MCP. Configurez le serveur MCP dans les paramètres de votre éditeur et il se connecte via WebSocket.
Godot 4.4 ou ultérieur (testé sur Godot 4.6) et Node.js 18+. Fonctionne sous Windows, macOS et Linux.
Godot MCP Pro offre 175 outils contre 13 à 32 dans les alternatives gratuites. Les fonctionnalités exclusives incluent l'annuler/rétablir complet, la gestion des signaux, la simulation d'entrées avec enregistrement/relecture, une suite d'analyse à l'exécution de 15 outils, la construction de scènes 3D, la configuration de la physique, les systèmes de particules, la gestion des bus audio, les outils de maillage de navigation, les machines à états AnimationTree, les tests automatisés et l'analyse de code.
Oui. Le plugin d'éditeur GDScript (addons/godot_mcp/) est entièrement open source et disponible sur GitHub. Vous pouvez inspecter précisément la manière dont le plugin communique avec l'éditeur avant l'achat. Le serveur MCP (TypeScript) est inclus dans le téléchargement payant.
Non. Godot MCP Pro est un achat unique de $15 avec des mises à jour à vie, des projets illimités, des machines illimitées et un support Discord. Aucun frais récurrent, aucune limite de sièges.
Soyez opérationnel en moins de 5 minutes.
Copiez le dossier addons/godot_mcp/ du téléchargement dans le répertoire racine de votre projet Godot. Activez ensuite le plugin :
Project > Project Settings > Plugins > Godot MCP Pro > Enable
Ouvrez un terminal dans le répertoire server/ :
cd server npm install npm run build
Ajoutez le serveur au fichier de configuration MCP de votre client IA (par ex. .mcp.json pour Claude Code) :
{
"mcpServers": {
"godot-mcp-pro": {
"command": "node",
"args": ["/path/to/server/build/index.js"]
}
}
}
Ouvrez votre projet Godot avec le plugin activé. Le panneau d'état dans le dock de l'éditeur indique l'état de la connexion. Démarrez votre assistant IA et commencez à créer — il a désormais un accès direct à 175 outils dans votre éditeur Godot.
Payez une fois, utilisez pour toujours. Mises à jour à vie incluses.