@weppy/roblox-mcp 2.5.1 → 2.6.1

package/docs/es/dashboard/settings.md

@@ -1,60 +0,0 @@
-# Settings
-
-> Consulta y gestiona la informacion de licencia, la configuracion del servidor y el idioma.
-
-## Descripcion general
-
-En la pagina Settings puedes consultar la informacion de licencia y la configuracion del servidor, y modificar algunos parametros. Es accesible siempre que el dashboard este en estado **Servidor conectado** o **Studio conectado**.
-
-## License (solo lectura)
-
-Muestra el estado actual de la licencia:
-
-| Campo | Descripcion |
-|-------|-------------|
-| Status | Indicador de estado (Active/Inactive) |
-| Tier | Tier actual (Basic/Pro) |
-| License Key | Clave de licencia enmascarada |
-| Provider | Informacion del proveedor de licencia |
-
-## General
-
-| Configuracion | Descripcion |
-|---------------|-------------|
-| Log Level | Nivel de salida de logs |
-| History Recording | Si se guarda el historial de ejecucion de herramientas |
-| Stats Collection | Si se recopilan estadisticas de herramientas |
-| Request Timeout | Tiempo de espera de solicitudes (segundos) |
-
-## Server Environment (solo lectura)
-
-Muestra la configuracion del servidor establecida mediante variables de entorno:
-
-| Variable de entorno | Descripcion | Valor predeterminado |
-|---------------------|-------------|----------------------|
-| `HTTP_PORT` | Puerto HTTP | 3002 |
-| `HTTP_HOST` | Host HTTP | 127.0.0.1 |
-| `DASHBOARD_AUTO_OPEN` | Apertura automatica del dashboard | true |
-
-## Language
-
-Cambia el idioma de la interfaz del Dashboard. Soporta 6 idiomas + Auto (deteccion automatica del idioma del navegador).
-
-| Opcion | Idioma |
-|--------|--------|
-| Auto | Deteccion automatica del idioma del navegador |
-| English | Ingles |
-| 한국어 | Coreano |
-| 日本語 | Japones |
-| Español | Espanol |
-| Português | Portugues |
-| Bahasa Indonesia | Indonesio |
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)

package/docs/es/dashboard/sync.md

@@ -1,68 +0,0 @@
-# Sync
-
-> Monitorea el estado actual, la configuracion de direccion y los logs de la sincronizacion Studio <-> archivos locales.
-
-![Sync — estado de sincronizacion, configuracion de direccion, logs](../../assets/screenshots/dashboard/dashboard_sync.png)
-
-> Para la guia detallada de la funcion Sync en si, consulta la [Guia detallada de Sync](../sync/overview.md).
-
-## Descripcion general
-
-La pagina Sync muestra visualmente el estado actual y la configuracion de la sincronizacion Studio <-> archivos locales. Solo es accesible cuando el dashboard esta en estado **Studio conectado**.
-
-## Sync Status
-
-Muestra el estado actual de sincronizacion:
-
-| Estado | Significado |
-|--------|-------------|
-| **Idle** | En espera de sincronizacion |
-| **Initializing** | Sincronizacion inicial en progreso |
-| **Syncing** | Sincronizacion incremental en progreso |
-| **Error** | Error de sincronizacion |
-
-La tarjeta de estado tambien muestra la ruta de sincronizacion, el numero de instancias sincronizadas y el modo de aplicacion actual (Auto/Manual).
-
-## Sync Directions
-
-Muestra en una tabla la direccion de sincronizacion por tipo:
-
-| Columna | Descripcion |
-|---------|-------------|
-| Type | Tipo de objetivo de sincronizacion (Scripts, Values, Instances, Data, Services) |
-| Direction | Direccion de sincronizacion (Local -> Studio, Studio -> Local) |
-| Apply Mode | Modo de aplicacion (Auto/Manual) |
-
-Permite verificar la direccion de sincronizacion de cada tipo para entender en que direccion se reflejan los cambios.
-
-## Sync Log
-
-Muestra los eventos de sincronizacion en orden cronologico. Cada entrada del log incluye una etiqueta de tipo de cambio (create, update, delete, etc.) y la ruta del objetivo.
-
-## Casos de uso
-
-### Verificar el estado de sincronizacion
-
-```
-"Quiero comprobar si el Sync esta funcionando correctamente"
-```
-
-Verifica que el Sync Status este en Idle y que los cambios recientes se hayan registrado correctamente en el Sync Log.
-
-### Identificar la direccion de sincronizacion
-
-```
-"Quiero saber en que direccion se sincronizan los cambios de scripts"
-```
-
-Consulta la Direction del tipo Scripts en la tabla de Sync Directions.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [Guia detallada de Sync](../sync/overview.md)

package/docs/es/dashboard/tools.md

@@ -1,69 +0,0 @@
-# Tools
-
-> Consulta el historial de ejecucion y las estadisticas de las herramientas MCP ejecutadas por la IA.
-
-![Tools — historial de ejecucion de herramientas y estadisticas](../../assets/screenshots/dashboard/dashboard_tools.png)
-
-## Descripcion general
-
-La pagina Tools proporciona el historial de ejecucion y las estadisticas de las herramientas MCP ejecutadas por la IA. Se compone de dos sub-pestanas: **History** y **Statistics**. Es accesible siempre que el dashboard este en estado **Servidor conectado** o **Studio conectado**.
-
-## Pestana History
-
-Muestra el historial de ejecucion de herramientas en una tabla ordenada cronologicamente:
-
-| Columna | Descripcion |
-|---------|-------------|
-| Time | Hora de ejecucion |
-| Tool.Action | Herramienta y accion ejecutada (ej: `query_instances.get_instance`) |
-| Duration | Tiempo de ejecucion |
-| Status | Estado del resultado (OK/Error) |
-| Tier | Tier utilizado (Basic/Pro) |
-
-Funcionalidades:
-- Desplegable de **filtro por Tool** para filtrar una herramienta especifica
-- Paginacion para explorar grandes volumenes de registros
-- Adicion de nuevos registros de ejecucion en tiempo real
-
-## Pestana Statistics
-
-Analiza visualmente las estadisticas de uso de herramientas:
-
-- **Distribucion por tier** — proporcion de uso de herramientas Basic/Pro
-- **Estadisticas por herramienta** — numero de llamadas y tiempo medio de respuesta de cada herramienta
-- **Analisis por accion** — estadisticas detalladas por accion dentro de cada herramienta
-
-## Funciones exclusivas del tier Basic
-
-Los usuarios del tier Basic ven elementos de UI adicionales:
-
-- **Tier Usage Progress** — barra de progreso de uso
-- **Modal comparativo Basic vs Pro** — informacion sobre las funciones adicionales del tier Pro
-
-## Casos de uso
-
-### Analisis de rendimiento de herramientas
-
-```
-"Quiero saber que herramienta tarda mas tiempo"
-```
-
-Consulta el tiempo medio de respuesta por herramienta en la pestana Statistics.
-
-### Seguimiento de errores
-
-```
-"Quiero saber por que fallo la herramienta que acabo de ejecutar"
-```
-
-Busca los elementos con Status Error en la pestana History para ver la informacion detallada.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Settings](settings.md)
-- [Lista completa de herramientas](../tools/overview.md)

package/docs/es/explorer/overview.md

@@ -1,104 +0,0 @@
-# Guia detallada de WEPPY Roblox Explorer
-
-**WEPPY Roblox Explorer** es una extension complementaria para VSCode / Antigravity que replica el arbol del Explorer de Roblox Studio dentro de tu editor. Explora instancias sincronizadas, abre scripts y edita propiedades sin tener que alternar entre Studio y el editor.
-
-> **Opcional** — Explorer no es obligatorio. El servidor MCP y el plugin de Roblox Studio son suficientes para usar todas las funciones principales. Instala Explorer cuando quieras navegar la estructura del proyecto o revisar y editar propiedades directamente desde tu editor.
-
-![WEPPY Roblox Explorer — arbol de instancias de Studio en la barra lateral de VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## Por que usar Explorer
-
-Los agentes de IA pueden entender el contexto completo del proyecto a partir de los archivos generados por Sync, pero cuando una persona explora el mirror directamente, las rutas de archivo por si solas no siempre dejan clara la jerarquia. Explorer reutiliza los mismos datos de sync y los presenta con la **misma estructura que ves en Roblox Studio**, lo que facilita:
-
-- Ver de un vistazo a que servicio / instancia pertenece cada script
-- Localizar rapidamente instancias entre servicios por nombre o ruta
-- Revisar el estado de sincronizacion por archivo (modified / studio / conflict)
-- Editar propiedades sin tener que abrir Studio
-
-## Requisitos
-
-- VSCode 1.85+ o Antigravity
-- [Roblox MCP](../installation/README.md) instalado con Sync habilitado (Basic o Pro)
-- Un archivo `weppy-project-sync/place_*/.sync-meta.json` generado por Sync bajo la raiz de tu proyecto
-
-Explorer funciona usando solo los archivos de sync en disco. Cuando el servidor MCP local esta en ejecucion, tambien se reflejan el estado de sync en vivo y la informacion de direction.
-
-## Instalacion
-
-Busca **WEPPY Roblox Explorer** en la barra lateral de Extensions (`Ctrl+Shift+X` / `Cmd+Shift+X`) de VSCode o Antigravity y haz clic en **Install**.
-
-Enlaces directos al marketplace:
-
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
-## Navegar el arbol de instancias
-
-Despues de la instalacion aparece una vista **WEPPY Explorer** en la Activity Bar de VSCode que detecta automaticamente el directorio de sync desde la raiz del proyecto.
-
-- **Raices de servicios**: Los servicios sincronizados como `Workspace`, `ReplicatedStorage` y `ServerScriptService` aparecen en el nivel superior.
-- **Iconos de clases Roblox**: Mas de 200 iconos al estilo Studio que cambian automaticamente entre tema oscuro y claro.
-- **Multi Place**: Cada Place sincronizado se muestra con su propia raiz de arbol cuando hay mas de uno.
-- **Actualizacion automatica**: El arbol se actualiza con un debounce de 500ms cuando los archivos de sync cambian.
-- **Insignias de estado sync**: Los estados `modified`, `studio` y `conflict` aparecen junto al icono para detectar cambios y conflictos al instante.
-
-Al hacer clic en un elemento del arbol se abre el archivo que respalda la instancia (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`, ...). El menu contextual permite copiar la ruta de la instancia en formato `game.Workspace.Part` o mostrar el archivo en el explorador predeterminado de VSCode.
-
-## Panel de propiedades
-
-Selecciona una instancia en el arbol del Explorer y ejecuta **Open Properties** para abrir un panel que se ve como la ventana Properties de Studio. Puedes inspeccionar y editar propiedades agrupadas sin tocar directamente el archivo `.props.json`.
-
-![Panel de propiedades — edita propiedades al estilo Studio dentro de VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-property-window.png)
-
-- **Vista agrupada**: Las propiedades se ordenan en los mismos grupos que usa Studio (Appearance, Behavior, Data, Part, Transform, etc.).
-- **Editores por tipo**: Los controles de entrada se adaptan al tipo de la propiedad: numeros, cadenas, booleanos, colores, Vector3, enums y mas.
-- **Edicion basada en archivos**: Los cambios se guardan en el archivo `*.props.json` de la instancia y se propagan a Studio a traves del camino reverso de Sync (Pro, cuando bidirectional esta habilitado).
-- **Editor personalizado**: Abrir un archivo `.props.json` directamente carga el Panel de propiedades en lugar del editor de texto predeterminado.
-
-Si quieres que el Panel de propiedades se abra automaticamente al navegar el arbol, cambia `robloxExplorer.propertyPanel.autoOpen` a `true` en la configuracion.
-
-## Busqueda de instancias
-
-Ejecuta el comando `WEPPY Explorer: Search Instances` (desde el icono del encabezado de la vista o la Command Palette) para abrir un QuickPick que busca a traves de todos los servicios sincronizados.
-
-- Coincidencias parciales sobre los nombres de instancia
-- Seleccionar un resultado enfoca el arbol en el elemento correspondiente
-- Cuando hay varios places sincronizados, los resultados se limitan por place
-
-## Configuracion
-
-| Ajuste | Valor por defecto | Descripcion |
-|--------|-------------------|-------------|
-| `robloxExplorer.mcpBaseUrl` | `""` | URL HTTP base del MCP local. Si esta vacio, Explorer prueba `http://127.0.0.1:3002` y luego `http://127.0.0.1:3003`. |
-| `robloxExplorer.syncRoot` | `""` | Ruta absoluta a la raiz `weppy-project-sync`. Se detecta desde las carpetas del workspace si esta vacia. |
-| `robloxExplorer.hidePropsFiles` | `false` | Oculta los archivos de sync (`.props.json`, `_tree.json`, `.value.json`) en el explorador predeterminado de VSCode. |
-| `robloxExplorer.autoRefresh` | `true` | Actualiza el arbol automaticamente cuando cambian los archivos de sync. |
-| `robloxExplorer.showSyncStatus` | `true` | Muestra decoraciones de estado de sync en los elementos del arbol. |
-| `robloxExplorer.followFocusCue` | `false` | Sigue archivos externos de focus cue para expandir el arbol y abrir archivos relacionados. |
-| `robloxExplorer.propertyPanel.autoOpen` | `false` | Abre automaticamente el Panel de propiedades al seleccionar una instancia en el arbol. |
-
-## Comandos
-
-| Comando | Descripcion |
-|---------|-------------|
-| `WEPPY Explorer: Refresh` | Refresca manualmente el arbol de instancias |
-| `WEPPY Explorer: Search Instances` | Busca instancias a traves de todos los servicios |
-| `WEPPY Explorer: Open Backing File` | Abre el archivo de la instancia seleccionada |
-| `WEPPY Explorer: Open Properties` | Abre el Panel de propiedades de la instancia seleccionada |
-| `WEPPY Explorer: Copy Instance Path` | Copia la ruta completa de la instancia (p. ej. `game.Workspace.Part`) |
-| `WEPPY Explorer: Reveal in Explorer` | Muestra el archivo en el explorador predeterminado de VSCode |
-| `WEPPY Explorer: Collapse All` | Contrae todos los nodos del arbol |
-| `WEPPY Explorer: Open Settings` | Abre la pagina de ajustes de Explorer |
-
-## Resolucion de problemas
-
-- **El arbol esta vacio**: Verifica que exista el directorio `weppy-project-sync/place_*` y que Sync haya completado al menos un Full Sync. Define `robloxExplorer.syncRoot` manualmente si es necesario.
-- **No aparece el estado de sync**: Asegurate de que el servidor MCP local este en ejecucion y prueba a configurar `robloxExplorer.mcpBaseUrl` de forma explicita.
-- **El Panel de propiedades no se abre**: Si un archivo `.props.json` se abre en el editor de texto predeterminado, haz clic derecho sobre el y elige **Reopen Editor With... → WEPPY Property Panel**.
-- **Los iconos se ven rotos**: Vuelve a seleccionar el tema de VSCode o reinicia la ventana para refrescar la cache de iconos.
-
-## Documentos relacionados
-
-- [Guia de instalacion de Roblox MCP](../installation/README.md)
-- [Guia de Sync](../sync/overview.md)
-- [Resumen de herramientas](../tools/overview.md)

package/docs/es/installation/README.md

@@ -1,87 +0,0 @@
-# Guía de Instalación
-
-Para usar Roblox MCP, necesitas configurar dos cosas:
-
-```
-App de IA (Claude, etc.)
-         ↓
-    Servidor MCP
-         ↓
-Plugin de Roblox Studio
-```
-
-## Instalación en un solo comando (Recomendado)
-
-Instala todo con un solo comando:
-
-**macOS / Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
-```
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
-```
-
-¡Reinicia Roblox Studio y listo!
-
-El registro automático de MCP es compatible con **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI y Antigravity**.
-
-Si la ejecución de PowerShell está bloqueada en Windows, continúa con la instalación manual de abajo. Si usas el paquete ZIP, también puedes ejecutar `setup-plugin.bat` y `setup-mcp.bat`.
-
----
-
-## Instalación manual
-
-Si la instalacion en un solo comando no funciona, o cuando no puedes usar la instalacion automatica en tu entorno, usa la instalacion manual de abajo como alternativa.
-
-### Paso 1: Instalar el Plugin de Roblox Studio
-
-El plugin conecta Roblox Studio con la IA.
-
-👉 [Guía de instalación del plugin](https://weppyai.com/en/install#plugin)
-
-### Paso 2: Registrar el Servidor MCP en tu App de IA
-
-Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox Studio.
-
-| App de IA | Cómo configurar |
-|-----------|----------------|
-| **Claude Code** | [Instrucciones](ai-apps/claude-code.md) |
-| **Claude Desktop** | [Instrucciones](ai-apps/claude-app.md) |
-| **Cursor** | [Instrucciones](ai-apps/cursor.md) |
-| **Codex CLI** | [Instrucciones](ai-apps/codex-cli.md) |
-| **Codex Desktop** | [Instrucciones](ai-apps/codex-app.md) |
-| **Gemini CLI** | [Instrucciones](ai-apps/gemini-cli.md) |
-| **Antigravity** | [Instrucciones](ai-apps/antigravity.md) |
-
-> **Nota**: Funciona con cualquier app compatible con MCP. El comando es:
-> ```bash
-> npx -y @weppy/roblox-mcp
-> ```
-
-## Opcional: Instalar WEPPY Roblox Explorer (Extensión VSCode)
-
-Explora los árboles de instancias sincronizados dentro de VSCode con iconos de clases Roblox.
-Esta extension opcional requiere completar antes la instalacion de Roblox MCP, porque Explorer lee los datos de Sync desde `weppy-project-sync` dentro de la raiz del proyecto.
-
-👉 [Guía de instalación de WEPPY Roblox Explorer](https://weppyai.com/en/install#explorer)
-
-Instalación directa:
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
----
-
-## Después de la Instalación
-
-Prueba con un comando simple:
-
-```
-Crea una parte azul en Roblox Studio
-```
-
-Si funciona, ¡estás listo para empezar!

package/docs/es/installation/ai-apps/antigravity.md

@@ -1,89 +0,0 @@
-# Configuración de Antigravity
-
-Cómo usar Roblox MCP con [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
-
-> **Antigravity** es la plataforma de desarrollo basada en agentes de Google, donde los agentes de IA se mueven entre la edición de código, la terminal y el navegador para realizar tareas complejas de forma autónoma.
-
-## Requisitos previos
-
-1. **Antigravity** instalado (consulta la documentación oficial para SO compatibles y requisitos)
-2. **Node.js** (v18.0.0 o superior, `npx` disponible)
-3. **Plugin de Roblox Studio** instalado
-
-## Registrar servidor MCP
-
-En Antigravity, los servidores MCP se administran en el **panel de agente (Agent pane)**.
-
-### Registro manual mediante raw config (recomendado)
-
-1. En el panel de agente, haz clic en **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
-
-![Abrir menú de MCP Servers](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
-
-2. En la configuración (JSON) que se muestra, agrega/fusiona lo siguiente:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-![Editar raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
-
-3. Guarda y ejecuta **Refresh** (o reinicia/actualiza según lo indique la UI)
-
-> La ruta/nombre real del archivo de configuración puede variar según el SO y la versión de Antigravity, así que edita siempre la ubicación indicada en **View raw config**.
-
-### Opción: Ajustar puerto/logs con variables de entorno
-
-Se recomienda mantener el valor predeterminado (HTTP `127.0.0.1:3002`). Si es necesario, puedes establecer variables de entorno así:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_HOST": "127.0.0.1",
-        "HTTP_PORT": "3002",
-        "LOG_LEVEL": "INFO"
-      }
-    }
-  }
-}
-```
-
-## Prueba de conexión
-
-1. Abre **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
-2. En **Antigravity**, escribe:
-   ```
-   Dime qué está seleccionado actualmente en Roblox Studio
-   ```
-
-## Solución de problemas
-
-### Cuando el servidor no inicia
-
-Ejecuta el servidor MCP directamente para ver el error:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Falla de conexión
-
-- Verifica que el plugin de Roblox Studio esté en estado **Connected**
-- Verifica que el puerto **3002** no esté bloqueado por el firewall
-- Revisa el estado del servidor en el panel de agente **⋯** → **MCP Servers**
-- (Avanzado) Si cambiaste `HTTP_PORT`, el plugin/bridge de Roblox Studio también debe usar el mismo puerto.
-
-## Referencias
-
-- [Introducción a Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
-- [Guía de inicio de Antigravity (Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)

package/docs/es/installation/ai-apps/claude-app.md

@@ -1,78 +0,0 @@
-# Configuracion de Claude Desktop App
-
-Como usar Roblox MCP en [Claude Desktop App](https://claude.ai/download).
-
-## Requisitos Previos
-
-- **Claude Desktop App** instalado
-- **Node.js** (v18.0.0 o superior)
-- **Plugin de Roblox Studio** instalado
-
-## Registrar el Servidor MCP
-
-### Metodo 1: Desktop Extensions (Recomendado)
-
-> Desde 2026, instalacion con un clic como las extensiones del navegador
-
-1. Claude Desktop → **Settings** → **Extensions**
-2. Busca `weppy-roblox-mcp`
-3. Clic en **Install**
-
-### Metodo 2: Editar archivo de configuracion directamente
-
-1. Claude Desktop → **Settings** → **Developers** → Clic en **Edit Config**
-
-2. Agrega el siguiente contenido al archivo `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. **Cierra completamente** Claude Desktop y reinicia
-
-**Ubicacion del archivo de configuracion:**
-
-| SO | Ruta |
-|----|------|
-| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
-
-## Probar la Conexion
-
-1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
-2. Inicia una nueva conversacion en **Claude Desktop** y prueba:
-   ```
-   Crea una parte azul en Roblox Studio
-   ```
-
-## Solucion de Problemas
-
-### El servidor MCP no carga
-
-1. **Verifica la sintaxis JSON**: Valida el archivo de configuracion con un validador JSON en linea
-2. **Reinicia completamente Claude Desktop**: Despues de cambiar la configuracion, asegurate de cerrar completamente la aplicacion y reiniciar
-3. **Verifica las rutas**: Asegurate de que command y args sean correctos
-
-### El servidor no inicia
-
-Ejecuta el servidor MCP directamente para ver los errores:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Fallo de conexion
-
-- Verifica que el plugin de Roblox Studio este en estado **Connected**
-- Verifica que el puerto 3002 no este bloqueado por el firewall
-
-## Recursos
-
-- [Guia oficial de MCP para Claude Desktop](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)
-- [Guia de conexion de servidores MCP](https://modelcontextprotocol.io/docs/develop/connect-local-servers)

package/docs/es/installation/ai-apps/claude-code.md

@@ -1,104 +0,0 @@
-# Configuracion de Claude Code
-
-Como usar Roblox MCP en [Claude Code](https://claude.ai/code) (herramienta de codificacion IA basada en terminal).
-
-## Requisitos Previos
-
-- **Claude Code** instalado
-- **Plugin de Roblox Studio** instalado
-
-## Instalacion
-
-```bash
-npm install -g @anthropic-ai/claude-code
-```
-
-## Registrar el Servidor MCP
-
-### Metodo 1: Instalar desde el Marketplace (Recomendado)
-
-Ejecuta en la terminal de Claude Code:
-
-```bash
-# Agregar marketplace
-/plugin marketplace add hope1026/weppy-roblox-mcp
-
-# Instalar plugin
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-Verificar instalacion:
-```bash
-/plugin list
-```
-
-### Metodo 2: Editar archivo de configuracion directamente
-
-Crea el archivo `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**Ubicacion del archivo de configuracion:**
-
-| Alcance | Ruta |
-|---------|------|
-| Proyecto | `<proyecto>/.mcp.json` |
-| Global | `~/.claude/mcp.json` |
-
-## Gestion Automatica del Servidor
-
-Claude Code gestiona el servidor MCP automaticamente:
-
-- Inicia automaticamente cuando es necesario
-- Se detiene automaticamente al terminar la sesion
-- No requiere configuracion adicional
-
-## Probar la Conexion
-
-1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
-2. Prueba en **Claude Code**:
-   ```
-   Crea una parte azul en Roblox Studio
-   ```
-
-## Solucion de Problemas
-
-### Fallo en la instalacion del plugin
-
-```bash
-# Limpiar cache y reintentar
-/plugin cache clear
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-### El servidor no inicia
-
-1. Verifica la version de Node.js (requiere 18.0 o superior):
-   ```bash
-   node --version
-   ```
-
-2. Prueba iniciar el servidor manualmente:
-   ```bash
-   npx -y @weppy/roblox-mcp
-   ```
-
-### Las herramientas MCP no aparecen
-
-Verifica en Claude Code:
-```
-Muestrame la lista de herramientas MCP disponibles
-```
-
-## Recursos
-
-- [Documentacion oficial de Claude Code](https://docs.anthropic.com/claude-code)