先处理最常见的连接问题。

配对码无法使用

配对码是 6 位数字，有效期 5 分钟，而且只能使用一次。如果已经过期或提交过，直接在 NexusDock 重新生成，再把新的配对码填写到 AgentDock。

设备一直没有出现在 NexusDock

1. 先确认目标电脑上的 AgentDock 已经安装并且正在运行。
2. 如果 AgentDock 要求填写 NexusDock 服务地址，使用 https://mcp.nexusdock.co/。
3. 重新生成一个配对码，再完成一次配对。
4. 回到“设备”页面并刷新。连接成功后，设备应该显示为“在线”。

设备显示离线

设备离线通常意味着 AgentDock 已停止、电脑处于休眠状态，或者到 NexusDock 的网络连接中断。打开这台设备上的 AgentDock，确认它正在运行，然后等待“设备”页面恢复为“在线”。

AI 已经连接，但看不到新工具

AI 客户端经常会缓存 MCP 工具定义。先刷新或重新连接 NexusDock MCP，然后新开一个对话。不要一看到旧工具列表，就直接判断 NexusDock 或 AgentDock 更新失败。

授权失败或被取消

回到 AI 客户端重新发起连接。NexusDock 授权页打开后，确认登录的是正确账号，然后完成授权。如果这个客户端之前已经授权过，也可以先在 NexusDock 设置中撤销授权，再重新连接。

MCP 访问令牌失效

重置 MCP 访问令牌后，旧令牌会立即失效。所有仍在使用旧令牌的客户端都需要改成新令牌。新令牌只会显示一次。

还是没有解决？

如果 NexusDock 在错误信息里显示了请求 ID，请保留这个请求 ID。它可以帮助排查问题，而且不需要暴露你的凭据。