Managing MCPs
The MCPs page lets you register, configure, and monitor your Model Context Protocol servers.
MCP List View
The main MCPs page shows all registered servers:
| Column | Description |
|---|---|
| Name | Display name you assigned |
| Status | Health status indicator |
| Endpoint | Server URL |
| Requests | Total requests processed |
| Last Active | Most recent activity |
Status Indicators
- Healthy (green): MCP is responding normally
- Unhealthy (red): MCP is not responding
- Unknown (gray): Status check pending
Adding an MCP
-
Click Add MCP button
-
Fill in the details:
Field Required Description Name Yes Friendly display name Endpoint URL Yes Your MCP server URL Description No Notes for your team Auth Type No Authentication method Auth Token No Token/credentials if needed -
Click Test Connection to verify
-
Click Create MCP to save
MCP Detail View
Click any MCP to see its details:
Overview Tab
- Basic information
- Health status
- Quick stats (requests, errors, latency)
Tools Tab
Lists all tools exposed by the MCP:
- Tool names and descriptions
- Input schema
- Quick test button
Analytics Tab
Usage metrics for this MCP:
- Request volume over time
- Error rate
- Average latency
- Top tools by usage
Settings Tab
Configure the MCP:
- Edit name and description
- Update endpoint URL
- Change authentication
- Enable/disable health checks
Logs Tab
Recent activity and errors:
- Request timestamps
- Tool invocations
- Error messages
- Response times
Testing an MCP
From the MCP detail page:
- Go to Tools tab
- Select a tool to test
- Fill in any required arguments
- Click Run Test
- View the response
This is useful for:
- Verifying new MCPs work correctly
- Debugging issues
- Understanding tool behavior
Editing an MCP
- Click the MCP to open details
- Go to Settings tab
- Click Edit
- Make your changes
- Click Save
Disabling an MCP
Temporarily stop routing requests:
- Open MCP details
- Go to Settings tab
- Toggle Active to off
- The MCP will return errors until re-enabled
This is useful for:
- Maintenance windows
- Investigating issues
- Temporarily blocking access
Deleting an MCP
Permanently remove an MCP:
- Open MCP details
- Go to Settings tab
- Scroll to Danger Zone
- Click Delete MCP
- Confirm by typing the MCP name
Deleting an MCP is permanent. Any API keys with access will fail when calling this MCP.
Health Monitoring
PlexMCP automatically checks MCP health:
- Check Interval: Every 60 seconds
- Timeout: 30 seconds
- Retries: 3 attempts before marking unhealthy
Health Check Behavior
When an MCP becomes unhealthy:
- Status changes to red
- Alert notification sent (if configured)
- Requests continue (may fail)
- Health checks continue
When an MCP recovers:
- Status changes to green
- Recovery notification sent
- Normal operation resumes
Bulk Operations
Select multiple MCPs for bulk actions:
- Check the boxes next to MCPs
- Use the bulk action dropdown:
- Enable All: Activate selected
- Disable All: Deactivate selected
- Delete All: Remove selected (with confirmation)
Import/Export
Export MCPs
Download your MCP configuration:
- Click Export button
- Choose format (JSON or CSV)
- Download the file
Import MCPs
Upload MCP configurations:
- Click Import button
- Select your file
- Review the import preview
- Confirm to create MCPs
Best Practices
- Use Descriptive Names: Make it easy to identify MCPs
- Add Descriptions: Document what each MCP does
- Monitor Health: Check the dashboard regularly
- Set Up Alerts: Enable notifications for outages
- Use HTTPS: Always use secure endpoints
- Rotate Tokens: Update authentication regularly