Skip to main content

Web UI Overview

The MCP Web UI is a Next.js 15 application that provides a graphical interface for managing all MCP server permissions. Instead of editing YAML files by hand, you can toggle permissions, manage users, and browse audit logs through a dashboard.

Web UI Dashboard

Architecture​

The Web UI runs as a Docker container alongside the MCP servers. It reads and writes YAML configuration files directly on the host filesystem, and reads audit log files from the shared log directory. Changes take effect in real time: MCP servers detect config file changes via watchfiles and reload within 1 second.

Browser ──HTTPS──▶ Cloudflare Tunnel ──▶ mcp-webui (port 8280)
│
┌─────────────────┼─────────────────┐
▼ ▼ ▼
configs/*.yaml /var/log/mcp/* /var/run/docker.sock
(read/write) (read-only) (container status)

Features​

FeatureDescription
DashboardServer status cards, health indicators, bulk enable/disable, usage statistics
Server ConfigPer-server path tree, command rules, tool rules with access toggles
Folder ScanningAuto-discover folder structures and add permission rules in bulk
Agent ManagementManage users, access modes (open/allowlist/blocklist), SSH key generation
Audit Log ViewerFilter, paginate, and inspect every access decision
SettingsConfigure scan intervals, UI section visibility, page sizes
Usage StatsRequest counts by server, tool, user, and date range

Tech Stack​

LayerTechnology
FrameworkNext.js 16 (App Router)
LanguageTypeScript (strict mode)
StylingTailwind CSS v4
ChartsRecharts v3
Authiron-session (encrypted cookies)
Configjs-yaml
Notificationssonner (toast)

Accessing the Web UI​

Navigate to http://<your-server>:8280 and log in with your WEBUI_API_KEY from .env.

For secure remote access, route through Cloudflare Tunnel. See Cloudflare Tunnel for setup instructions.

Pages​

PageRoutePurpose
Login/loginAPI key authentication
Dashboard/Server overview, health, stats
Server Detail/<server>Path/command/tool permissions
Agents/agentsUser management
Settings/settingsApp configuration