---
title: 연결 문제 해결
description: 로그인·설치·API 키·권한·프로젝트 연결·검색 색인을 구분하고 안전하게 해결하세요.
url: https://docs.thegram.one/ko/guides/troubleshooting/
lang: ko
tier: current
editorial_sources:
  - https://thegram.one/install/agents.md
  - https://github.com/thegram-one/thegram-mcp
  - https://github.com/thegram-one/thegram-plugin
---

# 연결 문제 해결

## 어디서 막혔는지 구분

| 증상 | 확인할 것 | 하면 안 되는 것 |
| --- | --- | --- |
| 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](/ko/guides/local-setup/#h0-19)을 확인하세요. 없는 association은 중단 상태이지 새 저장 대상을 고를 권한이 아닙니다. non-Git 폴더에서 identity를 추측하지 마세요.

## OMP 업데이트

[OMP 설치 명령](/ko/guides/local-setup/?client=omp#h0-5)의 전체 marketplace ID `thegram-memory@thegram-memory`를 사용하세요. bare `thegram-memory`는 upgrade 대상이 아닙니다. 업데이트 뒤에는 새 agent 세션을 시작합니다.

## 비공개 정보를 보내지 않고 문의

[support@thegram.one](mailto:support@thegram.one)에 client·실패 단계·오류 코드·문서 URL을 알려주세요. 비밀번호·API key·비공개 문서 본문·가리지 않은 계정 화면은 보내지 마세요. 문서 도구의 오류 신고는 이메일 초안만 열며 자동 전송하지 않습니다.

상세 오류: [MCP 오류와 복구](/ko/reference/mcp-errors/).