Install
Enable the Beckett EditorPlugin (writes .mcp.json)Pour qui
Vous faites des jeux GDScript ou C# dans l'éditeur Godot 4 et voulez que Claude ou Cursor inspecte, écrive, lance et voie la scène directement — sans pont Node ou Python, second processus ou nuage. Beckett est un EditorPlugin GDScript embarqué, zéro sidecar.
Le MIT Lite gratuit couvre la boucle complète inspect → author → run → SEE, 55 outils au total. Cette page ne nomme pas ces 55 outils ; n'inventez pas de noms d'arbre de scène ou de scripts.
Dépôt officiel seul sur une ligne :
https://github.com/beckettlab/beckett-godot-mcp
Premier essai en 3 minutes
Uniquement l'installation officielle en une étape : activer le greffon dans Godot 4. Une fois activé, le service démarre tout seul et écrit .mcp.json pour que claude ou Cursor se connectent sans réglage manuel. Node.js n'est pas requis.
Préalable : l'éditeur Godot 4 est là, et vous pouvez ouvrir un projet contenant cet addon. Rien d'autre à installer. À l'exécution, un TCPServer HTTP/JSON-RPC interroge sur le fil principal de l'éditeur.
Où configurer : l'interrupteur de greffon Godot, et le .mcp.json auto-généré du projet. N'écrivez pas à la main une configuration serveur qui combat le fichier auto. Si vous ne voulez pas l'autodémarrage, le texte officiel donne un opt-out : beckett/autostart=false.
Premier pas à bas risque : inspect d'abord — observer seulement, pas author ni run. Signal de succès : après activation le service tourne, .mcp.json apparaît, Claude ou Cursor peuvent se connecter. Cette page n'a pas de nom d'outil inspect concret ; n'en inventez pas.
Frontière de sécurité : écoute localhost seulement, avec contrôle Origin (contre DNS-rebind), un bearer token optionnel, et des verrous read-only / allowlist / confirm-destructive. Ne lisez pas localhost comme hors réseau ou sans lectures locales ; il ouvre quand même HTTP sur cette machine et lit/écrit le projet dans l'éditeur. readOnlyHint n'est pas un risque nul.
Avant de changer une scène ou de lancer le jeu, confirmez que destructive exige une confirmation. author et run changent le projet ou démarrent le jeu ; le texte officiel ne donne pas de commande d'annulation.
Cas d'usage
Cas 1 : d'abord inspecter le projet courant. Activez le greffon, laissez le client se connecter via .mcp.json, inspect seulement. Lesquels des 55 appartiennent à inspect ne sont pas nommés. GDScript et C# sont tous deux dans Lite.
Cas 2 : avant d'écrire ou de lancer, ouvrir le verrou de confirmation. La boucle officielle est inspect → author → run → SEE. author change le projet ; run joue dans l'éditeur. Il y a confirm-destructive et allowlist. Sans nom d'outil, n'appelez pas une écriture. Le texte officiel ne dit pas comment générer le bearer token optionnel.
Limites d'usage
Zéro sidecar n'est pas zéro HTTP local. Pas de nuage ni de second processus, mais liaison à localhost. .mcp.json s'écrit automatiquement ; beckett/autostart=false coupe l'autodémarrage. Les 55 outils ne sont pas nommés. Lite est l'édition MIT gratuite. Le texte officiel n'écrit ni numéro de port, ni mineure Godot, ni comment supprimer .mcp.json après désinstallation.