Skip to main content

Installation & Setup

Get ClaudusBridge running in your Unreal Engine project in under 5 minutes.

Requirements​

RequirementDetails
Unreal Engine5.4 or newer (tested on 5.7)
PlatformsWindows, macOS, Linux
AI ClientAny MCP-compatible client (Claude Desktop, Cursor, Windsurf, etc.)
NetworkLocal only — no internet required at runtime

Step 1: Install the Plugin​

From Fab Marketplace​

  1. Purchase ClaudusBridge on Fab
  2. In the Epic Games Launcher, go to your Library
  3. Find ClaudusBridge under Vault and click Install to Engine
  4. Open your UE project — the plugin will be available

Manual Installation​

  1. Extract the ClaudusBridge folder into your project's Plugins/ directory: 
    YourProject/
    └── Plugins/
        └── ClaudusBridge/
            ├── ClaudusBridge.uplugin
            ├── Source/
            ├── Resources/
            └── ...
  2. Rebuild your project (or let the editor compile on startup)

Step 2: Verify Installation​

  1. Open your project in Unreal Editor
  2. Go to Edit > Plugins and search for "ClaudusBridge"
  3. Ensure it is enabled (it's enabled by default)
  4. Restart the editor if prompted

After restart, you should see the ClaudusBridge tab in the editor. If not, go to Window > ClaudusBridge to open it.

Step 3: Verify the MCP Server​

The MCP HTTP server starts automatically on port 3000.

Check via Dashboard​

Open the ClaudusBridge panel in the editor. You should see:

  • Connection: Listening
  • MCP HTTP Server: Port 3000, Status: Running

Check via Terminal​

curl http://localhost:3000/health

Expected response:

{"status": "healthy", "plugin": "ClaudusBridge", "version": "0.2.0"}

Step 4: Configure (Optional)​

Change the Port​

Go to Project Settings > Plugins > ClaudusBridge:

SettingDefaultDescription
MCP Server Port3000HTTP port for MCP connections
Auto Start MCPtrueStart server when editor loads

CORS Settings​

By default, CORS is enabled for all origins. This allows any local AI client to connect.

Troubleshooting​

ProblemSolution
Plugin not visibleEnsure ClaudusBridge.uplugin is in Plugins/ folder, restart editor
Port 3000 in useChange port in Project Settings, or close the other application
Health check failsCheck Output Log for ClaudusBridge errors; ensure firewall allows localhost:3000
Dashboard shows "Disconnected"The MCP server may have failed to start — check Output Log

Next Steps​

Now that ClaudusBridge is running, connect your AI client.