连接编辑器

Cloud 能把自愈请求和 CI 结果路由回你的编辑器——但云端够不到你的机器，所以这个连接是拉取：你的 VS Code 扩展和 MCP agent 向 Cloud 鉴权并轮询。一次登录，两处生效。

从 VS Code 连接

在装了 Hover 扩展的 VS Code 里运行 Hover: Connect Hover Cloud。它走的是 device-link 流程——不用复制 token：

1. 扩展在浏览器打开 Cloud 授权页，带一个短码。
2. 你已经登录了，核对短码一致后点 Approve。
3. Cloud 铸造一个 personal access token，只交回给扩展一次。

token 保存到 ~/.hover/credentials.json（权限 0600），不是 VS Code 的私有 secret 存储——因为 Hover MCP server 读同一个文件，所以在编辑器里批准也就登录了你的 MCP agent。

编辑器拿它做什么

连接后，扩展每隔几分钟轮询自愈队列。当一个 spec 在 CI 里漂移，它会通知你并提供 Copy heal command——把 /mcp__hover__heal <spec> 放到剪贴板给你的编码 agent。你审阅 diff；CI 看到那个 spec 通过时队列条目关闭。

扩展的 Dashboard 面板也能直接读取你项目的 Cloud 仪表盘（与 web 应用展示的 pass/fail/flaky 同一份数据），所以 CI 结果不碰文件就落进 cockpit。

直接连接 MCP

MCP server 按一个固定链路解析凭据，所以任何用 @hover-dev/mcp 的 agent 都拾取同一次登录：

1. HOVER_CLOUD_TOKEN（以及可选的 HOVER_CLOUD_URL）环境变量——显式，适合 CI 或无头 agent。
2. ~/.hover/credentials.json —— 由上面的 VS Code 连接流程写入，或手动写入。

有凭据在场时，cloud_failures 这个 MCP 工具会拉取开着的自愈队列，让你的 agent 直接从 Cloud 提取的失败提示开始处理漂移。

下一步

• 运行、告警与自愈 —— 自愈队列如何填充与关闭。
• 团队与生命周期 —— 管理 token 与队友。