Guia do MCP Dashboard

Monitore e gerencie em tempo real pelo navegador o status do servidor MCP, conexões, sincronização, histórico de execução de ferramentas e histórico de alterações do jogo.

Overview

O dashboard é uma interface de monitoramento baseada na web fornecida pelo servidor MCP. Abre automaticamente no navegador quando o servidor MCP é executado, e permite rastrear em tempo real todas as operações realizadas pelo agente de IA no Roblox Studio.

• Verifique o status visualmente sem precisar procurar nos logs do terminal
• Rastreie o histórico de alterações do que a IA modificou no Studio
• Veja status de sincronização, status de conexão e estatísticas de execução de ferramentas em um só lugar

Como Acessar

Quando o servidor MCP é executado, o dashboard abre automaticamente no navegador. Para acessar manualmente:

http://localhost:3002

Defina DASHBOARD_AUTO_OPEN=false para desativar a abertura automática.

Recursos Disponíveis por Status de Conexão

Cards de Status

A página Overview é a primeira tela do dashboard, mostrando o status geral do sistema em um só lugar.

Alterações Recentes do Jogo (Recent Game Changes)

Exibe em tempo real as alterações recentes feitas pela IA no Studio (até 20). Cada item é exibido com um ícone de categoria de alteração e, ao clicar, você vai para a visualização detalhada do Changelog.

Ícones de categoria:

• Script — Criação/modificação de scripts
• Instance — Criação/exclusão/movimentação de instâncias
• Property — Alteração de propriedades
• Lighting — Configuração de iluminação/ambiente
• Terrain — Alteração de terreno
• Asset — Inserção de assets

O dashboard usa SSE (Server-Sent Events) para atualizar dados em tempo real. Em caso de desconexão SSE, reconecta automaticamente após 3 segundos.

Connection

Inspecione o servidor MCP, agentes de IA conectados, Studio Targets e log de conexão em um só lugar.

A página Connection é a forma mais rápida de entender como o runtime MCP local está conectado no momento. Ela fica disponível quando o dashboard está em servidor conectado ou Studio conectado.

Connection Topology

O mapa de topologia mostra três colunas conceituais: AI Agents → MCP Server → Studio Targets. Ele é uma visualização de diagnóstico: as linhas mostram o que está conectado ao servidor MCP, mas não alteram o routing por si só.

O nó MCP Server mostra o status do servidor e o resumo de routing atual para solicitações que não nomeiam um Studio target.

Studio Targets

Studio Targets são as janelas conectadas do Roblox Studio que podem receber solicitações MCP. Cada target mostra:

Para direcionar um agente a uma janela específica do Studio, copie o Studio ID e escreva algo como use Studio ID studio-1.

Studio Routing

Studio Routing afeta apenas solicitações que não nomeiam um Studio target.

• Automatic: Recent priority escolhe o Studio Target ativo com maior prioridade. Trabalho roteado recentemente tem prioridade sobre simples atividade de heartbeat.
• Manual: Pinned Studio envia solicitações sem seletor para o target conectado que está pinned.
• Studio ID, Connection ID ou Place ID explícitos em uma solicitação do agente sempre prevalecem sobre o modo de routing do dashboard.

Connection mostra o modo atual e um link Manage routing. Altere o modo ou target pinned em Controls → Studio Routing.

Fluxos com vários agentes e vários Studio

Use esta página quando houver mais de um agente ou mais de uma janela do Studio ativa. Você pode manter Claude Code, Codex, Gemini ou outro agente conectado ao mesmo tempo, e ver várias janelas do Roblox Studio como Studio Targets separados.

Bons prompts deixam o destino explícito:

• Use Studio ID studio-1 para esta alteração.
• Execute isso no Place Lobby, não no World.
• Verifique studio-2 antes de alterar scripts compartilhados.

Isso ajuda quando um agente edita scripts enquanto outro revisa UI, ou quando você mantém janelas separadas do Studio para diferentes Places da mesma experiência.

Diagnóstico

As tabelas inferiores mantêm disponíveis os detalhes de Server Status, AI Agents, Studio Targets e Connection Log para copiar identificadores, verificar diretórios de trabalho e revisar eventos de conexão/desconexão.

Sync

Monitore o status atual, configuração de direção e logs da sincronização Studio ↔ arquivos locais.

A página Sync exibe visualmente o status atual e as configurações da sincronização Studio ↔ arquivos locais. Só pode ser acessada quando o dashboard está no estado Studio conectado.

Sync Status

O card de status também exibe o caminho de sincronização, o número de instâncias sincronizadas e o modo de aplicação atual (Auto/Manual).

Sync Directions

Exibe em tabela a direção de sincronização por tipo:

No Sync Log você pode ver eventos de sincronização em ordem cronológica. Cada item de log inclui tags de tipo de alteração (create, update, delete etc.) e o caminho de destino.

Changelog

Registra todas as alterações feitas pela IA no Roblox Studio por sessão, fornecendo resumo de alterações, timeline e Before & After.

O Changelog é uma página que rastreia o histórico de alterações do jogo feitas pelo agente de IA no Studio. As alterações são agrupadas por sessão, e você pode ver rapidamente quantas alterações de cada tipo ocorreram em cada sessão.

Lista de Cards de Sessão

Cada card de sessão exibe um status:

Cada card resume o número de alterações da sessão por categoria (Script, Instance, Property, Lighting, Terrain, Asset).

Você pode filtrar sessões pelas abas no topo: All, Active, Completed.

Visualização Detalhada da Sessão

Clique em um card de sessão para entrar na visualização detalhada.

Change Summary: Visualiza as alterações da sessão em 6 cards de categoria (Scripts, Instances, Properties, Lighting, Terrain, Assets).

Change Timeline: Lista todas as alterações dentro da sessão em ordem cronológica. Você pode filtrar apenas uma categoria específica com o dropdown Category, e clicar em um item expande a visualização de comparação Before & After.

Before & After

Playtest

Verifique o status e os resultados dos playtests executados pela IA.

A página Playtest exibe o status e os resultados dos playtests executados pela IA. Só pode ser acessada quando o dashboard está no estado Studio conectado.

Playtest Status

Test History

Lista em ordem cronológica os resultados dos testes executados pela IA com a ação run_test:

Clique no relatório de teste para ver o relatório detalhado em formato markdown e os logs.

Tools

Verifique o histórico e as estatísticas das ferramentas MCP executadas pela IA.

A página Tools fornece o histórico e as estatísticas das ferramentas MCP executadas pela IA. É composta pelas subabas History e Statistics. Pode ser acessada sempre que o dashboard estiver no estado servidor conectado ou Studio conectado.

Aba History

Exibe o histórico de execução de ferramentas em uma tabela cronológica:

Funcionalidades: filtrar apenas uma ferramenta específica com o dropdown Tool, navegar por grandes volumes de registros com paginação, novos registros de execução adicionados em tempo real.

Aba Statistics

Analisa visualmente as estatísticas de uso de ferramentas:

• Distribuição por tier — Proporção de uso de ferramentas Basic/Pro
• Estatísticas por ferramenta — Número de chamadas e tempo médio de resposta de cada ferramenta
• Análise por ação — Estatísticas detalhadas por ação dentro da ferramenta

Usuários do tier Basic também verão a barra Tier Usage Progress e o modal de comparação Basic vs Pro.

Settings

Verifique e gerencie informações de licença, configurações do servidor e idioma.

Na página Settings você pode verificar e alterar algumas informações de licença e configurações do servidor. Pode ser acessada sempre que o dashboard estiver no estado servidor conectado ou Studio conectado.

License (Somente Leitura)

General

Server Environment (Somente Leitura)

Language

Altera o idioma da interface do dashboard. Suporta 6 idiomas + Auto (detecção automática do idioma do navegador).