Guía para reducir paso a paso los problemas de conexión, permisos, Sync y validación.
Cuando el plugin no se conecta
Síntoma: Se muestra “Connection failed” o el plugin aparece como no conectado en Roblox Studio.
- Verifica que el servidor MCP esté en ejecución:
npx -y @weppy/roblox-mcp@latest - Roblox Studio: pestaña Plugins → WEPPY → clic en Connect
- Verifica que no haya un firewall, antivirus o VPN que bloquee
localhost:3002 - Reinicia tanto Roblox Studio como el servidor MCP
Cuando el cliente de IA no reconoce el servidor MCP
- Verifica que se use el comando correcto en la configuración del cliente de IA:
npx -y @weppy/roblox-mcp@latest - Verifica que Node.js 18 o superior esté instalado:
node --version - En Windows, si se produce un error de permisos, intenta ejecutar el terminal como administrador
- Consulta la guía de instalación de la app de IA que usas
Aviso “Pro feature required”
Cuando solicitas una acción exclusiva de Pro desde Basic, si es posible se busca un método alternativo. Sin embargo, el flujo alternativo consume tokens adicionales y no siempre garantiza el mismo resultado.
Además, algunas herramientas exclusivas de Pro no tienen una alternativa y no se pueden usar desde Basic. Si este aviso aparece repetidamente, comprueba si la acción solicitada está disponible en tu plan actual.
Cuando Sync no funciona
- Verifica el estado de Sync: solicita a la IA
manage_sync status - Verifica que el plugin esté conectado antes de iniciar Sync
- Si el sync inverso (archivo → Studio) no funciona, verifica si el tier Pro está activado
- Verifica que la carpeta de sync local exista y tenga permisos de escritura
Para ver la configuración detallada de Sync, consulta Sync bidireccional.
Clientes de IA compatibles
| Cliente |
|---|
| Claude Code |
| Claude Desktop |
| Cursor |
| Codex CLI |
| Codex Desktop |
| Gemini CLI |
| Apps con soporte MCP |
Comando del servidor: npx -y @weppy/roblox-mcp@latest
Requisitos del sistema
| Ítem | Mínimo |
|---|---|
| Node.js | 18.0.0 o superior |
| Roblox Studio | Última versión (mantener actualizaciones automáticas) |
| Sistema operativo | Windows 10+ o macOS 12+ |
| Red | Debe poder acceder a localhost:3002 |
Mensajes de error frecuentes
| Error | Causa | Solución |
|---|---|---|
ECONNREFUSED localhost:3002 | Servidor MCP no ejecutándose | Ejecutar npx -y @weppy/roblox-mcp@latest |
Timeout waiting for plugin | Plugin de Studio no conectado | Hacer clic en Connect en el panel del plugin |
Forbidden path | Intento de acceso a CoreGui/CorePackages | Usar solo rutas de instancias válidas |
Place ID mismatch | Conectado al Place incorrecto | Reconectar desde la sesión correcta de Studio |
Si necesitas ayuda
Si el problema sigue sin resolverse, abre un GitHub Issue con la siguiente información:
- Sistema operativo y versión de Node.js
- Cliente de IA y su versión
- Mensaje de error o logs
- Pasos que ya has intentado
No incluyas license keys sin ocultar, recibos, emails, datos de pago ni información privada del proyecto en un issue público. Escribe a [email protected] si la consulta incluye compra, licencia, email, pago o información privada del proyecto.