El servidor MCP de Roblox Studio está integrado en Roblox Studio. Implementa el Protocolo de Contexto de Modelo (MCP), un estándar abierto que permite a las herramientas de IA comunicarse de manera segura con aplicaciones externas. Una vez conectado, tu cliente de IA puede interactuar directamente con tu sesión de Studio abierta, explorando el modelo de datos, escribiendo scripts, ejecutando código Luau y probando tu juego en modo de juego.
Esta guía te muestra cómo conectar el servidor MCP de Studio a clientes de IA populares. Aunque la configuración varía según el cliente, la idea principal es la misma: configuras tu cliente para conectarse al servidor MCP y luego envías comandos desde el cliente a tu sesión activa de Studio.
Requisitos previos
Antes de poder conectarte al servidor, asegúrate de tener la última versión de Roblox Studio y tu cliente MCP preferido instalado en tu computadora.
Cómo funciona el servidor MCP de Studio
El servidor se ejecuta como un proceso local en tu máquina y se comunica con el cliente de IA utilizando transporte stdio, que utiliza flujos de entrada/salida estándar. Todas las acciones se inician a través de tu cliente de IA, que luego envía una solicitud a través de este canal para realizar acciones dentro de tu sesión de Studio.
El servidor proporciona las siguientes herramientas:
| Scripts | |
|---|---|
| script_read | Lee un script del juego utilizando rutas de notación de puntos (por ejemplo, game.ServerScriptService.MyScript). Soporta la lectura de scripts completos o rangos de líneas específicos. |
| multi_edit | Aplica múltiples ediciones a un script en una sola operación. Si la ruta de destino no existe, crea un nuevo script. Requiere especificar un datamodel_type (Edit). |
| script_search | Busca scripts por nombre utilizando coincidencias difusas. Devuelve hasta 10 resultados. |
| script_grep | Busca un patrón de cadena en todos los scripts del juego. Devuelve hasta 50 coincidencias. |
| Generación de activos y contenido | |
| generate_mesh | Genera una malla 3D texturizada a partir de un aviso de texto utilizando IA. |
| generate_material | Genera una variante de material personalizada. Devuelve el material base y el nombre de la variante de material para aplicar a las partes. |
| generate_procedural_model | Crea objetos 3D construidos a partir de partes primitivas (bloques, esferas, cilindros, cuñas) como un ProceduralModel con atributos configurables. Soporta imágenes de referencia y esquemas de partes personalizados. |
| wait_job_finished | Espera a que termine un trabajo de generación de modelo procedural y devuelve el estado final. |
| search_asset | Busca activos en la Tienda de Creadores (mercado público) y en el Inventario de Creadores (usuario, grupo o universo). Soporta filtrado por tipo de activo, precio, etiquetas y alcance. |
| insert_asset | Inserta un activo en el juego por su ID numérico de activo de Roblox. Soporta modelos, mallas, imágenes, audio, video, animaciones y paquetes. |
| upload_image | Sube un lote de imágenes desde URLs HTTP al servidor de activos de Roblox, devolviendo un mapa de ruta de imagen a ID de activo. |
| store_image | Carga una imagen desde una ruta de archivo local y devuelve un URI de imagen que puede ser pasado a otras herramientas (por ejemplo, como una imagen de referencia para generate_procedural_model). |
| Exploración del modelo de datos | |
| subagent | Lanza un subagente especializado para manejar tareas complejas y de múltiples pasos de manera autónoma. Los tipos disponibles incluyen explore (para investigación de código y consultas de estado del juego) y playtest (para ejecutar escenarios de juego y verificar resultados). |
| search_game_tree | Explora la jerarquía de instancias como un array JSON plano. Soporta filtrado por ruta, tipo de instancia y palabras clave, con limitación de profundidad configurable. |
| inspect_instance | Devuelve información detallada sobre una instancia específica, incluyendo todas las propiedades legibles, atributos personalizados y un resumen de sus hijos y descendientes. |
| Ejecución de Luau | |
| execute_luau | Ejecuta código Luau en Studio. Devuelve el resultado o un error. Requiere especificar un datamodel_type (Edit, Client o Server). |
| Pruebas de juego | |
| get_studio_state | Obtiene el estado actual de Studio, incluyendo el estado de juego y los tipos de datamodel disponibles. |
| start_stop_play | Inicia o detiene las pruebas de juego. |
| get_console_output | Recupera la salida del registro de salida de Studio. |
| screen_capture | Captura la vista actual de Studio y devuelve los datos de la imagen. Opcionalmente acepta una posición de cámara personalizada y un objetivo de mirada. |
| Simulación de entrada del jugador | |
| character_navigation | Mueve el personaje del jugador a una posición o ruta de instancia dada. Soporta un multiplicador de velocidad configurable. |
| user_keyboard_input | Envía una o más acciones de teclado en orden: tecla abajo, tecla arriba, pulsación de tecla, entrada de texto o espera. Soporta la selección de instancias de UI específicas. |
| user_mouse_input | Envía una o más acciones de mouse en orden: mover, hacer clic, botón abajo/arriba, desplazamiento o espera. Soporta la selección de instancias específicas o coordenadas de pantalla. |
| Documentación y habilidades | |
| http_get | Obtiene contenido de URLs de documentación de Roblox permitidas (referencia de API del motor, documentación de creadores, API de nube, guías de optimización de rendimiento). Soporta búsqueda por palabras clave dentro del contenido obtenido. |
| skill | Recupera conocimiento detallado, mejores prácticas o material de referencia para habilidades específicas como depuración, simulación de dispositivos y búsqueda de documentación. |
| Gestión de sesiones | |
| list_roblox_studios | Lista todas las instancias de Studio conectadas, incluyendo su nombre, ID de instancia de Studio y ID de lugar. Los lugares locales que no tienen un ID de lugar se listan solo por nombre. Útil cuando hay múltiples ventanas de Studio abiertas; si dos instancias de Studio abiertas comparten el mismo nombre, el ID de lugar te permite diferenciarlas. |
Cada llamada a la herramienta toma un parámetro studio_id que nombra la instancia de Studio a la que se dirige, por lo que los agentes abordan las instancias de Studio de manera explícita en lugar de depender del estado de la sesión. Usa list_roblox_studios para buscar el ID de la instancia que deseas.
Habilitar el servidor MCP en Studio
Para habilitar el servidor MCP en Studio:
- Abre Assistant.
- Haz clic en … ⟩ Gestionar servidores MCP.
- Activa Habilitar Studio como servidor MCP.
Una vez habilitado, el panel de configuración muestra la opción de conexión rápida e instrucciones de configuración para diferentes clientes. Cuando un cliente se conecta con éxito, un indicador verde muestra el número de clientes conectados.
Conectar tu cliente
Puedes conectar tu cliente al servidor MCP de Studio utilizando conexión rápida, una configuración JSON o un comando CLI.
- Usa conexión rápida si tu cliente es compatible.
- Si no, usa una configuración JSON si tu cliente soporta archivos de configuración MCP.
- De lo contrario, usa un comando CLI.
El servidor MCP de Studio funciona con cualquier cliente que soporte transporte stdio. Después de agregar la configuración, sigue la documentación de tu cliente para completar la configuración, luego reinicia el cliente para aplicar tus cambios.
Los clientes MCP pueden leer y modificar contenido en tus lugares abiertos de Roblox. Asegúrate de conectar solo clientes en los que confíes.
Conexión rápida
La conexión rápida soporta los siguientes clientes:
- Antigravity
- Codex CLI
- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Visual Studio Code
Para conectarte usando conexión rápida:
- Ve a Configuraciones de Assistant ⟩ Servidores MCP.
- Expande el menú desplegable Conexión rápida para ver los clientes soportados instalados en tu computadora.
- Activa tu cliente elegido.
Si el cliente que deseas no aparece en la lista de Conexión rápida, instálalo y reinicia Roblox Studio.
Configuración JSON
La mayoría de los clientes MCP soportan archivos de configuración JSON. Los siguientes ejemplos muestran configuraciones completas que puedes usar.
Si Roblox Studio es tu único servidor MCP, usa estas configuraciones tal como están. Si estás usando múltiples servidores MCP, copia la entrada Roblox_Studio y añádela a tu diccionario mcpServers existente.
Tu archivo mcp.json podría ya contener otras entradas. Al agregar la configuración Roblox_Studio, asegúrate de que cada entrada esté separada por una coma. Las comas faltantes resultarán en JSON inválido y evitarán que la configuración se cargue.
Las configuraciones varían según el sistema operativo:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}Comando CLI
Algunos clientes MCP requieren un comando CLI en lugar de una configuración JSON. Usa el comando apropiado para tu sistema operativo:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat/Applications/RobloxStudio.app/Contents/MacOS/StudioMCPUsar múltiples instancias de Studio
Puedes conectar un solo cliente MCP a múltiples instancias de Studio en ejecución al mismo tiempo. Cada llamada a la herramienta incluye un studio_id que identifica la instancia de Studio a la que se dirige, lo que hace que los flujos de trabajo con múltiples instancias de Studio y múltiples agentes o clientes sean confiables.
Usa list_roblox_studios para listar las instancias conectadas con sus nombres, IDs de instancia de Studio y IDs de lugar. Luego pasa el ID de la instancia que deseas como studio_id en llamadas posteriores.
Verifica tu conexión
Después de configurar tu cliente, verifica que la conexión esté funcionando en Roblox Studio:
- Abre Assistant.
- Haz clic en … ⟩ Gestionar servidores MCP.
- Bajo Habilitar Studio como servidor MCP, verifica el indicador verde para confirmar que el cliente se ha conectado con éxito.
Solución de problemas
Si el servidor no aparece, o las herramientas no están disponibles:
- Reinicia tanto Roblox Studio como tu cliente MCP.
- Verifica que el comando o la ruta del binario sea correcta y que el archivo exista.
- Revisa tu sintaxis JSON. Incluso una coma o un corchete faltante pueden evitar que la configuración se cargue.