WEPPY

Configuration Cursor

Comment utiliser Roblox MCP avec Cursor.

Utilisez Roblox MCP avec Cursor.

Prérequis

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

Enregistrer le serveur MCP

Méthode 1 : configuration de projet

Ajoutez ceci dans .cursor/mcp.json de votre projet :

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

Méthode 2 : configuration globale

Ajoutez le même contenu dans le fichier MCP global de Cursor.

PortéeChemin
Projet<project>/.cursor/mcp.json
Global macOS/Linux~/.cursor/mcp.json
Global Windows%USERPROFILE%\.cursor\mcp.json

Si le fichier existe déjà, fusionnez uniquement l’entrée weppy-roblox-mcp dans l’objet mcpServers existant.

Appliquer les changements

Rechargez la fenêtre Cursor ou redémarrez l’application après modification.

Test de connexion

  1. Lancez Roblox Studio → onglet Plugins → WEPPYConnect.
  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.