Configuration Claude Code

Utilisez Roblox MCP avec Claude Code, l’outil de codage IA en terminal.

Prérequis

• Claude Code installé.
• Installation du plugin Roblox Studio terminée.

Installation

npm install -g @anthropic-ai/claude-code

Enregistrer le serveur MCP

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

Exécutez ces commandes dans le terminal. Le toolkit ajoute la configuration MCP et les skills WEPPY pour les actions Studio, UI Studio, Playtest et Sync.

claude plugin marketplace add hope1026/weppy-roblox-mcp --scope user
claude plugin install weppy-roblox-ai-toolkit@hope1026-roblox-mcp --scope user

Vérifiez l’installation :

claude plugin list

Méthode 2 : modifier le fichier de configuration

Utilisez cette option si vous voulez seulement le serveur MCP sans les skills WEPPY. Créez un fichier .mcp.json :

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

Gestion automatique

Claude Code démarre le serveur MCP quand il en a besoin, l’arrête à la fin de la session et ne demande pas de configuration supplémentaire.

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.