Eine Schritt-für-Schritt-Anleitung zur Eingrenzung von Verbindungs-, Berechtigungs-, Sync- und Validierungsproblemen.

Plugin verbindet sich nicht

Symptom: “Verbindung fehlgeschlagen” oder das Plugin wird in Roblox Studio als getrennt angezeigt.

Bestätigen Sie, dass der MCP-Server läuft: npx -y @weppy/roblox-mcp@latest
Roblox Studio: Plugins-Tab → WEPPY → klicken Sie auf Connect
Stellen Sie sicher, dass keine Firewall, kein Antivirus oder VPN localhost:3002 blockiert
Starten Sie sowohl Roblox Studio als auch den MCP-Server neu

KI-Client erkennt MCP-Server nicht

Prüfen Sie, ob der korrekte Befehl in den KI-Client-Einstellungen verwendet wird: npx -y @weppy/roblox-mcp@latest
Bestätigen Sie, dass Node.js 18 oder höher installiert ist: node --version
Wenn Sie unter Windows einen Berechtigungsfehler erhalten, versuchen Sie, das Terminal als Administrator auszuführen
Prüfen Sie die Installationsanleitung für Ihre KI-App

Hinweis “Pro-Funktion erforderlich”

Wenn auf Basic eine Pro-exklusive Action angefordert wird, versucht WEPPY nach Möglichkeit, eine Umgehung zu finden. Der Umgehungsfluss verbraucht jedoch zusätzliche Token und liefert nicht immer identische Ergebnisse.

Einige Pro-exklusive Tools haben keine verfügbare Umgehung und können auf Basic nicht ausgeführt werden. Wenn dieser Hinweis wiederholt erscheint, prüfen Sie, ob die angeforderte Action in Ihrem aktuellen Plan verfügbar ist.

Sync funktioniert nicht

Sync-Status prüfen: bitten Sie die KI, manage_sync status auszuführen
Bestätigen Sie, dass das Plugin verbunden ist, bevor Sie Sync starten
Wenn Reverse-Sync (Datei → Studio) nicht funktioniert, überprüfen Sie, ob der Pro-Tier aktiv ist
Bestätigen Sie, dass der lokale Sync-Ordner existiert und Schreibrechte hat

Siehe Bidirektionaler Sync für detaillierte Sync-Konfiguration.

Kompatible KI-Clients

Client
Claude Code
Claude Desktop
Cursor
Codex CLI
Codex Desktop
Gemini CLI
Jede MCP-kompatible App

Server-Befehl: npx -y @weppy/roblox-mcp@latest

Systemanforderungen

Element	Minimum
Node.js	18.0.0 oder höher
Roblox Studio	Neueste Version (Auto-Update aktiviert lassen)
Betriebssystem	Windows 10+ oder macOS 12+
Netzwerk	localhost:3002 muss zugänglich sein

Häufige Fehlermeldungen

Fehler	Ursache	Behebung
`ECONNREFUSED localhost:3002`	MCP-Server läuft nicht	Führen Sie `npx -y @weppy/roblox-mcp@latest` aus
`Timeout waiting for plugin`	Studio-Plugin nicht verbunden	Klicken Sie im Plugin-Panel auf Connect
`Forbidden path`	Versuchter Zugriff auf CoreGui/CorePackages	Verwenden Sie nur gültige Instanzpfade
`Place ID mismatch`	Falscher Place verbunden	Erneut aus der korrekten Studio-Session verbinden

Hilfe benötigt?

Wenn das Problem immer noch nicht gelöst ist, öffnen Sie ein GitHub Issue mit den folgenden Informationen:

Betriebssystem und Node.js-Version
KI-Client und Version
Fehlermeldung oder Logs
Schritte, die Sie bereits versucht haben

Geben Sie in einem öffentlichen Issue keine rohen Lizenzschlüssel, Belege, E-Mail-Adressen, Zahlungsdaten oder privaten Projektdaten an. Schreiben Sie an [email protected], wenn die Anfrage Kauf-, Lizenz-, E-Mail-, Zahlungs- oder private Projektinformationen enthält.

Fehlerbehebung