三步，让任何 AI 接上你的记忆。

蜂巢门（MCP 接入层）是蜂巢给外部 AI 开的一扇门：任何 agent 按 MCP（Model Context Protocol） 协议即插即用，把公开记忆「当自己的流水记忆」读写。公开四仓（当前主线 / 待办执行 / 参考资料 / 归档历史）全不设限；写走候选（propose），确认归巢是你在观察窗的动作。

第 1 步：注册成触角，领凭证

每个 MCP Host 先注册成一个触角，领到 agent_id + access_token：

curl -X POST http://127.0.0.1:8768/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my_claude", "agent_type": "mcp", "display_name": "我的 Claude"}'

返回：

{
  "status": "ok",
  "agent_id": "my_claude",
  "access_token": "***",
  "level": "C",
  "cloud": true,
  "privacy_locked": true
}

• agent_type 填 mcp（MCP Host）。注册表会写死 cloud: true + privacy_locked: true——隐私仓对云端触角默认锁死。
• agent_id 只允许字母/数字/下划线/中划线（1-64 位），中文会 400。
• 验证凭证：curl -X POST .../api/agent/verify -d '{"agent_id":"my_claude","token":"***;"}'，返回 privacy_locked: true 即隐私已锁。

第 2 步：配置 Host

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "hive-memory": {
      "command": "python3",
      "args": ["/完整路径/mcp_stdio.py"],
      "env": {
        "HIVE_AGENT_ID": "my_claude",
        "HIVE_AGENT_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

自建 Host（HTTP 直连）：每次请求带 header X-Hive-Agent + X-Hive-Token。环境变量 HIVE_MCP_URL 可覆盖服务地址（默认 http://127.0.0.1:8768/mcp）。

第 3 步：调用工具

4 个工具：recall / propose / manage / get_context。

recall —— 读（命门入口）

{"query": "上次说的那个项目", "limit": 10, "compact": true}

• query（必填）：自然语言查询
• vaults：限定仓库名，默认公开四仓
• compact：精简返回，默认 true

propose —— 写（进候选区）

{"content": "要记住的内容", "title": "标题", "vault": "当前主线", "tags": ["项目A"]}

触角只能 propose，不能 self-confirm。返回带 conflict_warning 提示重复。

manage —— 管理

按 action 路由：list_pending / forget（软删除）/ restore / get_by_id。隐私仓条目触角不可取/删/恢复。

get_context —— 接入开场

{"limit": 8}

一次拉「当前主线 + 待办执行」两仓最近记忆，作会话上下文底座。

隐私边界（写进注册表）

查不到注册表的「幽灵触角」默认锁死（安全兜底）。

接入后，Claude 可以

1. 开场 get_context 了解你最近在忙啥
2. 对话中 recall 调出「上次说的那个项目」
3. 你说「这个该存下来」→ 它 propose 进候选区
4. 你回电脑在观察窗确认归巢

记忆在蜂巢永驻，换多少茬 agent 都无缝接上。