Dashboard & Web UI

MCPlexer includes a built-in web dashboard for real-time monitoring, configuration management, and debugging. It's available at http://localhost:3333 when running the daemon or desktop app.

Dashboard

The main dashboard provides a real-time overview of your MCPlexer instance.

Metrics & Stats

• Active Sessions — currently connected clients with session IDs and workspace info
• Active Downstreams — running downstream server processes with state indicators
• Request Stats — total requests, success/error/blocked counts, average and P95 latency
• Time Series — request volume and latency plotted over time

Time Range Selector

Use the range selector to adjust the dashboard window:

Leaderboards & Breakdowns

• Tool Leaderboard — most frequently called tools ranked by volume
• Server Health — per-server success rates and latency
• Error Breakdown — errors grouped by type and downstream server
• Route Hit Map — which route rules are matching and how often

Approval Metrics

If tool approvals are configured, the dashboard shows:

• Pending, approved, denied, and timed-out approval counts
• Average wait time for approval resolution

Cache Stats

Cache performance for both layers:

• Tool Call Cache — hits, misses, and hit rate for cached tool responses
• Route Resolution Cache — hits, misses, and hit rate for cached route matches

Audit Logs

The Audit Logs page provides a searchable, filterable log of every tool call processed by MCPlexer.

Filters

• Session ID — narrow to a specific client session
• Workspace — filter by workspace
• Tool Name — search for specific tools (e.g., github__list_repos)
• Status — filter by success, error, or blocked
• Time Range — before/after date filters

Live Streaming

Audit logs support Server-Sent Events (SSE) for real-time streaming. The UI automatically connects to the SSE endpoint and appends new entries as they arrive.

Approvals

The Approvals page shows the pending approval queue. When a tool call requires manual approval, it appears here with full context — the tool name, arguments, workspace, and requesting session.

Approvals can be resolved directly from the UI:

• Approve — allow the tool call to proceed
• Deny — block the tool call with an optional reason

The approval stream uses SSE for real-time updates, so new approval requests appear instantly.

Dry Run

The Dry Run page lets you simulate route resolution without executing a tool call. Enter a workspace and tool name to see:

• Which route rule matches
• The downstream server that would handle the call
• The auth scope that would be applied
• The final policy decision (allow/deny)

This is invaluable for debugging "no matching route" issues.

Install MCP

The Install MCP page lets you manage MCPlexer's installation in your MCP client applications. It detects installed clients on your machine and shows their configuration status.

Supported clients:

• Claude Desktop — Claude's desktop application
• Claude Code — Claude's CLI tool
• Cursor — AI-powered code editor
• Windsurf — Codeium's AI editor
• Codex — OpenAI's CLI agent
• OpenCode — open-source AI coding tool
• Gemini CLI — Google's Gemini CLI

For each detected client, you can:

• Preview — see what the config file will look like before writing
• Install — write the MCPlexer server entry to the client's config
• Uninstall — remove the MCPlexer entry

For unsupported clients, a copyable JSON snippet is provided.

Settings

The Settings page controls runtime behavior of the MCPlexer gateway.

Tool Display

• Slim Tools — minify tool schemas by stripping property descriptions to reduce AI context window consumption (default: on)
• Codex Dynamic Tool Compat — automatically include dynamic-discovery tools in tools/list for Codex sessions, since Codex doesn't support the load_tools pattern (default: on)

Caching

• Tools List Cache TTL — how long the aggregated tools/list response is cached before re-querying downstream servers (0–300 seconds, default: 15)

Logging

• Log Level — runtime log verbosity: debug, info, warn, error

Built-in Tool Description Overrides

Customize the descriptions for MCPlexer's built-in tools (mcpx__search_tools, mcpx__load_tools, etc.). Useful for tailoring the description to work better with specific AI models. Clear a field to reset to the default.

Quick Setup

The Quick Setup wizard walks you through configuring OAuth for a downstream server. It handles OAuth provider creation, auth scope configuration, and the authorization flow in a single guided process.

Configuration Pages

The web UI includes dedicated management pages for each resource type:

Workspaces

Create, edit, and delete workspaces. Set root paths, default policies, and tags.

Downstream Servers

Manage downstream MCP server definitions. Configure commands, arguments, environment variables, and transport settings. Trigger tool discovery to refresh the tool list from a running server.

Routes

Create and manage route rules. Set tool patterns, workspace assignments, priorities, and path globs. Supports bulk creation for quickly enabling multiple tools.

Credentials (Auth Scopes)

Manage auth scopes with environment variable injection and OAuth token configuration. View OAuth token status and trigger re-authorization flows.

OAuth Providers

Configure OAuth providers from built-in templates or custom OIDC discovery. Manage client IDs, secrets, scopes, and callback URLs.