Cómo usar WEPPY AI Agent Plugin y WEPPY MCP Server de WEPPY Roblox AI Toolkit 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
WEPPY Roblox Studio Plugin 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 AI Agent Plugin (recomendado)

Añade el marketplace del WEPPY AI Agent Plugin 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 AI Agent Plugin 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 WEPPY MCP Server 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 WEPPY AI Agent Plugin 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 WEPPY Roblox Studio Plugin esté en estado Connected
Verifica que el puerto 3002 no esté bloqueado por el firewall

Configuración de Codex CLI