연결 문제 해결
어디서 막혔는지 구분
섹션 제목: “어디서 막혔는지 구분”| 증상 | 확인할 것 | 하면 안 되는 것 |
|---|---|---|
| AI에 Thegram tools가 없음 | 선택한 client 설치와 필요한 재시작. 커넥터와 memory skill은 별개 | 무관한 plugin 반복 설치 |
| OAuth 로그인·동의 미완료 | 본인 계정과 provider·조직 정책. 동의는 직접 검토 | agent가 대신 동의 |
HTTP 401, E_AUTH |
본인 key의 설정·만료·revoke 여부. 교체했다면 숨김 prompt로 재연결 | 채팅에 secret 붙여넣기, 다른 사람 key 사용 |
AGENT_SCOPE_DENIED, E_FORBIDDEN, read-only 오류 |
리소스 범위·membership·정책. 읽기 권한은 읽기만 계속 가능 | 오류를 빈 검색 결과로 처리하거나 승인 없이 권한 확대 |
E_PROJECT_IDENTITY, project 없음·중복 |
repository origin과 정확한 기존 project association | 경로 추측, 다른 Vault 선택, 대체 문서 자동 생성 |
| 빈 Vault 목록 | 계정과 허용된 리소스. 연결은 유효하되 읽을 문서가 없을 수 있음 | 연결을 증명하려고 테스트 레코드 생성 |
| 직접 읽기는 되지만 검색이 안 됨 | 같은 허용 범위와 색인 상태. 저장 경로를 직접 읽어 확인 | 검색 결과만으로 저장 실패·데이터 손실 단정 |
E_CONNECT, key_service_unavailable |
설정된 Cloud endpoint와 네트워크·서비스 준비 상태 | 데스크톱 socket·다른 저장소로 fallback |
기존 프로젝트 연결
섹션 제목: “기존 프로젝트 연결”코딩 에이전트의 project association을 확인하세요. 없는 association은 중단 상태이지 새 저장 대상을 고를 권한이 아닙니다. non-Git 폴더에서 identity를 추측하지 마세요.
OMP 업데이트
섹션 제목: “OMP 업데이트”OMP 설치 명령의 전체 marketplace ID thegram-memory@thegram-memory를 사용하세요. bare thegram-memory는 upgrade 대상이 아닙니다. 업데이트 뒤에는 새 agent 세션을 시작합니다.
비공개 정보를 보내지 않고 문의
섹션 제목: “비공개 정보를 보내지 않고 문의”support@thegram.one에 client·실패 단계·오류 코드·문서 URL을 알려주세요. 비밀번호·API key·비공개 문서 본문·가리지 않은 계정 화면은 보내지 마세요. 문서 도구의 오류 신고는 이메일 초안만 열며 자동 전송하지 않습니다.
상세 오류: MCP 오류와 복구.