Weppy Roblox MCP WEPPY

WEPPY

Configuração do Codex CLI

Como usar o WEPPY Roblox AI Toolkit e o Roblox MCP no Codex CLI.

Como usar o WEPPY Roblox AI Toolkit e o Roblox MCP no OpenAI Codex CLI (ferramenta de codificação com IA baseada em terminal).

Plugins do Codex podem agrupar skills, integrações de app e configurações de servidor MCP. O WEPPY é distribuído como plugin do Codex com a configuração do servidor MCP e skills para fluxos no Roblox Studio, por isso recomendamos instalar o plugin antes de configurar o MCP manualmente.

Pré-requisitos

  • Node.js (v18.0.0 ou superior)
  • Codex CLI instalado
  • Plugin do Roblox Studio instalado

Instalar o Codex CLI

npm install -g @openai/codex

Se já estiver instalado, atualize para a versão mais recente:

codex update

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

Adicione o marketplace do plugin WEPPY pelo terminal:

codex plugin marketplace add hope1026/weppy-roblox-mcp

Depois, reabra o Codex CLI e abra a lista de plugins:

codex
/plugins

Selecione WEPPY Roblox AI Toolkit no marketplace WEPPY adicionado e execute Install plugin.

Após a instalação, inicie uma nova conversa. O plugin adiciona a configuração MCP npx -y @weppy/roblox-mcp@latest junto com os skills do WEPPY. Se necessário, use @ em um prompt para selecionar um plugin ou skill incluído, ou use /skills ou $ para encontrar e chamar skills instalados.

Método 2: Registrar somente o servidor MCP manualmente

Use isto somente se quiser o servidor MCP sem os skills do WEPPY. Se você instalou o plugin pelo método 1, pode pular este passo.

Comando CLI

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

Editar arquivo de configuração diretamente

Adicione o seguinte ao arquivo ~/.codex/config.toml:

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

Localização do arquivo de configuração:

SOCaminho
macOS/Linux~/.codex/config.toml
Windows%USERPROFILE%\.codex\config.toml

Testar a Conexão

  1. Executar o Roblox Studio → Aba Plugins → WEPPY → Connect
  2. Executar o Codex CLI e digitar: 
    Diga-me o que está selecionado atualmente no Roblox Studio

Solução de Problemas

Quando o servidor não inicia

Execute o servidor MCP diretamente para verificar os erros:

npx -y @weppy/roblox-mcp@latest

O plugin WEPPY não aparece na lista

Atualize o marketplace e reinicie o Codex:

codex plugin marketplace upgrade hope1026-roblox-mcp

Falha na conexão

  • Confirmar se o plugin do Roblox Studio está no estado Connected
  • Verificar se a porta 3002 não está bloqueada pelo firewall