Nach der Installation sollten Sie als Erstes überprüfen, ob die Verbindung aktiv ist. Von den beiden untenstehenden Methoden sollten Sie zuerst das Plugin prüfen. Die Connect-Schaltfläche des Plugins ist der direkteste Indikator, und Sie werden sofort bemerken, wenn eine Verbindung verloren geht.
1. Über Plugin prüfen (Empfohlen)
Öffnen Sie Roblox Studio und prüfen Sie den Connect-Status des Plugins — mehr brauchen Sie nicht. Sobald die MCP-Installation abgeschlossen ist, wird das Plugin beim ersten Start des MCP-Servers automatisch im Roblox Studio Plugins-Ordner platziert.
Schritt 1 — WEPPY-Schaltfläche im Plugins-Tab finden
Wenn Sie Roblox Studio öffnen, erscheint die WEPPY-Schaltfläche im oberen Plugins-Tab.

Schritt 2 — WEPPY-Panel öffnen und auf Connect klicken
Klicken Sie auf die WEPPY-Schaltfläche, um das Panel zu öffnen. Klicken Sie auf Connect, um sich mit dem MCP-Server zu verbinden. Sobald verbunden, ändert sich die Statusanzeige oben zu Connected.

Was zu prüfen ist
- Die obere Statusanzeige zeigt Connected
- Wenn eine aktive Session vorhanden ist, ist das Session-Label sichtbar
Plugin-Einstellungen
Auf dem Plugin-Einstellungsbildschirm können Sie die folgenden Optionen anpassen.
- Auto Connect — Automatisch mit dem MCP-Server verbinden, wenn Studio startet
- Auto Reconnect — Bei Verbindungsverlust automatisch erneut versuchen
- Language — Ändert die Sprache der Plugin-Oberfläche

2. Über Dashboard prüfen
Auch wenn das Plugin verbunden ist, verwenden Sie das Dashboard, wenn Sie sehen möchten, welche KI-Agenten angeschlossen sind, welches Arbeitsverzeichnis sie verwenden und wie die Verbindungsprotokolle fließen. Das Dashboard öffnet sich automatisch unter http://localhost:3002, wenn der MCP-Server startet.

Serverstatus
Zeigt zentrale Serverinformationen an.
| Feld | Beschreibung |
|---|---|
| Status | Verbindungsstatus-Badge (Online / Offline) |
| Version | MCP-Server-Version |
| PID | Server-Prozess-ID |
| Uptime | Server-Laufzeit |
| Session ID | Aktuelle Session-Kennung |
| Exec Path | Server-Ausführungspfad |
KI-Agenten
Die Liste der derzeit verbundenen KI-Agenten. Alle Agenten werden angezeigt, auch wenn mehrere gleichzeitig verbunden sind.
| Spalte | Beschreibung |
|---|---|
| Name | Name des Agenten (z. B. Claude Code) |
| PID | Agent-Prozess-ID |
| Working Dir | Arbeitsverzeichnis des Agenten |
| Connected | Zeit seit der Verbindung |
Plugins
Die Liste der verbundenen Roblox Studio Plugins. In einer Multi-Place-Umgebung wird jeder Place separat aufgelistet.
| Spalte | Beschreibung |
|---|---|
| Place | Name des Place |
| Client ID | Plugin-Client-Kennung |
| Last Seen | Zeit der letzten Kommunikation |
| Version | Plugin-Version |
Verbindungsprotokoll
Zeigt verbindungsbezogene Ereignisse in Echtzeit an. Agent- und Plugin-Verbindungs-/Trennungsereignisse werden automatisch über SSE angehängt.
3. Wenn die Verbindung fehlschlägt
Wenn keine der oben genannten Methoden eine Verbindung anzeigt, prüfen Sie in der folgenden Reihenfolge.
Plugin nicht sichtbar
- Beenden Sie Roblox Studio vollständig und starten Sie es neu
- Prüfen Sie, ob die WEPPY-Plugin-Datei im automatisch installierten Plugins-Ordner vorhanden ist
- Wenn die automatische Installation nicht funktioniert hat, siehe die Plugin-Installationsanleitung für manuelle Installationsschritte
Connect schlägt im Plugin-Panel fehl
-
Überprüfen Sie, ob Ihre KI-App tatsächlich den MCP-Server ausführt. Sie können ihn auch direkt ausführen:
npx -y @weppy/roblox-mcp -
Prüfen Sie, ob der Port
3002verfügbar ist — beenden Sie alle Prozesse, die ihn belegen -
Stellen Sie sicher, dass keine Firewall, kein Antivirus oder VPN
localhost:3002blockiert -
Prüfen Sie, ob die Option Auto Reconnect in den Plugin-Einstellungen aktiviert ist
-
Wenn nichts davon funktioniert, starten Sie sowohl Roblox Studio als auch den MCP-Server neu
Dashboard öffnet sich nicht
- Prüfen Sie die KI-App-Konsolenprotokolle, um zu überprüfen, ob der MCP-Server erfolgreich gestartet wurde
- Öffnen Sie
http://localhost:3002direkt in Ihrem Browser - Der Server bindet sich nur an
127.0.0.1. Er ist von keinem anderen Host aus erreichbar.
Agent registriert sich nicht
- Schauen Sie sich die Setup-Anleitung pro Agent für Ihre KI-App an, um die MCP-Registrierungsschritte erneut zu prüfen
- Beenden Sie Ihre KI-App vollständig und starten Sie sie neu (Codex CLI, Cursor und Claude Desktop benötigen alle einen Neustart, wenn sich die Registrierung ändert)