重新連接 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 帳戶選單傳送意見。