MCP 문제 해결

엔드포인트

https://mcp.engram.page

”Failed to connect”

• 잘못된 URL. MCP 엔드포인트는 /api/mcp에 있습니다(위의 엔드포인트 참고). 경로 없는 호스트 주소는 MCP 엔드포인트가 아니며 404를 반환합니다.
• 셀프 호스트 TLS. MCP 엔드포인트는 HTTPS여야 합니다. OAuth 2.1에 따라 클라이언트는 일반 HTTP를 거부합니다.
• 백엔드에 닿지 않음. /api/health에 직접 요청이 되는지 확인하세요. 그것도 안 되면 MCP는 동작할 수 없습니다.

”Authorization failed”

• 계정이 활성 상태가 아님. app.engram.page에 로그인해 구독 상태가 정상인지 확인하세요.
• 온보딩이 끝나지 않음. Engram은 보관함 엔드포인트(MCP 포함)를 쓰려면 먼저 약관에 동의해야 합니다.
• OAuth 중 요청 제한에 걸림. 1분 기다린 뒤 다시 시도하세요.

Claude가 노트를 찾지 못함

• Obsidian에서 보관함이 실제로 동기화되었는지 확인하세요. 동기화 센터와 app.engram.page에서 확인할 수 있습니다.
• OAuth 토큰에 mcp 스코프가 실제로 들어 있는지 확인하세요. 처음 설치할 때 승인 단계를 건너뛰었다면 커넥터를 다시 추가하세요.
• 더 구체적으로 질문해 보세요. 의미 검색은 상위 K개를 반환하므로, 큰 보관함에서 모호한 질문을 하면 기대한 노트가 나오지 않을 수 있습니다.

”Token expired”

OAuth 토큰에는 유효 기간이 있습니다. 대부분의 클라이언트는 갱신을 자동으로 처리하므로 작업을 다시 시도해 보세요. 계속 실패하면 커넥터를 제거했다가 다시 추가하세요.

더 많은 정보를 찾을 곳

• 서버 측 로그: 셀프 호스트는 셀프 호스팅을 참고하세요
• 클라이언트 측 로그: Claude Desktop → Help → Open developer console
• 이슈는 engram-app/engram에 등록하세요