Weppy Roblox MCP WEPPY

WEPPY

Codex App Setup

How to use the WEPPY Roblox AI Toolkit and Roblox MCP with the Codex App.

How to use the WEPPY Roblox AI Toolkit and Roblox MCP with OpenAI Codex App (macOS).

In Codex App, install plugins from the Plugins menu and find installed skills from the Skills menu or by invoking them in a prompt. The WEPPY plugin includes the MCP server config and Roblox Studio workflow skills, so installing the plugin first is recommended over manual MCP setup.

Prerequisites

  • Codex App installed (macOS)
  • The codex command available in your terminal (for adding the marketplace)
  • Roblox Studio plugin installation complete

If the codex command is not available, install Codex CLI:

npm install -g @openai/codex

Add the WEPPY plugin marketplace from your terminal:

codex plugin marketplace add hope1026/weppy-roblox-mcp

Then reopen Codex App, select the added WEPPY marketplace from the Plugins menu, and install WEPPY Roblox AI Toolkit. In the app, use the plus button or Add to Codex to install it.

After installation, start a new conversation. The plugin adds the npx -y @weppy/roblox-mcp@latest MCP server config together with WEPPY skills.

Check and Use Skills

After installation, you can find WEPPY skills in the Codex App Skills menu.

  • WEPPY Roblox MCP Guide: direct Studio control, UI Studio, playtest, and log checks
  • WEPPY Roblox Sync Guide: Studio-local sync, sync direction, conflict handling, and Roblox Explorer context

Use @ in a prompt to target a plugin or bundled skill, or use $ to call a specific skill. Even if you do not target one manually, Codex can use a skill automatically when your task matches its description.

Method 2: Register Only the MCP Server Manually

Use this only if you want the MCP server without WEPPY skills. In the app, open Settings (Cmd + ,) → Integrations & MCP, then add a custom MCP server. If you installed the plugin with Method 1, you can skip this step.

Server name: weppy-roblox-mcp
Command: npx -y @weppy/roblox-mcp@latest

Codex App, Codex CLI, and IDE extensions use the same ~/.codex/config.toml MCP settings.

Connection Test

  1. Launch Roblox Studio → Plugins tab → WEPPY → Connect
  2. Start a new conversation in Codex App and test: 
    Tell me what is currently selected in Roblox Studio

Troubleshooting

Server Won’t Start

Run the MCP server directly to see the error:

npx -y @weppy/roblox-mcp@latest

WEPPY Plugin Does Not Appear in the Plugins Menu

Refresh the marketplace, then restart Codex App:

codex plugin marketplace upgrade hope1026-roblox-mcp

Connection Fails

  • Confirm the Roblox Studio plugin shows Connected status
  • Check that port 3002 is not blocked by a firewall