WEPPY

MCPダッシュボードガイド

サーバー状態、接続、Sync、Changelog、Playtest、ツール履歴をWebダッシュボードで確認する方法。

MCPサーバーの状態、接続、同期、ツール実行履歴、ゲーム変更履歴をWebブラウザでリアルタイムに確認・管理します。

ダッシュボードOverview — サーバー状態、最近の変更、セッション要約を一目で確認

Overview

ダッシュボードはMCPサーバーが提供するWebベースのモニタリングインターフェースです。MCPサーバーが起動すると自動的にブラウザで開き、AIエージェントがRoblox Studioで行うすべての作業をリアルタイムで追跡できます。

  • ターミナルログを探さなくても視覚的に状態を把握
  • AIがStudioで何を変更したか変更履歴で追跡
  • 同期状態、接続状態、ツール実行統計を一か所で確認

アクセス方法

MCPサーバーが起動するとダッシュボードが自動的にブラウザで開きます。手動でアクセスするには:

http://localhost:3002

DASHBOARD_AUTO_OPEN=false に設定すると自動起動を無効にできます。

接続状態別の利用可能機能

状態条件利用可能なページ
サーバー切断サーバー未接続再接続待機画面のみ表示
サーバー接続済みサーバー接続、プラグイン未接続Connection、Tools、Settings
Studio接続済みサーバー+プラグイン共に接続すべてのページ

ステータスカード

OverviewページはダッシュボードのトップページでシステムSales全体の状態を一目で表示します。

カード表示情報
Serverサーバー接続状態(Online/Offline)
Pluginプラグイン接続状態、プレイス情報
Agent現在接続しているAIエージェント名
Sync同期状態(Idle/Syncing/Error)

最近のゲーム変更(Recent Game Changes)

AIがStudioで行った最近の変更をリアルタイムで表示します(最大20件)。各項目は変更カテゴリアイコンと共に表示され、クリックするとChangelogの詳細ビューに移動します。

カテゴリアイコン:

  • Script — スクリプト作成・変更
  • Instance — インスタンス作成・削除・移動
  • Property — プロパティ変更
  • Lighting — ライティング・環境設定
  • Terrain — 地形変更
  • Asset — アセット挿入

ダッシュボードはSSE(Server-Sent Events)を使用してリアルタイムにデータを更新します。SSE接続が切れた場合は3秒後に自動再接続します。

Connection

MCPサーバー、接続中のAIエージェント、Studio Targets、接続ログを一か所で確認します。

Connectionページ — AIエージェント、MCPサーバー、Studio Targetsのトポロジーマップ

Connectionページは、現在のローカルMCPランタイムがどのように接続されているかを最も早く把握できる画面です。ダッシュボードがサーバー接続済みまたはStudio接続済み状態であれば使用できます。

Connection Topology

Topology mapは AI Agents → MCP Server → Studio Targets の3つの概念列を表示します。これは表示優先のマップであり、接続線はMCPサーバーに何が接続されているかを示しますが、線自体はルーティングを変更しません。

MCP Serverノードにはサーバー状態と、特定のStudioを指定しない要求に適用される現在のルーティング概要が表示されます。

Studio Targets

Studio Targetsは、MCP要求を受け取れる接続中のRoblox Studioウィンドウです。各ターゲットには次の情報が表示されます。

項目意味
Studio IDstudio-1 のような短いセレクタ。エージェントのプロンプトにコピーできます
Place / Place IDそのStudioウィンドウに関連付けられたRoblox Place
Connection ID診断用の完全な接続識別子
Last Used / Last SeenWEPPYがそのターゲットへ作業をルーティングした時刻と最後に通信した時刻
Routing現在 Priority または Pinned 対象かどうか
In Flightそのターゲットで要求が実行中かどうか

特定のStudioウィンドウに作業を向けるには、Studio IDをコピーして Studio ID studio-1を使って のように依頼します。

Studio Routing

Studio Routingは、特定のStudioを指定しない要求にのみ影響します。

  • Automatic: Recent priority は優先度が最も高いアクティブなStudio Targetを選択します。単なるheartbeatではなく、最近ルーティングされた作業が優先度に反映されます。
  • Manual: Pinned Studio は、Studioを指定しない要求をpinnedされた接続先に送ります。
  • エージェント要求にStudio ID、Connection ID、Place IDが明示されている場合は、ダッシュボードのrouting modeより常に優先されます。

Connectionには現在のモードと Manage routing リンクだけが表示されます。モードやpinned targetの変更は Controls → Studio Routing で行います。

マルチエージェントとマルチStudio作業

複数のエージェントや複数のStudioウィンドウを同時に使う場合は、このページを確認します。Claude Code、Codex、Geminiなどのエージェントを同時に接続でき、複数のRoblox Studioウィンドウを個別のStudio Targetとして見分けられます。

プロンプトでは対象を明確に指定すると安全です。

  • Studio ID studio-1を使ってこの変更をして。
  • WorldではなくLobby Placeで実行して。
  • 共有スクリプトを変更する前にstudio-2を確認して。

1つのエージェントがスクリプトを編集し、別のエージェントがUIを確認する場合や、同じ体験の複数Placeを別々のStudioウィンドウで開く場合に便利です。

診断情報

下部の診断テーブルでは、Server Status、AI Agents、Studio Targets、Connection Logの詳細を引き続き確認できます。識別子のコピー、作業ディレクトリの確認、接続/切断イベントの確認に使います。

Sync

Studio ↔ ローカルファイル同期の現在の状態、方向設定、ログを監視します。

SyncページはStudio ↔ ローカルファイル同期の現在の状態と設定を視覚的に表示します。ダッシュボードがStudio接続済み状態のときのみアクセスできます。

Sync Status

状態意味
Idle同期待機中
Initializing初期同期進行中
Syncing増分同期進行中
Error同期エラー発生

状態カードには同期パス、同期済みインスタンス数、現在の適用モード(Auto/Manual)が一緒に表示されます。

Sync Directions

タイプ別同期方向をテーブルで表示します:

説明
Type同期対象タイプ(Scripts、Values、Instances、Data、Services)
Direction同期方向(Local → Studio、Studio → Local)
Apply Mode適用モード(Auto/Manual)

Sync Logで同期イベントを時系列で確認できます。各ログ項目には変更タイプタグ(create、update、deleteなど)と対象パスが含まれます。

Changelog

AIがRoblox Studioで行ったすべての変更をセッション単位で記録し、変更概要・タイムライン・Before & Afterを提供します。

Changelog — セッション別変更カードの一覧

ChangelogはAIエージェントがStudioで行ったゲーム変更の履歴を追跡するページです。変更はセッション単位でグループ化され、各セッションでどの種類の変更が何件発生したかを一目で把握できます。

セッションカード一覧

各セッションカードにはステータスが表示されます:

ステータス意味
Active現在進行中のセッション(リアルタイム更新)
Completed完了したセッション
Bootstrap初期同期セッション

各カードには該当セッションの変更件数がカテゴリ別に要約されます(Script、Instance、Property、Lighting、Terrain、Asset)。

上部タブでセッションをフィルタリングできます: AllActiveCompleted

セッション詳細ビュー

セッションカードをクリックすると詳細ビューに移動します。

Change Summary: セッションの変更を6つのカテゴリカード(Scripts、Instances、Properties、Lighting、Terrain、Assets)で可視化します。

Change Timeline: セッション内のすべての変更を時系列で列挙します。Categoryドロップダウンで特定カテゴリのみフィルタリングでき、項目をクリックするとBefore & After比較ビューが展開します。

Before & After

信頼度意味
exact変更前後の値が正確に記録プロパティ変更、スクリプト修正
partial一部情報のみ記録複合変更
after-only変更後の値のみ存在新規インスタンス作成
intent-only意図のみ記録削除など

Playtest

AIが実行したプレイテストの状態とテスト結果を確認します。

Playtest — プレイテスト状態とテスト履歴

PlaytestページはAIが実行したプレイテストの状態とテスト結果を表示します。ダッシュボードがStudio接続済み状態のときのみアクセスできます。

Playtest Status

状態意味
NotRunningプレイテスト未実行
Runningプレイテスト実行中
Pausedプレイテスト一時停止(Runモード)

Test History

AIが run_test アクションで実行したテスト結果を時系列で一覧表示します:

項目説明
タイムスタンプテスト実行時刻
Test Reportテストレポートへのリンク
Mode実行モード(play/run)
Durationテスト所要時間
Status結果(Passed/Failed)

テストレポートをクリックするとMarkdown形式の詳細レポートとログを確認できます。

Tools

AIが実行したMCPツールの履歴と統計を確認します。

Tools — ツール実行履歴と統計

ToolsページはAIが実行したMCPツールの履歴と統計を提供します。HistoryStatistics の2つのサブタブで構成されます。ダッシュボードがサーバー接続済みまたはStudio接続済み状態であれば常にアクセスできます。

Historyタブ

ツール実行履歴を時系列テーブルで表示します:

説明
Time実行時刻
Tool.Action実行されたツールとアクション(例: query_instances.get_instance
Duration実行所要時間
Status結果ステータス(OK/Error)
Tier使用されたティア(Basic/Pro)

機能: Toolフィルタードロップダウンで特定ツールのみフィルタリング、ページネーションで大量の履歴を探索、リアルタイムで新しい実行履歴を追加。

Statisticsタブ

ツール使用統計を視覚的に分析します:

  • ティア分布 — Basic/Proツール使用割合
  • ツール別統計 — 各ツールの呼び出し回数、平均応答時間
  • アクション別分析 — ツール内アクション別の詳細統計

BasicティアのユーザーにはTier Usage ProgressバーとBasic vs Pro比較モーダルが追加表示されます。

Settings

ライセンス情報、サーバー設定、言語を確認・管理します。

SettingsページではライセンスInformation とサーバー設定を確認し、一部を変更できます。ダッシュボードがサーバー接続済みまたはStudio接続済み状態であれば常にアクセスできます。

License(読み取り専用)

項目説明
Status状態バッジ(Active/Inactive)
Tier現在のティア(Basic/Pro)
License Keyマスクされたライセンスキー
Providerライセンスプロバイダー情報

General

設定説明
Log Levelログ出力レベル
History Recordingツール実行履歴の保存有無
Stats Collectionツール統計の収集有無
Request Timeoutリクエストタイムアウト(秒)

Server Environment(読み取り専用)

環境変数説明デフォルト値
HTTP_PORTHTTPポート3002
HTTP_HOSTHTTPホスト127.0.0.1
DASHBOARD_AUTO_OPENダッシュボード自動起動true

Language

ダッシュボードUIの言語を変更します。6言語 + Auto(ブラウザ言語の自動検出)をサポートします。

オプション言語
Autoブラウザ言語の自動検出
English英語
한국어韓国語
日本語日本語
Españolスペイン語
Portuguêsポルトガル語
Bahasa Indonesiaインドネシア語