Cómo usar WEPPY Roblox AI Toolkit y Roblox MCP desde OpenAI Codex CLI (herramienta de codificación con IA basada en terminal).

Los plugins de Codex pueden agrupar skills, integraciones de app y configuración de servidores MCP. WEPPY se distribuye como plugin de Codex con la configuración del servidor MCP y skills para flujos de Roblox Studio, así que recomendamos instalar primero el plugin antes de configurar MCP manualmente.

Requisitos previos

Node.js (v18.0.0 o superior)
Codex CLI instalado
Plugin de Roblox Studio instalado

Instalar Codex CLI

npm install -g @openai/codex

Si ya está instalado, actualízalo a la última versión:

codex update

Método 1: Instalar WEPPY Roblox AI Toolkit (recomendado)

Añade el marketplace del plugin de WEPPY desde la terminal:

codex plugin marketplace add hope1026/weppy-roblox-mcp

Después, vuelve a abrir Codex CLI y abre la lista de plugins:

codex
/plugins

Selecciona WEPPY Roblox AI Toolkit desde el marketplace de WEPPY agregado y ejecuta Install plugin.

Cuando termine la instalación, inicia una nueva conversación. El plugin añade la configuración MCP npx -y @weppy/roblox-mcp@latest junto con los skills de WEPPY. Si lo necesitas, usa @ en un prompt para seleccionar un plugin o skill incluido, o usa /skills o $ para buscar e invocar skills instalados.

Método 2: Registrar solo el servidor MCP manualmente

Usa esto solo si quieres el servidor MCP sin los skills de WEPPY. Si instalaste el plugin con el método 1, puedes omitir este paso.

Comando CLI

codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp@latest

Editar el archivo de configuración directamente

Añade el siguiente contenido al archivo ~/.codex/config.toml:

[mcp_servers.weppy-roblox-mcp]
command = "npx"
args = ["-y", "@weppy/roblox-mcp@latest"]

Ubicación del archivo de configuración:

SO	Ruta
macOS/Linux	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`

Probar la conexión

Ejecuta Roblox Studio → pestaña Plugins → WEPPY → Connect

Ejecuta Codex CLI y escribe lo siguiente:

Dime qué está seleccionado actualmente en Roblox Studio

Solución de problemas

El servidor no arranca

Ejecuta el servidor MCP directamente para ver el error:

npx -y @weppy/roblox-mcp@latest

El plugin de WEPPY no aparece en la lista

Actualiza el marketplace y reinicia Codex:

codex plugin marketplace upgrade hope1026-roblox-mcp

Fallo de conexión

Verifica que el plugin de Roblox Studio esté en estado Connected
Verifica que el puerto 3002 no esté bloqueado por el firewall

Configuración de Codex CLI