El servidor MCP de Roblox Studio está integrado en Roblox Studio. Implementa el Protocolo de Contexto de Modelos (MCP), un estándar abierto que permite a las herramientas de IA comunicarse de forma 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 experiencia en modo de juego.
Esta guía te muestra cómo conectar el servidor MCP de Studio a clientes de IA populares. Si bien 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 usa flujos de entrada/salida estándar. Todas las acciones son iniciadas 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 leer 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 (Editar). |
| 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 primarias (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 filtros por tipo de activo, precio, etiquetas y alcance. |
| insert_asset | Inserta un activo en el juego mediante su ID de activo numérico 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 se puede pasar a otras herramientas (por ejemplo, como 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 forma autónoma. Los tipos disponibles incluyen explore (para investigación de código y consultas sobre el estado del juego) y playtest (para ejecutar escenarios de juego y verificar resultados). |
| search_game_tree | Explora la jerarquía de instancias como un arreglo JSON plano. Soporta filtrado por ruta, tipo de instancia y palabras clave, con un límite 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 (Editar, Cliente o Servidor). |
| 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 imagen. Opcionalmente acepta una posición de cámara personalizada y un objetivo de vista. |
| Simulación de entrada de 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 del teclado en orden: tecla abajo, tecla arriba, pulsación de tecla, entrada de texto o espera. Soporta la selección de instancias específicas de UI. |
| user_mouse_input | Envía una o más acciones del mouse en orden: mover, hacer clic, botón abajo/arriba, desplazamiento o esperar. Soporta la selección de instancias específicas o coordenadas de pantalla. |
| Documentación y habilidades | |
| http_get | Recupera contenido de URLs de documentación permitidas de Roblox (referencia de API del motor, documentación para creadores, API de la nube, guías de optimización de rendimiento). Soporta la búsqueda por palabras clave dentro del contenido recuperado. |
| 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 en la documentación. |
| Gestión de sesiones | |
| list_roblox_studios | Lista todas las instancias de Studio conectadas, incluyendo su nombre, ID y estado activo. Esto es útil cuando hay múltiples ventanas de Studio abiertas. |
| set_active_studio | Establece una instancia de Studio como activa para que todas las llamadas a herramientas posteriores apunten a esa instancia. |
Habilitar el servidor MCP en Studio
Para habilitar el servidor MCP en Studio:
- Abre Asistente.
- 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.
Conecta 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, utiliza una configuración JSON si tu cliente admite archivos de configuración MCP.
- De lo contrario, utiliza 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 los cambios.
Los clientes MCP pueden leer y modificar contenido en tus lugares de Roblox abiertos. Asegúrate de conectar solo a 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 del Asistente ⟩ Servidores MCP.
- Expande el menú desplegable Conexión rápida para ver los clientes soportados instalados en tu computadora.
- Activa el cliente que elegiste.
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 admiten archivos de configuración JSON. Los siguientes ejemplos muestran configuraciones completas que puedes utilizar.
Si Roblox Studio es tu único servidor MCP, usa estas configuraciones tal cual. Si estás utilizando múltiples servidores MCP, copia la entrada Roblox_Studio y añádela a tu diccionario existente mcpServers.
Tu archivo mcp.json podría ya contener otras entradas. Al agregar la configuración de Roblox_Studio, asegúrate de que cada entrada esté separada por una coma. Las comas faltantes resultarán en un JSON inválido y evitarán que la configuración se cargue.
Las configuraciones varían según el sistema operativo:
Windows
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
macOS
{
"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:
Windows
macOS
Usar múltiples instancias de Studio
Puedes conectar un solo cliente MCP a múltiples instancias en ejecución de Studio al mismo tiempo. El servidor determina automáticamente qué instancia usar según el contexto (por ejemplo, si haces referencia a una experiencia específica o a un objeto que existe solo en esa instancia).
Puedes cambiar manualmente entre instancias utilizando list_roblox_studios y set_active_studio.
Verifica tu conexión
Después de configurar tu cliente, verifica que la conexión esté funcionando en Roblox Studio:
- Abre Asistente.
- 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.
Resolució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 la ruta del comando o binario sea correcta y que el archivo exista.
- Verifica tu sintaxis JSON. Incluso una coma o corchete faltante puede evitar que la configuración se cargue.