Weppy Roblox MCP WEPPY

WEPPY

Configuração do Codex App

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

Como usar o WEPPY Roblox AI Toolkit e o Roblox MCP no OpenAI Codex App (macOS).

No Codex App, instale plugins pelo menu Plugins e veja os skills instalados no menu Skills ou chamando-os em um prompt. O plugin do WEPPY inclui a configuração do servidor MCP e skills para fluxos de trabalho no Roblox Studio, por isso recomendamos instalar o plugin antes de configurar o MCP manualmente.

Pré-requisitos

  • Codex App instalado (macOS)
  • Comando codex disponível no terminal (para adicionar o marketplace)
  • Plugin do Roblox Studio instalado

Se o comando codex não estiver disponível, instale o Codex CLI:

npm install -g @openai/codex

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 App, selecione o marketplace WEPPY adicionado no menu Plugins e instale WEPPY Roblox AI Toolkit. No app, use o botão de mais ou Add to Codex para instalar.

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.

Ver e usar Skills

Após instalar, você pode ver os skills do WEPPY no menu Skills do Codex App.

  • WEPPY Roblox MCP Guide: controle direto do Studio, UI Studio, playtest e verificação de logs
  • WEPPY Roblox Sync Guide: Studio-local sync, direção de sync, tratamento de conflitos e contexto do Roblox Explorer

Use @ em um prompt para selecionar diretamente um plugin ou skill incluído, ou use $ para chamar um skill específico. Mesmo sem selecionar manualmente, o Codex pode usar um skill automaticamente quando a tarefa combina com a descrição dele.

Método 2: Registrar somente o servidor MCP manualmente

Use isto somente se quiser o servidor MCP sem os skills do WEPPY. No app, abra Settings (Cmd + ,) → Integrations & MCP e adicione um servidor MCP personalizado. Se você instalou o plugin pelo método 1, pode pular este passo.

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

Codex App, Codex CLI e extensões de IDE usam a mesma configuração MCP em ~/.codex/config.toml.

Testar a Conexão

  1. Executar o Roblox Studio → Aba Plugins → WEPPY → Connect
  2. Iniciar uma nova conversa no Codex App e testar: 
    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 no menu Plugins

Atualize o marketplace e reinicie o Codex App:

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