Comenzar

Para usar Roblox MCP necesitas dos componentes.

App de IA (Claude, Codex, Gemini, etc.)
       │
   Servidor MCP  ← Convierte los comandos de la IA a un formato que Roblox entiende
       │
Plugin de Roblox Studio  ← Ejecuta los comandos dentro de Studio

Cuando la app de IA dice “crea una parte azul”, el servidor MCP convierte esa solicitud y el plugin de Roblox Studio crea la parte en Studio.

Instalación en una línea (recomendado)

El siguiente comando instala el servidor MCP y el plugin en un solo paso.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex

Una vez finalizada la instalación, vuelve a abrir tu app de IA y reinicia Roblox Studio.

Si se produce un error durante la instalación, se mostrará la ruta al archivo de log temporal. En una ejecución interactiva puedes mantener la consola abierta antes de cerrarla para ver la causa del problema.

El registro automático de MCP es compatible con Claude Code, Claude Desktop, Cursor, Codex CLI / App, Gemini CLI y Antigravity.

Si la ejecución de PowerShell está bloqueada en Windows, procede con la instalación manual que se describe a continuación. Si usas el paquete ZIP, puedes ejecutar setup-plugin.bat y setup-mcp.bat.

Instalación manual

Procedimiento alternativo para cuando la instalación en una línea no funciona o no puedes usar la instalación automática en tu entorno.

Paso 1 — Instalar el plugin de Roblox Studio

Descarga el archivo del plugin desde GitHub y colócalo en la carpeta Plugins de Roblox Studio para instalarlo.

Paso 2 — Registrar el servidor MCP en tu app de IA

Elige la app de IA que usas y dirígete a su guía de configuración. Puedes usarlo con cualquier app de IA que soporte MCP.

Aunque tu app de IA no esté en la lista anterior, puedes usarla si soporta MCP. El comando del servidor MCP es npx -y @weppy/roblox-mcp.

Opcional — WEPPY Roblox Explorer (extensión de VSCode)

Puedes navegar el árbol de instancias sincronizadas junto con los iconos de clases de Roblox directamente en VSCode. Esta extensión requiere que primero completes la instalación de Roblox MCP descrita arriba, ya que Explorer lee los datos de Sync de weppy-project-sync bajo la raíz del proyecto.

Después de completar la instalación

1. Abre Roblox Studio y haz clic en WEPPY → Connect en la pestaña Plugins.

2. Prueba lo siguiente en tu app de IA:

   Crea una parte azul en Roblox Studio

3. Si la parte se crea correctamente, la instalación está completa.