Quickstart

Installation

Docker (Recommended)
Local Development
npm Package

The fastest way to get started with Pcnaid MCP Hub is using Docker:

# Run with default configuration
docker run -p 3000:3000 pcnaidinc/pcnaid-mcp-hub

Or mount your custom configuration:

# Run with custom MCP settings
docker run -p 3000:3000 \
  -v $(pwd)/mcp_settings.json:/app/mcp_settings.json \
  pcnaidinc/pcnaid-mcp-hub

For development or customization:

# Clone the repository
git clone https://github.com/PcnaidInc/Pcnaid-MCP-Hub.git
cd Pcnaid-MCP-Hub

# Install dependencies
pnpm install

# Start development servers
pnpm dev

This starts both backend (port 3001) and frontend (port 5173) in development mode.

Install Pcnaid MCP Hub as a global package:

# Install globally
npm install -g @pcnaidinc/mcphub

# Run Pcnaid MCP Hub
mcphub

Initial Setup

1. Access the Dashboard

Open your browser and navigate to:

http://localhost:3000

The default username is admin. On first launch, if no ADMIN_PASSWORD environment variable is set, a random password is generated and printed to the server logs. To pre-set the admin password:

# Via environment variable
ADMIN_PASSWORD=your-secure-password docker run -p 3000:3000 pcnaidinc/pcnaid-mcp-hub

Change the admin password after first login for security.

3. Configure Your First MCP Server

Click “Add Server” in the dashboard
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 Pcnaid MCP Hub endpoints:

All Servers
Specific Group
Individual Server
Smart Routing

Access all configured MCP servers: http://localhost:3000/mcp

Access servers in a specific group: http://localhost:3000/mcp/{groupName}

Access a single server: http://localhost:3000/mcp/{serverName}

Use AI-powered tool discovery: http://localhost:3000/mcp/$smart

Smart routing requires PostgreSQL with pgvector and an LLM provider (OpenAI or compatible) API key.

Example: Adding Popular MCP Servers

Here are some popular MCP servers you can add:

Web Fetch Server

{
  "name": "fetch",
  "command": "uvx",
  "args": ["mcp-server-fetch"]
}

Playwright Browser Automation

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

Amap Maps (with API key)

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

Slack Integration

{
  "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

Server won't start

Check if the MCP server command is accessible in your PATH - Verify environment variables are correctly set - Check Pcnaid MCP Hub logs for detailed error messages

Can't connect from AI client

Ensure Pcnaid MCP Hub is running on the correct port - Check firewall settings - Verify the endpoint URL format

Authentication issues

Verify credentials are correct - Check if JWT token is valid - Try clearing browser cache and cookies

Need more help? Visit our GitHub repository for support!

Start here

Documentation hubs

Pcnaid MCP Hub

Shared legal

Installation

Initial Setup

1. Access the Dashboard

3. Configure Your First MCP Server

Basic Usage

Connecting AI Clients

Example: Adding Popular MCP Servers

Next Steps

Server Management

Group Management

Smart Routing

API Reference

Troubleshooting

​Installation

​Initial Setup

​1. Access the Dashboard

​2. Login

​3. Configure Your First MCP Server

​Basic Usage

​Connecting AI Clients

​Example: Adding Popular MCP Servers

​Next Steps

Server Management

Group Management

Smart Routing

API Reference

​Troubleshooting

Installation

Initial Setup

1. Access the Dashboard

2. Login

3. Configure Your First MCP Server

Basic Usage

Connecting AI Clients

Example: Adding Popular MCP Servers

Next Steps

Troubleshooting