Skip to main content

​
Installation

​
Initial Setup

​
1. Access the Dashboard

Open your browser and navigate to: 
http://localhost:3000

​
2. Login

Use the default credentials:
  • Username: admin
  • Password: admin123
Change these default credentials immediately after first login for security.

​
3. Configure Your First MCP Server

  1. Click “Add Server” in the dashboard
  2. Enter server details:
    • Name: A unique identifier (e.g., fetch)
    • Command: The executable command (uvx)
    • Args: Command arguments (["mcp-server-fetch"])
    • Environment: Any required environment variables
Example configuration for a fetch server: 
{
  "name": "fetch",
  "command": "uvx",
  "args": ["mcp-server-fetch"],
  "env": {}
}

​
Basic Usage

​
Connecting AI Clients

Once your servers are configured, connect your AI clients using MCPHub endpoints:
  • All Servers
  • Specific Group
  • Individual Server
  • Smart Routing
Access all configured MCP servers: http://localhost:3000/mcp
Here are some popular MCP servers you can add: 
{
  "name": "fetch",
  "command": "uvx",
  "args": ["mcp-server-fetch"]
}

{
  "name": "playwright",
  "command": "npx",
  "args": ["@playwright/mcp@latest", "--headless"]
}

{
  "name": "amap",
  "command": "npx",
  "args": ["-y", "@amap/amap-maps-mcp-server"],
  "env": {
    "AMAP_MAPS_API_KEY": "your-api-key-here"
  }
}

{
  "name": "slack",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-slack"],
  "env": {
    "SLACK_BOT_TOKEN": "your-bot-token",
    "SLACK_TEAM_ID": "your-team-id"
  }
}

​
Next Steps

Server Management

Learn advanced server configuration and management

Group Management

Organize servers into logical groups

Smart Routing

Set up AI-powered tool discovery

API Reference

Explore the complete API documentation

​
Troubleshooting

  • Check if the MCP server command is accessible in your PATH - Verify environment variables are correctly set - Check MCPHub logs for detailed error messages
  • Ensure MCPHub is running on the correct port - Check firewall settings - Verify the endpoint URL format
  • Verify credentials are correct - Check if JWT token is valid - Try clearing browser cache and cookies
Need more help? Join our Discord community for support!
⌘I