重新连接 Claude Code 或 Codex 中的 OneMind

**如果状态可读取，但读取 Project、Mind 或共享记忆时提示 Insufficient scope：**当前连接可能只获准读取状态。团队管理员角色不会增加 OAuth 授权范围。请让发生错误的同一个 AI App 调用 one_mind_get_status：authorization.grantedScopes 显示此连接获准的权限，authorization.missingReadScopes 标出缺少的读取权限。viewerUserID、teamID 和 authorization.owner 表示它绑定的账户与空间。旧版服务器可能尚未返回这些诊断字段。

先确认浏览器授权页使用的是目标账户以及团队或个人空间。切换网站空间不会迁移已有工具连接。在发生错误的 AI App 中重新打开 OneMind 连接的授权设置，按下面的对应步骤重新连接或授权。批准前检查权限：Project 列表需要 onemind.projects.read，Mind 列表需要 onemind.minds.read，共享记忆需要 onemind.memory.read。如果授权页没有所需权限，请取消，并在客户端更新请求的权限后重试。读取操作不需要授予写入权限。

批准新的授权请求后，重试原先失败的读取，并再次核对连接的账户与空间。重试或刷新旧授权会保留原有权限，不会补齐缺少的权限。缺少范围的列表为空，只表示当前授权允许该操作；团队角色和每项内容的可见范围仍然有效。求助时不要分享访问令牌或刷新令牌。

Claude App 单独保存 OneMind 登录，与终端中的 Claude Code 分开。通过 OneMind 的终端登录操作，不会让 Claude App 登录。使用 Claude Code 时，请保持 Claude App 已打开。

在 Claude App 中

在 Claude App 中输入 /mcp，选择 onemind，再选择 Authenticate，然后在浏览器中完成登录。你可以复制以下命令：

/mcp

Claude 的 Reconnect onemind 横幅只会重试连接，不会完成登录。OneMind 检查的是终端连接，因此其状态无法确认 Claude App 会话是否已登录。此连接可能不出现在 Claude 的 Connectors 列表中。

终端中的 Claude Code

在 OneMind 中打开团队，选择 Claude Code，再选择为终端中的 Claude Code 登录，然后在浏览器中完成登录。这只会让终端中的 Claude Code 登录。Claude App 请按上面的步骤操作。

Codex

打开 ChatGPT App，确认 Codex 已通过 ChatGPT 登录。在 OneMind 中打开团队，选择 Codex，按页面说明操作。如果 ChatGPT 要求登录，请先在 ChatGPT App 中完成。

自动连接与更多帮助

OneMind 的后续更新会让连接自动完成。支持自动连接后，只需登录 OneMind，所有 Claude 窗口即可连接，无需在 Claude 中单独登录。看到提示时，选择打开 OneMind并在其中登录。如果 OneMind 正在启动或暂时无法连接，App 运行后连接会自动恢复。

OneMind 可显示 App 内提醒和 Mac 通知，具体取决于通知设置和 macOS 权限。点击通知会打开团队并选中对应工具；了解更多会打开本指南。重新连接会恢复工具连接。如果团队成员资格已失效，请联系团队所有者恢复访问权限。问题仍在时，可从 OneMind 账户菜单发送反馈。