Files

airano cb6bcd8136 fix(qa): resolve A.1-A.7 code bugs and B.1-B.8 documentation issues

Code fixes:
- Rename "Coolify Admin" to "MCP Hub Admin" in endpoints
- Enrich list_projects with alias and endpoint URL
- Downgrade OAuth InvalidTokenError log from WARNING to DEBUG
- Add 7 missing health tools to /system/mcp endpoint (now 24 tools)
- Remove "Phase 7.2" from health monitor log
- Fix WP Advanced health check to pass with REST API only
- Downgrade duplicate alias warnings to INFO

Documentation fixes:
- Document SSE transport and Bearer auth requirement
- Recommend plugin-specific endpoints to save tokens
- Document plugin vs project endpoint differences
- WordPress plugin requirements for SEO/WP-CLI tools
- Docker socket mounting guide for WP-CLI
- Mark MASTER_API_KEY as recommended (auto-generates temp key)
- Env var naming convention with prefix table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-18 18:29:15 +03:30

3.7 KiB

Raw Blame History

MCP Hub

The AI-native management hub for WordPress, WooCommerce, and self-hosted services.

596 tools across 9 plugins. Connect your sites, stores, repos, and databases — manage them all through Claude, ChatGPT, Cursor, or any MCP client.

Quick Start

1. Create a `.env` file

# Required
MASTER_API_KEY=your-secure-key-here

# Add at least one WordPress site
WORDPRESS_SITE1_URL=https://your-site.com
WORDPRESS_SITE1_USERNAME=admin
WORDPRESS_SITE1_APP_PASSWORD=xxxx xxxx xxxx xxxx
WORDPRESS_SITE1_ALIAS=mysite

2. Run the container

docker run -d \
  --name mcphub \
  -p 8000:8000 \
  --env-file .env \
  airano/mcphub:latest

3. Verify it works

# Health check (wait ~30 seconds for startup)
curl http://localhost:8000/health

# Open the web dashboard
# http://localhost:8000/dashboard

4. Connect your AI client

In Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "mcphub": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer your-secure-key-here"
      }
    }
  }
}

Authentication

MCP Hub uses Bearer token authentication. Include the Authorization header in all requests:

Authorization: Bearer YOUR_MASTER_API_KEY

This applies to both MCP clients and API calls. Query parameter auth is not supported.

Using Docker Compose

services:
  mcphub:
    image: airano/mcphub:latest
    ports:
      - "8000:8000"
    env_file:
      - .env
    volumes:
      - mcphub-data:/app/data
      - mcphub-logs:/app/logs
      # Optional: mount Docker socket for WP-CLI tools
      # - /var/run/docker.sock:/var/run/docker.sock:ro
    restart: unless-stopped

volumes:
  mcphub-data:
  mcphub-logs:

WP-CLI tools (cache flush, database export, plugin updates via CLI) require Docker socket access. Add WORDPRESS_SITE1_CONTAINER=your-wp-container-name to your .env and uncomment the Docker socket volume above.

docker compose up -d

After Starting

URL	Description
`http://localhost:8000/health`	Health check & status
`http://localhost:8000/dashboard`	Web dashboard (manage API keys, view sites, health)
`http://localhost:8000/mcp`	MCP endpoint (connect AI clients here)

Environment Variables

Variable	Required	Description
`MASTER_API_KEY`	Recommended	API key for authentication. If omitted, a temporary key is auto-generated and printed to logs
`WORDPRESS_SITE1_URL`	For WP	WordPress site URL
`WORDPRESS_SITE1_USERNAME`	For WP	WordPress admin username
`WORDPRESS_SITE1_APP_PASSWORD`	For WP	WordPress Application Password
`WORDPRESS_SITE1_ALIAS`	Recommended	Friendly name (e.g., `myblog`)
`OAUTH_JWT_SECRET_KEY`	For OAuth	JWT secret for ChatGPT/Claude auto-registration
`OAUTH_BASE_URL`	For OAuth	Public URL of your server

Add more sites with SITE2, SITE3, etc. See full configuration guide.

Supported Plugins

Plugin	Tools	Env Prefix
WordPress	67	`WORDPRESS_`
WooCommerce	28	`WOOCOMMERCE_`
WordPress Advanced	22	`WORDPRESS_ADVANCED_`
Gitea	56	`GITEA_`
n8n	56	`N8N_`
Supabase	70	`SUPABASE_`
OpenPanel	73	`OPENPANEL_`
Appwrite	100	`APPWRITE_`
Directus	100	`DIRECTUS_`

3.7 KiB Raw Blame History