After installation, the first thing to do is verify that the connection is live. Of the two methods below, check the plugin first. The plugin’s Connect button is the most direct indicator, and you’ll notice immediately when a connection is lost.

1. Check via Plugin (Recommended)2. Check via Dashboard When Connection Fails

1. Check via Plugin (Recommended)

Open Roblox Studio and check the plugin’s Connect status — that’s all you need. Once the MCP installation is complete, the plugin is automatically placed in the Roblox Studio Plugins folder the first time the MCP server runs.

Step 1 — Find the WEPPY Button in the Plugins Tab

When you open Roblox Studio, the WEPPY button appears in the top Plugins tab.

Step 2 — Open the WEPPY Panel and Click Connect

Click the WEPPY button to open the panel. Click Connect to connect to the MCP server. Once connected, the status indicator at the top changes to Connected.

WEPPY plugin main screen — Connect button and connection status

What to Verify

The top status indicator shows Connected
If there is an active session, the session label is visible

Plugin Settings

The plugin settings screen lets you adjust the following options.

Auto Connect — Automatically connect to the MCP server when Studio starts
Auto Reconnect — Automatically retry when the connection is lost
Language — Change the plugin UI language

Plugin settings screen — Auto Connect, Auto Reconnect, and Language options

2. Check via Dashboard

Even when the plugin is connected, use the dashboard if you want to see which AI agents are attached, what working directory they are using, and how connection logs are flowing. The dashboard opens automatically at http://localhost:3002 when the MCP server starts.

Connection page — server status, AI agents, and plugin connection info

Server Status

Displays core server information.

Field	Description
Status	Connection status badge (Online / Offline)
Version	MCP server version
PID	Server process ID
Uptime	Server uptime
Session ID	Current session identifier
Exec Path	Server executable path

AI Agents

The list of currently connected AI agents. All agents are shown even if multiple are connected simultaneously.

Column	Description
Name	Agent name (e.g., Claude Code)
PID	Agent process ID
Working Dir	Agent working directory
Connected	Time since connection

Plugins

The list of connected Roblox Studio plugins. In a multi-place environment, each Place is listed separately.

Column	Description
Place	Place name
Client ID	Plugin client identifier
Last Seen	Time of last communication
Version	Plugin version

Connection Log

Displays connection-related events in real time. Agent and plugin connect/disconnect events are appended automatically via SSE.

Dashboard Guide →

3. When Connection Fails

If neither method above shows a connection, check in the following order.

Plugin Not Visible

Fully quit Roblox Studio and relaunch it
Check that the WEPPY plugin file is present in the auto-installed Plugins folder
If auto-install didn’t work, see the Plugin Installation Guide for manual installation steps

Connect Fails in the Plugin Panel

Verify that your AI app is actually running the MCP server. You can also run it directly:
```
npx -y @weppy/roblox-mcp
```
Check that port 3002 is available — quit any process occupying it
Make sure no firewall, antivirus, or VPN is blocking localhost:3002
Check that the Auto Reconnect option is enabled in the plugin settings
If none of the above works, restart both Roblox Studio and the MCP server

Dashboard Doesn’t Open

Check the AI app console logs to verify the MCP server started successfully
Open http://localhost:3002 directly in your browser
The server only binds to 127.0.0.1. It cannot be accessed from any other host.

Agent Not Registering

Review the per-agent setup guide for your AI app to re-check the MCP registration steps
Fully quit your AI app and relaunch it (Codex CLI, Cursor, and Claude Desktop all require a restart when registration changes)

Troubleshooting Guide →Review Installation

Check Connections