Le serveur MCP de Roblox Studio est intégré à Roblox Studio. Il implémente le Model Context Protocol (MCP), une norme ouverte qui permet aux outils AI de communiquer en toute sécurité avec des applications externes. Une fois connecté, votre client AI peut interagir directement avec votre session Studio ouverte, explorant le modèle de données, écrivant des scripts, exécutant du code Luau et testant votre jeu en mode de jeu.
Ce guide vous montre comment connecter le serveur MCP de Studio à des clients AI populaires. Bien que la configuration varie selon le client, l'idée principale reste la même : vous configurez votre client pour se connecter au serveur MCP, puis envoyez des commandes du client à votre session Studio active.
Prérequis
Avant de pouvoir vous connecter au serveur, assurez-vous d'avoir la dernière version de Roblox Studio et votre client MCP préféré installé sur votre ordinateur.
Comment fonctionne le serveur MCP de Studio
Le serveur fonctionne comme un processus local sur votre machine et communique avec le client AI en utilisant le transport stdio, qui utilise des flux d'entrée/sortie standard. Toutes les actions sont initiées par votre client AI, qui envoie ensuite une demande par ce canal pour effectuer des actions dans votre session Studio.
Le serveur fournit les outils suivants :
| Scripts | |
|---|---|
| script_read | Lit un script du jeu en utilisant des chemins en notation pointée (par exemple, game.ServerScriptService.MyScript). Prend en charge la lecture de scripts entiers ou de plages de lignes spécifiques. |
| multi_edit | Applique plusieurs modifications à un script en une seule opération. Si le chemin cible n'existe pas, il crée un nouveau script. Nécessite de spécifier un datamodel_type (Edit). |
| script_search | Recherche des scripts par nom en utilisant une correspondance floue. Renvoie jusqu'à 10 résultats. |
| script_grep | Recherche un motif de chaîne dans tous les scripts du jeu. Renvoie jusqu'à 50 correspondances. |
| Génération d'actifs et de contenu | |
| generate_mesh | Génère un maillage 3D texturé à partir d'une invite textuelle en utilisant l'IA. |
| generate_material | Génère une variante de matériau personnalisée. Renvoie le matériau de base et le nom de la variante de matériau à appliquer aux pièces. |
| generate_procedural_model | Crée des objets 3D construits à partir de pièces primitives (blocs, sphères, cylindres, coins) en tant que ProceduralModel avec des attributs configurables. Prend en charge les images de référence et les schémas de pièces personnalisés. |
| wait_job_finished | Attend qu'un travail de génération de modèle procédural se termine et renvoie le statut final. |
| search_asset | Recherche des actifs dans le Creator Store (marché public) et l'inventaire des créateurs (utilisateur, groupe ou univers). Prend en charge le filtrage par type d'actif, prix, étiquettes et portée. |
| insert_asset | Insère un actif dans le jeu par son ID d'actif numérique Roblox. Prend en charge les modèles, maillages, images, audio, vidéo, animations et packages. |
| upload_image | Télécharge un lot d'images à partir d'URLs HTTP vers le serveur d'actifs Roblox, renvoyant une carte de chemin d'image à ID d'actif. |
| store_image | Charge une image à partir d'un chemin de fichier local et renvoie un URI d'image qui peut être passé à d'autres outils (par exemple, comme image de référence pour generate_procedural_model). |
| Exploration du modèle de données | |
| subagent | Lance un sous-agent spécialisé pour gérer des tâches complexes et multi-étapes de manière autonome. Les types disponibles incluent explore (pour l'investigation du code et les requêtes d'état de jeu) et playtest (pour exécuter des scénarios de jeu et vérifier les résultats). |
| search_game_tree | Explore la hiérarchie des instances sous forme de tableau JSON plat. Prend en charge le filtrage par chemin, type d'instance et mots-clés, avec une limitation de profondeur configurable. |
| inspect_instance | Renvoie des informations détaillées sur une instance spécifique, y compris toutes les propriétés lisibles, les attributs personnalisés et un résumé de ses enfants et descendants. |
| Exécution Luau | |
| execute_luau | Exécute du code Luau dans Studio. Renvoie soit le résultat, soit une erreur. Nécessite de spécifier un datamodel_type (Edit, Client ou Server). |
| Tests de jeu | |
| get_studio_state | Obtient l'état actuel de Studio, y compris l'état de jeu et les types de datamodel disponibles. |
| start_stop_play | Démarre ou arrête les tests de jeu. |
| get_console_output | Récupère la sortie du journal de sortie de Studio. |
| screen_capture | Capture le viewport actuel de Studio et renvoie les données de l'image. Accepte éventuellement une position de caméra personnalisée et une cible de regard. |
| Simulation d'entrée joueur | |
| character_navigation | Déplace le personnage du joueur vers une position ou un chemin d'instance donné. Prend en charge un multiplicateur de vitesse configurable. |
| user_keyboard_input | Envoie une ou plusieurs actions de clavier dans l'ordre : touche enfoncée, touche relâchée, pression de touche, saisie de texte ou attente. Prend en charge le ciblage d'instances UI spécifiques. |
| user_mouse_input | Envoie une ou plusieurs actions de souris dans l'ordre : mouvement, clic, bouton enfoncé/relâché, défilement ou attente. Prend en charge le ciblage d'instances spécifiques ou de coordonnées d'écran. |
| Documentation et compétences | |
| http_get | Récupère du contenu à partir des URLs de documentation Roblox autorisées (référence API Engine, docs créateurs, API Cloud, guides d'optimisation des performances). Prend en charge la recherche par mots-clés dans le contenu récupéré. |
| skill | Récupère des connaissances détaillées, des meilleures pratiques ou du matériel de référence pour des compétences spécifiques telles que le débogage, la simulation de dispositifs et la recherche de documentation. |
| Gestion de session | |
| list_roblox_studios | Liste toutes les instances de Studio connectées, y compris leur nom, ID et statut actif. Cela est utile lorsque plusieurs fenêtres de Studio sont ouvertes. |
| set_active_studio | Définit une instance de Studio comme active afin que tous les appels d'outils suivants ciblent cette instance. |
Activer le serveur MCP dans Studio
Pour activer le serveur MCP dans Studio :
- Ouvrez Assistant.
- Cliquez sur … ⟩ Gérer les serveurs MCP.
- Activez Activer Studio en tant que serveur MCP.
Une fois activé, le panneau de paramètres affiche l'option de connexion rapide et les instructions de configuration pour différents clients. Lorsqu'un client se connecte avec succès, un indicateur vert montre le nombre de clients connectés.
Connectez votre client
Vous pouvez connecter votre client au serveur MCP de Studio en utilisant la connexion rapide, une configuration JSON ou une commande CLI.
- Utilisez connexion rapide si votre client est pris en charge.
- Sinon, utilisez une configuration JSON si votre client prend en charge les fichiers de configuration MCP.
- Sinon, utilisez une commande CLI.
Le serveur MCP de Studio fonctionne avec tout client qui prend en charge le transport stdio. Après avoir ajouté la configuration, suivez la documentation de votre client pour terminer la configuration, puis redémarrez le client pour appliquer vos modifications.
Les clients MCP peuvent lire et modifier le contenu de vos lieux Roblox ouverts. Assurez-vous de ne connecter que des clients de confiance.
Connexion rapide
La connexion rapide prend en charge les clients suivants :
- Antigravity
- Codex CLI
- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Visual Studio Code
Pour vous connecter en utilisant la connexion rapide :
- Allez dans Paramètres de l'Assistant ⟩ Serveurs MCP.
- Développez le menu déroulant Connexion rapide pour voir les clients pris en charge installés sur votre ordinateur.
- Activez le client de votre choix.
Si le client que vous souhaitez n'apparaît pas dans la liste Connexion rapide, installez-le et redémarrez Roblox Studio.
Configuration JSON
La plupart des clients MCP prennent en charge les fichiers de configuration JSON. Les exemples suivants montrent des configurations complètes que vous pouvez utiliser.
Si Roblox Studio est votre seul serveur MCP, utilisez ces configurations telles quelles. Si vous utilisez plusieurs serveurs MCP, copiez l'entrée Roblox_Studio et ajoutez-la à votre dictionnaire mcpServers existant.
Votre fichier mcp.json pourrait déjà contenir d'autres entrées. Lorsque vous ajoutez la configuration Roblox_Studio, assurez-vous que chaque entrée est séparée par une virgule. Les virgules manquantes entraîneront un JSON invalide et empêcheront le chargement de la configuration.
Les configurations varient selon le système d'exploitation :
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}Commande CLI
Certains clients MCP nécessitent une commande CLI au lieu d'une configuration JSON. Utilisez la commande appropriée pour votre système d'exploitation :
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat/Applications/RobloxStudio.app/Contents/MacOS/StudioMCPUtiliser plusieurs instances de Studio
Vous pouvez connecter un seul client MCP à plusieurs instances de Studio en cours d'exécution en même temps. Le serveur détermine automatiquement quelle instance utiliser en fonction du contexte (par exemple, si vous faites référence à un jeu spécifique ou à un objet qui n'existe que dans cette instance).
Vous pouvez changer manuellement d'instance en utilisant list_roblox_studios et set_active_studio.
Vérifiez votre connexion
Après avoir configuré votre client, vérifiez que la connexion fonctionne dans Roblox Studio :
- Ouvrez Assistant.
- Cliquez sur … ⟩ Gérer les serveurs MCP.
- Sous Activer Studio en tant que serveur MCP, vérifiez l'indicateur vert pour confirmer que le client s'est connecté avec succès.
Dépannage
Si le serveur n'apparaît pas, ou si les outils ne sont pas disponibles :
- Redémarrez à la fois Roblox Studio et votre client MCP.
- Vérifiez que la commande ou le chemin binaire est correct et que le fichier existe.
- Vérifiez votre syntaxe JSON. Même une virgule ou une accolade manquante peut empêcher le chargement de la configuration.