atlatl/mcphub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(qa): resolve remaining v3.0.1 issues — CI, code bugs, docs

Browse Source 
CI: Fix black formatting in core/site_registry.py
Code: list_projects uses SiteManager, WP Advanced health uses REST API
Docs: Fix transport types, endpoint guide, env var reference for all plugins

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
airano
2026-02-18 18:55:12 +03:30
parent cb6bcd8136
commit 809dc264af
6 changed files with 245 additions and 108 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
DOCKER_README.md
View File

@@ -9,7 +9,7 @@
### 1. Create a `.env` file
```bash
# Required
# Recommended (auto-generates temp key if omitted — check container logs)
MASTER_API_KEY=your-secure-key-here
# Add at least one WordPress site
@@ -41,13 +41,14 @@ curl http://localhost:8000/health
### 4. Connect your AI client
In Claude Desktop's `claude_desktop_config.json`:
**Claude Desktop** (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"mcphub": {
"url": "http://localhost:8000/mcp",
"type": "streamableHttp",
"url": "http://localhost:8000/wordpress/mcp",
"headers": {
"Authorization": "Bearer your-secure-key-here"
}
@@ -56,15 +57,45 @@ In Claude Desktop's `claude_desktop_config.json`:
}
```
**VS Code** (`.vscode/mcp.json`):
```json
{
"servers": {
"mcphub": {
"type": "http",
"url": "http://localhost:8000/wordpress/mcp",
"headers": {
"Authorization": "Bearer your-secure-key-here"
}
}
}
}
```
> Use a plugin-specific endpoint (e.g., `/wordpress/mcp`) instead of `/mcp` to reduce tool count and save tokens. See [Endpoints](#endpoints) below.
## Authentication
MCP Hub uses **Bearer token** authentication. Include the `Authorization` header in all requests:
MCP Hub uses **Bearer token** authentication:
```
Authorization: Bearer YOUR_MASTER_API_KEY
Authorization: Bearer YOUR_API_KEY
```
This applies to both MCP clients and API calls. Query parameter auth is not supported.
> `X-API-Key` header and query parameter auth are **not** supported.
## Endpoints
Use the most specific endpoint for your use case:
| Endpoint | Tools | `site` param? | Best for |
|----------|------:|:-------------:|----------|
| `/project/{alias}/mcp` | 22-100 | No (pre-scoped) | Single-site workflow |
| `/{plugin}/mcp` | 23-101 | Yes | Multi-site management |
| `/mcp` | 596 | Yes | Admin & discovery only |
Available plugin endpoints: `/wordpress/mcp`, `/woocommerce/mcp`, `/wordpress-advanced/mcp`, `/gitea/mcp`, `/n8n/mcp`, `/supabase/mcp`, `/openpanel/mcp`, `/appwrite/mcp`, `/directus/mcp`, `/system/mcp`
## Using Docker Compose