Le serveur MCP de Roblox Studio est intégré à Roblox Studio. Il met en œuvre le Model Context Protocol (MCP), une norme ouverte qui permet aux outils IA de communiquer en toute sécurité avec des applications externes. Une fois connecté, votre client IA peut interagir directement avec votre session Studio ouverte, explorer le modèle de données, écrire des scripts, exécuter du code Luau et tester votre expérience en mode de jeu.
Ce guide vous montre comment connecter le serveur MCP de Studio à des clients IA populaires. Bien que la configuration varie selon le client, l'idée fondamentale reste la même : vous configurez votre client pour se connecter au serveur MCP, puis envoyez des commandes depuis le client vers votre session active de Studio.
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 IA en utilisant le transport stdio, qui utilise les flux d'entrée/sortie standard. Toutes les actions sont initiées par votre client IA, qui envoie ensuite une requête par ce canal pour effectuer des actions dans votre session Studio.
Le serveur fournit les outils suivants :
| Scripts | |
|---|---|
| script_read | Lit un script à partir 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 (Édition). |
| script_search | Recherche des scripts par nom en utilisant un appariement approximatif. Retourne jusqu'à 10 résultats. |
| script_grep | Recherche un modèle de chaîne à travers tous les scripts dans le jeu. Retourne 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é. Retourne 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 la fin d'un travail de génération de modèle procédural et retourne le statut final. |
| search_asset | Recherche des actifs à travers le Creator Store (marché public) et l'inventaire du créateur (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, retournant un chemin d'image à la carte d'ID d'actif. |
| store_image | Charge une image à partir d'un chemin de fichier local et retourne 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'enquête sur le code et les interrogations de l'état du jeu) et playtest (pour exécuter des scénarios de gameplay 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 | Retourne 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. Retourne soit le résultat, soit une erreur. Nécessite de spécifier un datamodel_type (Édition, Client ou Serveur). |
| Tests de jeu | |
| get_studio_state | Obtient l'état actuel de Studio, y compris l'état de jeu et les types de modèles de données disponibles. |
| start_stop_play | Commence ou arrête le test de jeu. |
| get_console_output | Récupère la sortie du journal de sortie de Studio. |
| screen_capture | Capture la vue de port actuel de Studio et retourne les données de l'image. Accepte optionnellement une position de caméra personnalisée et une cible de regard. |
| Simulation d'entrée du 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 du 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 d'UI spécifiques. |
| user_mouse_input | Envoie une ou plusieurs actions de souris dans l'ordre : déplacer, cliquer, bouton en bas/en haut, faire défiler ou attendre. 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 URL de documentation Roblox autorisées (référence API du moteur, docs du créateur, 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 d'appareils, et la recherche de documentation. |
| Gestion des sessions | |
| 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'outil 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 des paramètres affiche l'option de connexion rapide et des instructions de configuration pour différents clients. Lorsqu'un client se connecte avec succès, un indicateur vert affiche 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 n'importe quel client qui prend en charge le transport stdio. Après avoir ajouté la configuration, suivez la documentation de votre client pour compléter la configuration, puis redémarrez le client pour appliquer vos changements.
Les clients MCP peuvent lire et modifier le contenu de vos places Roblox ouvertes. Assurez-vous de ne connecter que des clients en qui vous avez 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 supportés installés sur votre ordinateur.
- Activez votre client choisi.
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 peut 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 :
Windows
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
macOS
{
"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 :
Windows
macOS
Utiliser 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 à une expérience spécifique ou à un objet qui n'existe que dans cette instance).
Vous pouvez manuellement changer 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.
Résolution des problèmes
Si le serveur ne s'affiche 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 parenthèse manquante peut empêcher le chargement de la configuration.