Configuration Gemini CLI

Utilisez Roblox MCP avec Google Gemini CLI.

Prérequis

1. Node.js 18.0.0 ou supérieur.

   node --version

2. Gemini CLI installé.

   npm install -g @google/gemini-cli

3. Installation du plugin Roblox Studio terminée.

Enregistrer le serveur MCP

Méthode 1 : commande CLI (recommandé)

gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp@latest

--trust évite la confirmation à chaque appel d’outil.

Pour l’enregistrer comme réglage global, ajoutez -s user :

gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp@latest

Méthode 2 : modifier le fichier de configuration

Ajoutez ceci dans .gemini/settings.json :

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

Méthode 3 : variables d’environnement

gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -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.