AI导哈

工具聚合服务

MCP Hub是一个工具聚合平台，通过API密钥认证和RBAC权限管理，将多个服务模块（如LINE官方账号、FX-CRM、Shopify等）集成到Claude Code中，供用户直接使用。

  • by jameslai-sparkofy
  • 云端部署
  • 更新于
在 GitHub 查看 jameslai-sparkofy/public-install-guide

使用说明

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 中重新連線：

  1. 輸入 /mcp
  2. 找到 mcp-hub
  3. 選擇 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

相关 MCP