Configuration Codex CLI

Utilisez WEPPY Roblox AI Toolkit et Roblox MCP avec OpenAI Codex CLI, l’outil de codage IA en terminal.

Prérequis

• Node.js 18.0.0 ou supérieur.
• Codex CLI installé.
• Installation du plugin Roblox Studio terminée.

Installer Codex CLI

npm install -g @openai/codex

S’il est déjà installé, mettez-le à jour :

codex update

Méthode 1 : installer WEPPY Roblox AI Toolkit (recommandé)

Ajoutez le marketplace WEPPY depuis le terminal :

codex plugin marketplace add hope1026/weppy-roblox-mcp

Rouvrez Codex CLI, ouvrez la liste des plugins avec /plugins, sélectionnez WEPPY Roblox AI Toolkit, puis lancez Install plugin.

Le plugin ajoute npx -y @weppy/roblox-mcp@latest et les skills WEPPY. Utilisez @, /skills ou $ si vous voulez cibler un plugin ou une skill.

Méthode 2 : enregistrer seulement le serveur MCP

À utiliser uniquement si vous ne voulez pas les skills WEPPY.

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

Ou ajoutez ceci dans ~/.codex/config.toml :

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

Test de connexion

1. Lancez Roblox Studio → onglet Plugins → WEPPY → Connect.
2. Dans votre client IA, envoyez une demande simple :

   Tell me what is currently selected in Roblox Studio

3. Si l’agent répond avec l’élément sélectionné ou indique qu’aucun élément n’est sélectionné, la connexion MCP fonctionne.

Dépannage

Le serveur ne démarre pas

Lancez le serveur directement pour voir l’erreur :

npx -y @weppy/roblox-mcp@latest

Vérifiez ensuite Node.js 18 ou supérieur avec node --version.

Le plugin ne se connecte pas

• Confirmez que Roblox Studio est ouvert.
• Cliquez sur WEPPY puis Connect dans l’onglet Plugins.
• Vérifiez que localhost:3002 n’est pas bloqué.

Les outils MCP ne sont pas visibles

• Rechargez ou redémarrez l’application IA après avoir modifié la configuration.
• Vérifiez la syntaxe JSON/TOML du fichier de configuration.
• Assurez-vous que l’entrée s’appelle weppy-roblox-mcp.