把 Claude Code、Cursor、Claude Desktop、ChatGPT 或任何兼容 MCP 的客户端直接接入心智层。助手把 Sonzai 视作一组可按名调用的工具与资源。

心智层提供了一个托管的 Streamable HTTP MCP 端点： https://api.sonz.ai/mcp/memory/{agent_id}。把任意兼容 MCP 的客户端指向它，再带上 Sonzai API 密钥即可 — 34 个工具、4 个资源、 3 个引导式提示词。无需本地二进制、无需开放 SSE 端口、无需 Go 工具链。

何时使用

用户已经在 Claude Code、Cursor、Claude Desktop、ChatGPT 或其他 MCP 兼容客户端里。
你希望靠对话驱动 Sonzai，而不是写 SDK 代码。
你在原型阶段 — 选 create-companion 或 mind-layer-setup 引导提示词，完全不写代码也能跑起来。

何时切换

构建自己的产品 UI — 切换到模式 1：托管运行时。
想让 Sonzai 进入自己的 LLM 循环，而不是作为别人 LLM 的工具 — 切换到模式 4：独立实时。

架构

┌────────────────────────┐                   ┌──────────────────────┐
│  Claude Code · Cursor  │                   │   Sonzai Mind Layer  │
│  ChatGPT · VS Code     │                   │                      │
│  Claude Desktop        │                   │                      │
└──────────┬─────────────┘                   └──────────┬───────────┘
         │                                            │
         │  Streamable HTTP (JSON-RPC 2.0)            │
         │  • list_agents                             │
         │  • chat / start_session / end_session      │
         │  • search_memories / list_facts            │
         │  • get_personality / get_mood              │
         │  • generate_character / trigger_event      │
         │  • schedule_wakeup / list_notifications    │
         │                                            │
         ▼                                            │
 https://api.sonz.ai/mcp/memory/{agent_id}            │
 Authorization: Bearer sk-your-api-key                │
                                                      │
                                                      ▼
                                              Context Engine,
                                              AI Service, DBs

端到端示例

需要从项目仪表板取得项目 API 密钥并准备好一个 agent ID。选你的客户端，粘贴片段就完成配置。

# 一行命令注册托管 MCP 服务器：
claude mcp add --transport http sonzai \
https://api.sonz.ai/mcp/memory/AGENT_ID \
--header "Authorization: Bearer $SONZAI_API_KEY"

# 然后在任何 Claude Code 会话中直接说：
#   "Chat with agent 'Luna' and say 'I had a great day hiking today!'"
#   "Search Luna's memories about hiking adventures"
#   "Use mind-layer-setup with assistant_name 'Aria' …"

Streamable HTTP，而不是 SSE

2026 版 MCP 规范把 Streamable HTTP 标记为远程传输的标准选择。各主流客户端正在逐步弃用 SSE — 任何新的集成都应优先选择 HTTP。

把 API 密钥当成密码

Bearer Token 就是项目 API 密钥 — 它对项目下所有 agent 都有完整访问权。不要把它提交到公开仓库；多人协作时使用 per-developer 范围的配置。