MCP Hub
將 Claude Code 連接到 MCP Hub，在 Claude Code 中直接使用你有權限的所有工具。
架構
Claude Code ──(MCP Streamable HTTP)──▶ Gatekeeper ──▶ MCP Hub ──▶ 各服務模組
│ │
│ API Key 認證 │ 工具聚合
│ RBAC 權限控管 │ 多租戶路由
│ 速率限制 │
│ 審計追蹤 │
▼ ▼
┌──────────────┐
│ LINE 官方帳號 │
│ FX-CRM │
│ Shopify │
│ 知識庫 │
│ Odoo ERP │
│ 電子發票 │
│ 圖庫 │
│ 流程中心 │
│ ... │
└──────────────┘快速開始
你需要準備
- 已安裝 Claude Code CLI
- 一組 API Key（
gk_...格式），向系統管理員索取
安裝
claude mcp add \
--transport http \
--scope user \
--header "X-API-Key: 你的API_KEY" \
mcp-hub \
https://gatekeeper-43pfffyjia-de.a.run.app/mcp啟用
安裝後在 Claude Code 中重新連線：
- 輸入
/mcp - 找到 mcp-hub
- 選擇 Reconnect
完成。你有權限的所有工具現在可以用了，工具名稱格式為 mcp__mcp-hub__。
運作原理
認證
X-API-Key header 對每個 MCP 請求進行認證。API Key 長效不過期，設定一次即可。
Gatekeeper 會根據你的 API Key 解析：
- 租戶 — 你所屬的組織
- 角色 — 你的權限等級
- 工具權限 — 你可以使用哪些工具（RBAC 逐工具過濾）
工具命名
每個工具以來源服務為前綴：
| 前綴 | 服務 |
|---|---|
line_ | LINE 官方帳號 |
fxcrm_ | FX-CRM |
odoo_ | Odoo ERP |
kb_ | 知識庫 |
pic_ | 圖庫 |
ticket_ | 流程中心 |
smilepay_ | 電子發票 |
shopify_ | Shopify |
移除
claude mcp remove mcp-hub故障排除
| 問題 | 解法 |
|---|---|
| 連線失敗 | 確認 API Key 格式正確（gk_ 開頭） |
| 工具列表為空 | API Key 權限不足，聯繫管理員 |
| 401 錯誤 | API Key 無效或已停用 |
| 403 錯誤 | 該工具需要更高權限 |
License
MIT