WEPPY

Guía del MCP Dashboard

Cómo ver el estado del servidor, la conexión, Sync, Changelog, Playtest y el historial de herramientas en el dashboard web.

Verifica y gestiona en tiempo real, desde el navegador web, el estado del servidor MCP, las conexiones, la sincronización, el historial de ejecución de herramientas y el historial de cambios del juego.

Resumen del dashboard — Estado del servidor, cambios recientes y resumen de sesión de un vistazo

Overview

El dashboard es la interfaz de monitoreo web que ofrece el servidor MCP. Se abre automáticamente en el navegador cuando el servidor MCP se pone en marcha, y puedes rastrear en tiempo real todas las operaciones que el agente de IA realiza en Roblox Studio.

  • Comprende el estado visualmente sin necesidad de revisar los logs del terminal
  • Rastrea el historial de cambios de lo que la IA modificó en Studio
  • Verifica el estado de sincronización, el estado de conexión y las estadísticas de ejecución de herramientas en un solo lugar

Cómo acceder

Cuando el servidor MCP se ejecuta, el dashboard se abre automáticamente en el navegador. Para acceder manualmente:

http://localhost:3002

Puedes desactivar la apertura automática estableciendo DASHBOARD_AUTO_OPEN=false.

Funciones disponibles según el estado de conexión

EstadoCondiciónPáginas disponibles
Servidor desconectadoSin conexión al servidorSolo muestra la pantalla de espera de reconexión
Servidor conectadoServidor conectado, plugin no conectadoConnection, Tools, Settings
Studio conectadoServidor + plugin ambos conectadosTodas las páginas

Tarjetas de estado

La página Overview es la primera pantalla del dashboard y muestra el estado general del sistema de un vistazo.

TarjetaInformación mostrada
ServerEstado de conexión del servidor (Online/Offline)
PluginEstado de conexión del plugin, información del Place
AgentNombre del agente de IA actualmente conectado
SyncEstado de sincronización (Idle/Syncing/Error)

Cambios recientes en el juego (Recent Game Changes)

Muestra en tiempo real los cambios recientes realizados por la IA en Studio (máximo 20). Cada elemento se muestra con el icono de categoría de cambio y, al hacer clic, navega a la vista de detalle del Changelog.

Iconos de categoría:

  • Script — Creación/modificación de scripts
  • Instance — Creación/eliminación/movimiento de instancias
  • Property — Cambio de propiedades
  • Lighting — Configuración de iluminación/entorno
  • Terrain — Cambio de terreno
  • Asset — Inserción de assets

El dashboard usa SSE (Server-Sent Events) para actualizar los datos en tiempo real. Si se pierde la conexión SSE, se reconecta automáticamente después de 3 segundos.

Connection

Inspecciona el servidor MCP, los agentes de IA conectados, los Studio Targets y el log de conexión en un solo lugar.

Página Connection — mapa de topología con agentes de IA, servidor MCP y Studio Targets

La página Connection es la forma más rápida de entender cómo está conectado el runtime MCP local en este momento. Está disponible cuando el dashboard está en estado servidor conectado o Studio conectado.

Connection Topology

El mapa de topología muestra tres columnas conceptuales: AI Agents → MCP Server → Studio Targets. Es una vista de diagnóstico: las líneas muestran qué está conectado al servidor MCP, pero no cambian el routing por sí mismas.

El nodo MCP Server muestra el estado del servidor y el resumen de routing actual para solicitudes que no nombran un Studio target.

Studio Targets

Studio Targets son las ventanas conectadas de Roblox Studio que pueden recibir solicitudes MCP. Cada target muestra:

CampoSignificado
Studio IDSelector corto como studio-1 que puedes copiar en un prompt del agente
Place / Place IDEl Roblox Place asociado a esa ventana de Studio
Connection IDIdentificador completo de conexión para diagnóstico
Last Used / Last SeenCuándo WEPPY envió trabajo al target y cuándo recibió la última señal
RoutingSi el target está marcado como Priority o Pinned
In FlightSi hay una solicitud ejecutándose en ese target

Para dirigir un agente a una ventana de Studio concreta, copia el Studio ID y escribe algo como usa Studio ID studio-1.

Studio Routing

Studio Routing solo afecta las solicitudes que no nombran un Studio target.

  • Automatic: Recent priority elige el Studio Target activo con mayor prioridad. El trabajo enrutado recientemente pesa más que la simple actividad de heartbeat.
  • Manual: Pinned Studio envía las solicitudes sin selector al target conectado que está pinned.
  • Un Studio ID, Connection ID o Place ID explícito en la solicitud del agente siempre tiene prioridad sobre el modo de routing del dashboard.

Connection muestra el modo actual y un enlace Manage routing. Cambia el modo o el target pinned desde Controls → Studio Routing.

Flujos con varios agentes y varios Studio

Usa esta página cuando haya más de un agente o más de una ventana de Studio activa. Puedes mantener Claude Code, Codex, Gemini u otro agente conectado al mismo tiempo, y ver varias ventanas de Roblox Studio como Studio Targets separados.

Los buenos prompts nombran el destino con claridad:

  • Usa Studio ID studio-1 para este cambio.
  • Ejecuta esto en el Place Lobby, no en World.
  • Revisa studio-2 antes de cambiar scripts compartidos.

Esto ayuda cuando un agente edita scripts mientras otro revisa UI, o cuando tienes ventanas de Studio separadas para distintos Places de la misma experiencia.

Diagnóstico

Las tablas inferiores mantienen disponibles los datos detallados de Server Status, AI Agents, Studio Targets y Connection Log para copiar identificadores, revisar directorios de trabajo y verificar eventos de conexión/desconexión.

Sync

Monitorea el estado actual de la sincronización Studio ↔ archivos locales, la configuración de dirección y los logs.

La página Sync muestra visualmente el estado y la configuración actual de la sincronización Studio ↔ archivos locales. Solo es accesible cuando el dashboard está en estado Studio conectado.

Sync Status

EstadoSignificado
IdleEn espera de sincronización
InitializingSincronización inicial en curso
SyncingSincronización incremental en curso
ErrorError de sincronización

La tarjeta de estado muestra también la ruta de sincronización, el número de instancias sincronizadas y el modo de aplicación actual (Auto/Manual).

Sync Directions

Muestra en una tabla la dirección de sincronización por tipo:

ColumnaDescripción
TypeTipo de objetivo de sincronización (Scripts, Values, Instances, Data, Services)
DirectionDirección de sincronización (Local → Studio, Studio → Local)
Apply ModeModo de aplicación (Auto/Manual)

En el Sync Log puedes ver los eventos de sincronización en orden cronológico. Cada entrada incluye la etiqueta del tipo de cambio (create, update, delete, etc.) y la ruta del objeto.

Changelog

Registra todos los cambios realizados por la IA en Roblox Studio agrupados por sesión, y ofrece resumen de cambios, línea de tiempo y comparación Antes y Después.

Changelog — Lista de tarjetas de cambios por sesión

El Changelog es la página que rastrea el historial de cambios en el juego realizados por el agente de IA en Studio. Los cambios se agrupan por sesión y puedes ver de un vistazo cuántos cambios de cada tipo ocurrieron en cada sesión.

Lista de tarjetas de sesión

Cada tarjeta de sesión muestra un estado:

EstadoSignificado
ActiveSesión actualmente en curso (actualización en tiempo real)
CompletedSesión completada
BootstrapSesión de sincronización inicial

Cada tarjeta resume el número de cambios de esa sesión por categoría (Script, Instance, Property, Lighting, Terrain, Asset).

Puedes filtrar las sesiones con las pestañas superiores: All, Active, Completed.

Vista de detalle de sesión

Haz clic en una tarjeta de sesión para entrar en la vista de detalle.

Change Summary: Visualiza los cambios de la sesión en 6 tarjetas de categoría (Scripts, Instances, Properties, Lighting, Terrain, Assets).

Change Timeline: Lista todos los cambios de la sesión en orden cronológico. Puedes filtrar solo una categoría específica con el desplegable Category y, al hacer clic en un elemento, se despliega la vista de comparación Antes y Después.

Before & After

FiabilidadSignificadoEjemplo
exactSe registraron exactamente los valores antes y después del cambioCambio de propiedad, modificación de script
partialSolo se registró información parcialCambio compuesto
after-onlySolo existe el valor posterior al cambioCreación de nueva instancia
intent-onlySolo se registró la intenciónEliminación, etc.

Playtest

Verifica el estado y los resultados de las pruebas ejecutadas por la IA.

Playtest — Estado del playtest e historial de pruebas

La página Playtest muestra el estado y los resultados de las pruebas ejecutadas por la IA. Solo es accesible cuando el dashboard está en estado Studio conectado.

Playtest Status

EstadoSignificado
NotRunningPlaytest no ejecutándose
RunningPlaytest en ejecución
PausedPlaytest en pausa (modo Run)

Test History

Lista en orden cronológico los resultados de las pruebas ejecutadas por la IA con la acción run_test:

ElementoDescripción
TimestampHora de ejecución de la prueba
Test ReportEnlace al informe de la prueba
ModeModo de ejecución (play/run)
DurationTiempo empleado en la prueba
StatusResultado (Passed/Failed)

Al hacer clic en el informe de prueba puedes ver el informe detallado en formato markdown y los logs.

Tools

Verifica el historial y las estadísticas de las herramientas MCP ejecutadas por la IA.

Tools — Historial de ejecución de herramientas y estadísticas

La página Tools ofrece el historial y las estadísticas de las herramientas MCP ejecutadas por la IA. Se compone de dos sub-pestañas: History y Statistics. Siempre es accesible cuando el dashboard está en estado servidor conectado o Studio conectado.

Pestaña History

Muestra el historial de ejecución de herramientas en una tabla ordenada cronológicamente:

ColumnaDescripción
TimeHora de ejecución
Tool.ActionHerramienta y acción ejecutadas (por ejemplo: query_instances.get_instance)
DurationTiempo empleado en la ejecución
StatusEstado del resultado (OK/Error)
TierTier utilizado (Basic/Pro)

Funciones: filtrar herramientas específicas con el desplegable Tool, navegar por registros voluminosos con paginación, y nuevos registros de ejecución se añaden en tiempo real.

Pestaña Statistics

Analiza visualmente las estadísticas de uso de herramientas:

  • Distribución por tier — Proporción de uso de herramientas Basic/Pro
  • Estadísticas por herramienta — Número de llamadas y tiempo de respuesta promedio de cada herramienta
  • Análisis por acción — Estadísticas detalladas por acción dentro de cada herramienta

A los usuarios del tier Basic se les muestra adicionalmente una barra de progreso Tier Usage y un modal de comparación Basic vs Pro.

Settings

Verifica y gestiona la información de la licencia, la configuración del servidor y el idioma.

En la página Settings puedes ver la información de la licencia y la configuración del servidor, y modificar algunos parámetros. Siempre es accesible cuando el dashboard está en estado servidor conectado o Studio conectado.

License (solo lectura)

CampoDescripción
StatusIndicador de estado (Active/Inactive)
TierTier actual (Basic/Pro)
License KeyClave de licencia enmascarada
ProviderInformación del proveedor de licencia

General

ConfiguraciónDescripción
Log LevelNivel de salida de logs
History RecordingSi guardar el historial de ejecución de herramientas
Stats CollectionSi recopilar estadísticas de herramientas
Request TimeoutTiempo de espera de las solicitudes (segundos)

Server Environment (solo lectura)

Variable de entornoDescripciónValor predeterminado
HTTP_PORTPuerto HTTP3002
HTTP_HOSTHost HTTP127.0.0.1
DASHBOARD_AUTO_OPENApertura automática del dashboardtrue

Language

Cambia el idioma de la interfaz del dashboard. Soporta 6 idiomas + Auto (detección automática del idioma del navegador).

OpciónIdioma
AutoDetección automática del idioma del navegador
EnglishInglés
한국어Coreano
日本語Japonés
EspañolEspañol
PortuguêsPortugués
Bahasa IndonesiaIndonesio