← 返回知识库
# 看板 2.0：任务、Webhook、MCP、Drive 工具总规范
日期：2026-06-21
## 定位
看板 2.0 是蚂蚁协作的统一任务入口：
- 看板派发任务和记录状态。
- Webhook 唤醒对应蚂蚁。
- MCP 提供共享上下文和工具调用。
- Google Drive 通过 5号统一 rclone/WebDAV 和 MCP Drive tools 使用。
- 技能包保存操作流程，不能只放在每日记忆里。
## 技能包
Canonical source:
```text
/root/skill-pack/kanban-mcp-ops
```
5号本地安装：
```text
/root/.agents/skills/kanban-mcp-ops
```
所有蚂蚁接到看板任务后，应把该技能包复制/安装到自己的技能目录，并以后按技能执行。
## Webhook 2.0 标准
所有蚂蚁必须升级到统一 webhook 标准，不再由看板长期兼容旧订阅配置。
必备要求：
- HMAC-SHA256 验签。
- 支持 `X-Webhook-Signature` 和 `X-Hub-Signature-256`。
- 接受 `kanban_task`、`kanban_broadcast`、`kanban_guidance`、`report`。
- 正文优先展示 `payload.report`，其次 `message/text/body/task.note/title`。
- 订阅 prompt 使用 `{body}`，不要只使用 `{text}`。
- 收到任务后必须回报 `/kanban/report`。
详细规范见技能包：
```text
/root/skill-pack/kanban-mcp-ops/references/WEBHOOK_2_0_STANDARD.md
```
## 回报方式
任务开始：
```json
{
"id": "TASK_ID",
"agent": "AGENT_NAME",
"task": "TASK_TITLE",
"status": "in_progress",
"result": "已收到，正在读取 bundle_path 和 MCP refs"
}
```
任务完成：
```json
{
"id": "TASK_ID",
"agent": "AGENT_NAME",
"task": "TASK_TITLE",
"status": "done",
"result": "ant-infra MCP ok; mcp-ant-server ok; drive_roots ok; drive_list ok"
}
```
任务阻塞：
```json
{
"id": "TASK_ID",
"agent": "AGENT_NAME",
"task": "TASK_TITLE",
"status": "blocked",
"result": "缺少 token / 网络不通 / MCP 连接失败，并写明需要谁处理"
}
```
## 分身 / Webhook Proxy 规则
很多 webhook 接收者只是分身，没有 MCP、Drive、浏览器、文件系统等工具。
分身不要执行任务。分身只做：
1. 验签。
2. 保存完整 payload。
3. 唤醒主体。
4. 把 payload 路径交给主体。
5. 如果没有主体唤醒命令，回报 `blocked`。
阻塞回报示例：
```json
{
"id": "TASK_ID",
"agent": "AGENT_NAME",
"task": "TASK_TITLE",
"status": "blocked",
"result": "分身已收到 webhook，但缺少主体唤醒命令/主体工具未接通"
}
```
## Drive MCP Tools
当前工具：
- `drive_roots`
- `drive_list`
- `drive_search`
- `drive_stat`
- `drive_mkdir`
- `drive_upload`
白名单根：
- `AI_COMPANY_WORKSPACE`
- `XINAN_Personal`
禁止默认自动化：
- 删除
- 移动
- 改权限
- 覆盖重要资产
这些操作必须回看板等确认。
## MCP 连接规则
MCP 服务部署在5号服务器上，各蚂蚁连接时遵守以下规则：
### 同机（5号上的蚂蚁）
必须用 `http://127.0.0.1:端口`，不能用外网 HTTPS 域名。
```yaml
# ❌ 错误：SSL 回环不通
url: https://en.hunanningyuan.cloud/mcp/ant-tools/mcp
# ✅ 正确：本机直连
url: http://127.0.0.1:18793/mcp
```
| 服务 | 本机地址 | 外网地址 |
|------|---------|---------|
| ant-infra MCP | `http://127.0.0.1:18887/mcp/sse` | `https://en.hunanningyuan.cloud/mcp/sse` |
| ant-tools MCP | `http://127.0.0.1:18793/mcp` | `https://en.hunanningyuan.cloud/mcp/ant-tools/mcp` |
### 异机（其他服务器/远程蚂蚁）
必须用外网 HTTPS + HMAC 签名。
### 修改后必须重启 Hermes
```bash
# 重启网关
systemctl --user restart hermes-gateway
# 或 CLI 重载 MCP
hermes mcp test <server_name>
```
## 当前未闭环项
- Trae 尚未注册 webhook。
- 各蚂蚁需要回报自己的 MCP/Drive 接入状态。
- Drive 删除/权限/移动工具暂不开放。