MCP Integration
Connect AI clients to your PodWarden infrastructure via the Hub MCP server
What you see
URL: /dashboard/mcp (requires login)
The MCP page lets you connect AI clients — Claude Desktop, Claude Code, Cursor, or Windsurf — to your PodWarden infrastructure through the Hub MCP server. Hub acts as a tunnel, routing MCP tool calls from your AI client to your connected PodWarden instances.
Summary stats
Three stat cards at the top:
| Card | Shows |
|---|---|
| Connected Instances | PodWarden instances currently connected to Hub |
| Total Tools Available | Sum of all MCP tools exposed by connected instances |
| Active API Keys | Number of active Hub API keys |
Hub API Keys
Lists your Hub API keys (pwc_ prefix) with the ability to create, re-issue, or revoke. These keys authenticate both your AI client to Hub and your PodWarden instances to the Hub tunnel.
PodWarden Instances
Lists all PodWarden instances that have connected to Hub. Each shows:
| Field | Description |
|---|---|
| Name | Instance display name |
| Version | PodWarden version |
| Status | connected or disconnected |
| Tool count | Number of MCP tools exposed |
| Available tools | Expandable list grouped by prefix |
Connection instructions
Copy-paste config snippets for Claude Desktop, Claude Code, Cursor, and Windsurf. All snippets use the Hub MCP endpoint at https://mcp.podwarden.com/mcp and require a pwc_ API key in the Authorization header.
How it works
- Connect your instance — Configure Hub URL and API key in PodWarden Settings, then enable Hub Tunnel in MCP settings
- Choose access level — Set MCP access level to read-only or full
- Connect your AI client — Use the config snippets
- Manage via AI — List instances, browse tools, execute commands
Available actions
| Action | Where | What it does |
|---|---|---|
| Create Key | API Keys section | Create a new Hub API key |
| Copy | Key banner | Copy key to clipboard |
| Re-issue | Refresh icon | Generate new key, invalidate old |
| Revoke | Trash icon | Permanently deactivate key |
| Refresh | Instances section | Refresh instance and key lists |
| Show/Hide tools | Per instance | Expand/collapse tool list |
| Copy config | Connection instructions | Copy config snippet |
Status badges
| Badge | Meaning |
|---|---|
| connected | Instance is online and reachable via Hub |
| disconnected | Instance is not currently connected |
| active | API key is valid |
| revoked | API key has been revoked |
Related docs
- API Keys — Manage Hub API keys
- Settings: MCP — Configure MCP on your PodWarden instance
- Settings: Hub — Connect your instance to Hub
- Hub MCP Proxy — Detailed setup guide