WEPPY

MCP Dashboard Anleitung

Wie Sie Serverstatus, Verbindungen, Sync, Changelog, Playtest und Tool-Verlauf im Web-Dashboard überwachen.

Überwachen und verwalten Sie Serverstatus, Verbindungen, Sync, Tool-Ausführungsverlauf und Spieländerungsverlauf in Echtzeit aus einem Webbrowser.

Dashboard Übersicht — Serverstatus, kürzliche Änderungen und Sessionzusammenfassung auf einen Blick

Übersicht

Das Dashboard ist die webbasierte Überwachungsschnittstelle, die vom MCP-Server bereitgestellt wird. Es öffnet sich automatisch in Ihrem Browser, wenn der MCP-Server startet, und ermöglicht es Ihnen, alles, was der KI-Agent in Roblox Studio tut, in Echtzeit zu verfolgen.

  • Den Systemstatus visuell verstehen, ohne Terminal-Logs durchsuchen zu müssen
  • Verfolgen, was die KI in Studio geändert hat, über den Änderungsverlauf
  • Sync-Status, Verbindungsstatus und Tool-Ausführungsstatistiken an einem Ort anzeigen

Wie Sie zugreifen

Das Dashboard öffnet sich automatisch in Ihrem Browser, wenn der MCP-Server startet. Um es manuell zu öffnen:

http://localhost:3002

Setzen Sie DASHBOARD_AUTO_OPEN=false, um das automatische Öffnen zu deaktivieren.

Verfügbare Funktionen nach Verbindungsstatus

StatusBedingungVerfügbare Seiten
Server getrenntServer läuft nichtNur Wartebildschirm für Wiederverbindung
Server verbundenServer verbunden, Plugin nicht verbundenConnection, Tools, Settings
Studio verbundenSowohl Server als auch Plugin verbundenAlle Seiten

Status-Karten

Die Overview-Seite ist der Startbildschirm des Dashboards und zeigt den gesamten Systemstatus auf einen Blick.

KarteAngezeigte Informationen
ServerServer-Verbindungsstatus (Online/Offline)
PluginPlugin-Verbindungsstatus und Place-Info
AgentName des derzeit verbundenen KI-Agenten
SyncSync-Status (Idle/Syncing/Error)

Letzte Spieländerungen

Zeigt die kürzlichsten Änderungen, die die KI in Studio vorgenommen hat, in Echtzeit an (bis zu 20). Jeder Eintrag wird mit einem Änderungskategorie-Icon angezeigt, und ein Klick darauf bringt Sie zur Changelog-Detailansicht.

Kategorie-Icons:

  • Script — erstellte/geänderte Skripte
  • Instance — erstellte/gelöschte/verschobene Instanzen
  • Property — Eigenschaftsänderungen
  • Lighting — Beleuchtungs-/Umgebungsänderungen
  • Terrain — Terrain-Änderungen
  • Asset — eingefügte Assets

Das Dashboard verwendet SSE (Server-Sent Events), um Daten in Echtzeit zu aktualisieren. Es verbindet sich automatisch 3 Sekunden nach dem Verlust einer SSE-Verbindung erneut.

Connection

Prüfen Sie MCP-Server, verbundene KI-Agenten, Studio Targets und Verbindungsprotokoll an einem Ort.

Connection-Seite — Topologiekarte mit KI-Agenten, MCP-Server und Studio Targets

Die Connection-Seite ist der schnellste Weg, um zu verstehen, wie die lokale MCP-Laufzeit aktuell verbunden ist. Sie ist verfügbar, wenn das Dashboard im Status Server verbunden oder Studio verbunden ist.

Connection Topology

Die Topologiekarte zeigt drei konzeptionelle Spalten: AI Agents → MCP Server → Studio Targets. Sie ist eine Diagnoseansicht: Verbindungslinien zeigen, was am MCP-Server hängt, ändern aber selbst kein Routing.

Der MCP-Server-Knoten zeigt den Serverstatus und die aktuelle Routing-Zusammenfassung für Anfragen, die kein Studio Target benennen.

Studio Targets

Studio Targets sind verbundene Roblox-Studio-Fenster, die MCP-Anfragen empfangen können. Jedes Target zeigt:

FeldBedeutung
Studio IDKurzer Selektor wie studio-1, den Sie in einen Agent-Prompt kopieren können
Place / Place IDDer Roblox Place, der mit diesem Studio-Fenster verknüpft ist
Connection IDVollständige Verbindungskennung für Diagnosen
Last Used / Last SeenWann WEPPY Arbeit an das Target geroutet hat und wann zuletzt ein Signal empfangen wurde
RoutingOb das Target aktuell Priority oder Pinned ist
In FlightOb auf diesem Target gerade eine Anfrage läuft

Um einen Agenten auf ein bestimmtes Studio-Fenster zu richten, kopieren Sie die Studio ID und schreiben zum Beispiel verwende Studio ID studio-1.

Studio Routing

Studio Routing betrifft nur Anfragen, die kein Studio Target benennen.

  • Automatic: Recent priority wählt das aktive Studio Target mit der höchsten Priorität. Kürzlich geroutete Arbeit zählt mehr als reine Heartbeat-Aktivität.
  • Manual: Pinned Studio sendet Anfragen ohne Selektor an das gepinnte verbundene Target.
  • Eine explizite Studio ID, Connection ID oder Place ID in einer Agent-Anfrage hat immer Vorrang vor dem Routing-Modus des Dashboards.

Connection zeigt den aktuellen Modus und einen Manage routing-Link. Ändern Sie Modus oder pinned target unter Controls → Studio Routing.

Workflows mit mehreren Agenten und mehreren Studios

Nutzen Sie diese Seite, wenn mehr als ein Agent oder mehr als ein Studio-Fenster aktiv ist. Sie können Claude Code, Codex, Gemini oder einen anderen Agenten gleichzeitig verbunden lassen und mehrere Roblox-Studio-Fenster als getrennte Studio Targets sehen.

Gute Prompts nennen das Ziel eindeutig:

  • Verwende Studio ID studio-1 für diese Änderung.
  • Führe das im Lobby Place aus, nicht in World.
  • Prüfe studio-2, bevor du gemeinsame Skripte änderst.

Das hilft, wenn ein Agent Skripte bearbeitet und ein anderer UI prüft, oder wenn Sie getrennte Studio-Fenster für verschiedene Places derselben Experience geöffnet haben.

Diagnose

Die unteren Diagnosetabellen halten Server Status, AI Agents, Studio Targets und Connection Log weiterhin bereit, um Kennungen zu kopieren, Arbeitsverzeichnisse zu prüfen und Verbindungs-/Trennungsereignisse zu überprüfen.

Sync

Überwachen Sie den aktuellen Sync-Status, Richtungseinstellungen und Logs für Studio ↔ lokalen Datei-Sync.

Die Sync-Seite zeigt den aktuellen Status und die Konfiguration des Studio ↔ lokalen Datei-Syncs visuell an. Sie ist nur zugänglich, wenn das Dashboard im Status Studio verbunden ist.

Sync-Status

StatusBedeutung
IdleSync ist inaktiv
InitializingInitialer Sync läuft
SyncingInkrementeller Sync läuft
ErrorSync-Fehler aufgetreten

Die Status-Karte zeigt auch den Sync-Pfad, die Anzahl der synchronisierten Instanzen und den aktuellen Apply-Modus (Auto/Manuell) an.

Sync-Richtungen

Zeigt Sync-Richtungen pro Typ in einer Tabelle:

SpalteBeschreibung
TypeSync-Zieltyp (Scripts, Values, Instances, Data, Services)
DirectionSync-Richtung (Lokal → Studio, Studio → Lokal)
Apply ModeApply-Modus (Auto/Manuell)

Das Sync-Log zeigt Sync-Ereignisse in chronologischer Reihenfolge. Jeder Log-Eintrag enthält ein Änderungstyp-Tag (create, update, delete, etc.) und den Zielpfad.

Changelog

Zeichnet alle Änderungen, die die KI in Roblox Studio vornimmt, nach Session auf und bietet eine Änderungszusammenfassung, Timeline und einen Vorher & Nachher-Vergleich.

Changelog — Liste der Session-Änderungskarten

Der Changelog verfolgt den Spieländerungsverlauf, den KI-Agenten in Studio durchführen. Änderungen werden nach Session gruppiert, sodass Sie auf einen Blick sehen können, welche Art von Änderungen passiert sind und wie viele in jeder Session.

Liste der Session-Karten

Jede Session-Karte zeigt einen Status:

StatusBedeutung
ActiveDerzeit laufende Session (aktualisiert in Echtzeit)
CompletedAbgeschlossene Session
BootstrapInitiale Sync-Session

Jede Karte zeigt eine Anzahl der Änderungen für diese Session pro Kategorie (Script, Instance, Property, Lighting, Terrain, Asset).

Verwenden Sie die oberen Tabs, um Sessions zu filtern: All, Active, Completed.

Session-Detailansicht

Klicken Sie auf eine Session-Karte, um die Detailansicht zu öffnen.

Änderungszusammenfassung: Visualisiert die Änderungen der Session als 6 Kategoriekarten (Scripts, Instances, Properties, Lighting, Terrain, Assets).

Änderungs-Timeline: Listet alle Änderungen der Session in chronologischer Reihenfolge auf. Verwenden Sie das Category-Dropdown, um nach einer bestimmten Kategorie zu filtern; klicken Sie auf einen Eintrag, um die Vorher & Nachher-Vergleichsansicht zu erweitern.

Vorher & Nachher

ConfidenceBedeutungBeispiel
exactVorher- und Nachher-Werte werden präzise aufgezeichnetEigenschaftsänderung, Skriptbearbeitung
partialNur Teilinformationen aufgezeichnetVerbundänderung
after-onlyNur der Nachher-Wert existiertErstellung einer neuen Instanz
intent-onlyNur die Absicht wird aufgezeichnetLöschung, etc.

Playtest

Prüfen Sie den Status und die Ergebnisse von Playtests, die die KI ausgeführt hat.

Playtest — Playtest-Status und Testverlauf

Die Playtest-Seite zeigt den Status und die Ergebnisse von Playtests, die die KI ausgeführt hat. Sie ist nur zugänglich, wenn das Dashboard im Status Studio verbunden ist.

Playtest-Status

StatusBedeutung
NotRunningPlaytest läuft nicht
RunningPlaytest läuft
PausedPlaytest ist pausiert (nur Run-Modus)

Testverlauf

Listet Testergebnisse aus KI-run_test-Action-Aufrufen in chronologischer Reihenfolge:

FeldBeschreibung
TimestampTestausführungszeit
Test ReportLink zum Testbericht
ModeAusführungsmodus (play/run)
DurationZeit, die der Test gedauert hat
StatusErgebnis (Bestanden/Fehlgeschlagen)

Klicken Sie auf einen Testbericht, um den detaillierten Markdown-Bericht und die Logs anzuzeigen.

Tools

Sehen Sie den Ausführungsverlauf und die Statistiken für MCP-Tools, die die KI ausgeführt hat.

Tools — Tool-Ausführungsverlauf und Statistiken

Die Tools-Seite zeigt den Ausführungsverlauf und die Statistiken für MCP-Tools, die die KI ausgeführt hat. Sie besteht aus zwei Untertabs: History und Statistics. Sie ist immer zugänglich, wenn das Dashboard im Status Server verbunden oder Studio verbunden ist.

History-Tab

Zeigt den Tool-Ausführungsverlauf in einer chronologischen Tabelle:

SpalteBeschreibung
TimeAusführungszeit
Tool.ActionAusgeführtes Tool und Action (z. B. query_instances.get_instance)
DurationZeit, die für die Ausführung benötigt wurde
StatusErgebnisstatus (OK/Error)
TierVerwendeter Tier (Basic/Pro)

Funktionen: Filtern Sie nach einem bestimmten Tool über das Tool-Dropdown, durchsuchen Sie große Verläufe mit Paginierung, neue Ausführungsdatensätze werden in Echtzeit hinzugefügt.

Statistics-Tab

Analysiert die Tool-Nutzungsstatistiken visuell:

  • Tier-Verteilung — Basic/Pro Tool-Nutzungsverhältnis
  • Statistik pro Tool — Aufrufanzahl und durchschnittliche Antwortzeit pro Tool
  • Analyse pro Action — detaillierte Statistiken pro Action innerhalb eines Tools

Basic-Tier-Benutzer sehen außerdem einen Tier Usage Progress-Balken und ein Basic vs Pro Vergleichs-Modal.

Settings

Lizenzinformationen, Servereinstellungen und Sprache anzeigen und verwalten.

Die Settings-Seite ermöglicht es Ihnen, Lizenzinformationen und Servereinstellungen anzuzeigen und zu ändern. Sie ist immer zugänglich, wenn das Dashboard im Status Server verbunden oder Studio verbunden ist.

Lizenz (Schreibgeschützt)

FeldBeschreibung
StatusStatus-Badge (Aktiv/Inaktiv)
TierAktueller Tier (Basic/Pro)
License KeyMaskierter Lizenzschlüssel
ProviderLizenzanbieter-Info

Allgemein

EinstellungBeschreibung
Log LevelLog-Ausgabeebene
History RecordingOb der Tool-Ausführungsverlauf gespeichert werden soll
Stats CollectionOb Tool-Nutzungsstatistiken gesammelt werden sollen
Request TimeoutAnfrage-Timeout (Sekunden)

Server-Umgebung (Schreibgeschützt)

UmgebungsvariableBeschreibungStandard
HTTP_PORTHTTP-Port3002
HTTP_HOSTHTTP-Host127.0.0.1
DASHBOARD_AUTO_OPENDashboard automatisch öffnentrue

Sprache

Ändern Sie die Sprache der Dashboard-Oberfläche. Unterstützt 7 Sprachen + Auto (automatische Erkennung aus dem Browser).

OptionSprache
AutoAutomatische Erkennung aus dem Browser
EnglishEnglisch
한국어Koreanisch
日本語Japanisch
EspañolSpanisch
PortuguêsPortugiesisch
Bahasa IndonesiaIndonesisch
DeutschDeutsch