Como usar o Roblox MCP no OpenAI Codex CLI (ferramenta de codificação com IA baseada em terminal).
Pré-requisitos
- Node.js (v18.0.0 ou superior)
- Plugin do Roblox Studio instalado
Instalação
npm install -g @openai/codex
Registrar o Servidor MCP
Método 1: Comando CLI (Recomendado)
codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
Método 2: 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"]
Localização do arquivo de configuração:
| SO | Caminho |
|---|---|
| macOS/Linux | ~/.codex/config.toml |
| Windows | %USERPROFILE%\.codex\config.toml |
Testar a Conexão
- Executar o Roblox Studio → Aba Plugins → WEPPY → Connect
- 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
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