HiClaw 1.0.6：企业级 MCP Server 管理 — 凭证零暴露，工具全接入

MCP 工具（原子能力）
    ↓ mcporter 编排
SKILL（场景化能力包）
    ↓ 实战使用
SKILL 迭代优化

┌─────────────────────────────────────────────────────────────────────────────┐
│                              你（人类）                                       │
│                                                                             │
│  "添加一个股票指数 API：GET https://api.finance.com/v1/index?symbol={symbol}"  │
│  "通过 X-API-Key header 认证，这是我的 key：sk_xxx"                            │
└────────────────────────────────────┬────────────────────────────────────────┘
                                     │
                                     ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                           MANAGER CLAW                                      │
│                                                                             │
│  1. 根据你的描述生成 MCP Server YAML 配置                                       │
│  2. 运行 setup-mcp-server.sh stock-index "sk_xxx" --yaml-file /tmp/stock.yaml│
│  3. 用 mcporter 验证：mcporter call stock-index.get_index symbol=000001.SH    │
│  4. 通知 Worker："新 MCP 服务器 'stock-index' 已就绪"                           │
└────────────────────────────────────┬────────────────────────────────────────┘
                                     │
                                     ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                        HIGRESS AI GATEWAY                                   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐    │
│  │  MCP Server: stock-index-mcp-server                                 │    │
│  │  ├─ 真实凭证: sk_xxx（安全存储，永不暴露）                               │    │
│  │  ├─ 工具: get_index(symbol: string) → 股票指数数据                    │     │
│  │  └─ 授权消费者: manager, worker-alice, worker-bob                     │    │
│  └─────────────────────────────────────────────────────────────────────┘    │
│                                                                             │
│  向 Worker 签发临时 consumer token                                            │
│  Token 只能调用已授权的 MCP 服务器                                              │
│  真实 API key 永远不会离开网关                                                 │
└────────────────────────────────────┬────────────────────────────────────────┘
                                     │
                                     ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                           WORKER CLAW                                       │
│                                                                             │
│  1. 收到 Manager 的通知                                                       │
│  2. 从 MinIO 拉取最新的 mcporter 配置                                          │
│  3. 发现工具：mcporter list stock-index --schema                              │
│  4. 测试工具：mcporter call stock-index.get_index symbol=000001.SH            │
│  5. 基于理解生成 SKILL.md                                                     │
│  6. 后续任务中即可使用该工具！                                                   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐    │
│  │  Worker 的视角：                                                     │    │
│  │  ├─ 拥有：Consumer token（就像一张"工牌"）                              │    │
│  │  ├─ 可以：通过网关调用 stock-index.get_index                           │    │
│  │  └─ 不可以：看到真实的 API key sk_xxx                                  │    │
│  └─────────────────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────────────────┘

你：我想添加计费 API 作为 MCP 工具。
    端点：GET https://billing.internal.company.com/api/v1/customers/{customer_id}
    认证：Authorization header 里的 Bearer token
    这是 token：Bearer eyJhbGciOiJSUzI1NiIs...

server:
  name: billing-mcp-server
  config:
    accessToken: ""  # Manager 在这里替换你的真实 token
tools:
- name: get_customer
  description: "通过 ID 获取客户详情"
  args:
  - name: customer_id
    description: "客户 ID（如 CUST-12345）"
    type: string
    required: true
  requestTemplate:
    url: "https://billing.internal.company.com/api/v1/customers/{{.args.customer_id}}"
    method: GET
    headers:
    - key: Authorization
      value: "Bearer {{.config.accessToken}}"

Manager：@alice @bob 新 MCP 服务器 `billing` 已配置完成，包含工具：get_customer。
        请使用 file-sync skill 拉取更新后的配置，然后使用 mcporter skill 发现并学习新工具。

你：@alice 检查客户 CUST-12345 是否有逾期账单

Alice：让我查询计费系统...
       mcporter call billing.get_customer customer_id=CUST-12345

       客户：Acme Corp
       状态：活跃
       逾期：是的，$4,500 自 1 月 15 日起

       该客户确实有逾期账单。

你：这是我们的产品目录 API Swagger 文档：
    https://docs.internal.company.com/swagger.json
    通过 X-API-Key header 认证。Key：prod_cat_xxx

Manager：我会将 Swagger 文档转换为 MCP 工具...
         发现 12 个端点，创建 12 个 MCP 工具...
         部署到 Higress 为 `product-catalog` MCP 服务器。

         测试第一个工具... ✓
         测试第二个工具... ✓
         所有工具已验证。

         @warehouse-team 新 MCP 服务器 `product-catalog` 已就绪，包含 12 个工具。

你：添加这个 API 调用作为工具：
    curl -X GET "https://api.shipping.com/v1/track?tracking_id=ABC123" \
         -H "X-API-Key: ship_xxx"

Manager：创建 MCP 服务器 `shipping`，包含工具 `track_package`...
         部署并测试完成。@logistics-team 现在可以使用 track_package 了。

你：@alice /reset

Alice：上下文已清除。准备好接收新任务。

你：@bob /stop

Bob：任务已中断。这是我正在做的事情：
     - 已分析代码库的 45%
     - 发现 3 个潜在问题
     - 还没开始修复

     为什么打断我？你想让我改变方向吗？

你：@manager /model qwen3.5-plus

manager：Model set to qwen3.5-plus (hiclaw-gateway/qwen3.5-plus).