가이드로 이동

Claude Code 또는 Codex에서 OneMind 다시 연결하기

상태는 읽을 수 있지만 Project, Mind 또는 공유 메모리를 읽을 때 Insufficient scope가 표시되는 경우: 현재 연결에는 상태 읽기만 허용되어 있을 수 있습니다. 팀 관리자 역할도 OAuth 권한을 자동으로 추가하지 않습니다. 오류가 발생한 동일한 AI 앱에서 one_mind_get_status를 호출하세요. authorization.grantedScopes는 승인된 권한을, authorization.missingReadScopes는 부족한 읽기 권한을 보여 줍니다. viewerUserID, teamID, authorization.owner는 연결이 지정된 계정과 작업 공간을 나타냅니다. 이전 서버에는 이러한 진단 필드가 없을 수 있습니다.

브라우저 승인 페이지가 의도한 계정과 팀 또는 개인 작업 공간을 사용하는지 확인하세요. 웹사이트에서 작업 공간을 바꿔도 기존 도구 연결은 이동하지 않습니다. 오류가 발생한 AI 앱에서 OneMind 연결의 승인 설정을 다시 열고 아래 절차에 따라 다시 연결하거나 승인하세요. 승인 전에 권한을 확인하세요. Project 목록에는 onemind.projects.read, Mind 목록에는 onemind.minds.read, 공유 메모리에는 onemind.memory.read가 필요합니다. 필요한 권한이 승인 페이지에 없으면 취소하고 클라이언트의 요청 권한을 업데이트한 뒤 다시 시도하세요. 읽기 작업에는 쓰기 권한을 부여할 필요가 없습니다.

새 요청을 승인한 후 실패했던 읽기를 다시 실행하고 연결의 계정과 작업 공간을 확인하세요. 기존 승인을 재시도하거나 토큰을 갱신해도 원래 권한이 유지되며 부족한 권한은 추가되지 않습니다. 부족한 범위 목록이 비어 있어도 해당 승인으로 작업이 허용된다는 뜻이며 팀 역할과 각 항목의 공개 범위는 계속 적용됩니다. 도움을 요청할 때 액세스 토큰이나 갱신 토큰을 공유하지 마세요.

Claude 앱은 OneMind 로그인을 별도로 저장하며, Terminal의 Claude Code와 공유하지 않습니다. OneMind의 Terminal 로그인 작업으로는 Claude 앱에 로그인되지 않습니다. Claude Code를 사용할 때는 Claude 앱을 열어 두세요.

Claude 앱에서

Claude 앱에서 /mcp를 입력하고 onemind, Authenticate를 차례로 선택한 다음 브라우저에서 로그인을 완료하세요. 아래 명령을 복사할 수 있습니다.

/mcp

Claude의 Reconnect onemind 배너는 연결을 다시 시도할 뿐 로그인을 완료하지 않습니다. OneMind는 Terminal 연결을 확인하므로 Claude 앱 세션의 로그인 여부를 확인할 수 없습니다. 이 연결은 Claude의 Connectors 목록에 표시되지 않을 수 있습니다.

Terminal의 Claude Code

OneMind의 팀에서 Claude Code를 선택한 다음 Terminal의 Claude Code에 로그인을 선택하고 브라우저에서 로그인을 완료하세요. 이 작업은 Terminal의 Claude Code에만 적용됩니다. Claude 앱에서는 위의 단계를 따르세요.

Codex

ChatGPT 앱을 열고 Codex가 ChatGPT로 로그인되어 있는지 확인하세요. OneMind의 팀에서 Codex를 선택하고 표시된 안내를 따르세요. ChatGPT 로그인이 필요하면 먼저 ChatGPT 앱에서 완료하세요.

자동 연결 및 추가 도움말

향후 OneMind 업데이트로 연결이 자동으로 이루어집니다. 자동 연결이 제공되면 OneMind에 로그인하는 것만으로 모든 Claude 창에서 연결되며, Claude에서 별도로 로그인할 필요가 없습니다. 안내가 표시되면 OneMind 열기를 선택하고 로그인하세요. OneMind가 시작 중이거나 일시적으로 연결되지 않으면 앱이 실행될 때 연결이 복구됩니다.

OneMind는 알림 설정과 macOS 권한에 따라 앱 내 알림과 Mac 알림을 표시할 수 있습니다. 알림을 열면 팀에서 해당 도구가 선택됩니다. 자세히 알아보기는 이 가이드를 엽니다. 다시 연결은 도구 연결을 복원합니다. 팀 멤버 자격이 비활성 상태라면 팀 소유자에게 접근 권한 복원을 요청하세요. 문제가 계속되면 OneMind 계정 메뉴에서 피드백을 보내세요.