开始使用
选你用的 Agent。一段 prompt 或一行命令，点一次链接就连上了。
安装
选你用的 Agent,然后两条路都展开:**选择一** Agent 自己装(粘 prompt 给 chat 里的 Agent),**选择二** 你自己在终端 / GUI 里装。每个 Agent 都两条都通。
选择一 · 让 Agent 自己装
RFC 8628 device flow把这一行贴给所选 Agent。Agent 会去拉本部署的 /llms.txt(已按你选的客户端过滤),自己跑 device flow:给你一个链接,你点一次 Approve,Agent 拿 key、写 config、调 huozi_whoami 验证。
Install huozi from cloud.huozi.app/llms.txt?for=claude-code.
选择二 · 按客户端 CLI / GUI 安装
RFC 8252 OAuth-on-first-use在你自己电脑的终端跑这一行(或贴这段配置)。第一次调用 huozi 自动弹浏览器走 OAuth,token 由客户端本地持有。
Step 1 · 终端粘贴这一行 —— 把 huozi 注册到 Claude Code 用户级 MCP 配置（全项目可用）。
claude mcp add --transport http huozi https://cloud.huozi.app/mcpStep 2 · 在 Claude Code 内输入 /mcp → 选 huozi → Authenticate；浏览器一键同意，huozi 工具立即在本会话可用。
Endpoint: cloud.huozi.app/mcp · 授权令牌由 MCP 客户端在本地持有，不进入对话上下文 · 在 Claude Desktop 内进入 Code 模式同样适用 —— 底层是同一个 Claude Code。
2 · Agent 会打印一个链接 —— 点一下 Authorize
用任意浏览器打开链接。如果你还没登录 huozi.app，会先走一次 email OTP。然后你会看到「哪个 Agent 在请求」「要访问哪个工作区」以及一个 Authorize 按钮。点它，关掉页面。
3 · Agent 自动连接 · 完成
几秒钟内，Agent 拿到 key，注册 MCP server，回报 ✓ 已连接到工作区 …。从此每一次 Agent 请求都能读写你的 huozi 工作区。
管理连接、浏览文件、随时吊销，都在 /workspace。
▸没有 Agent？手动装一遍
整条流程就是纯 HTTP —— 你可以自己跑 curl 走 device flow：
# 1. get codes
curl -sS -X POST https://cloud.huozi.app/auth/device-code \
-H "content-type: application/json" -d '{"client_name":"my-cli"}'
# (open verification_url_complete from the response, click Authorize)
# 2. poll every 5s until it returns a key
curl -sS -X POST https://cloud.huozi.app/auth/token \
-H "content-type: application/json" \
-d '{"device_code":"<from step 1>"}'
# 3. register with Claude Code
claude mcp add --transport http huozi https://cloud.huozi.app/mcp \
-H "Authorization: Bearer <api_key from step 2>"已登录 huozi.app？直接在 /workspace 选客户端拿 ready-to-use 的配置片段。