콘텐츠로 이동

MCP 문제 해결

https://mcp.engram.page
  • 잘못된 URL입니다. MCP 엔드포인트는 /api/mcp에 있습니다 (위의 엔드포인트 참조). 호스트 주소만 있고 경로가 없는 경우 MCP 엔드포인트가 아니며 404 오류가 발생합니다.
  • 셀프 호스팅 TLS 설정. MCP 엔드포인트는 HTTPS여야 합니다. 일반 HTTP는 OAuth 2.1에 따라 클라이언트에서 거부됩니다.
  • 백엔드에 연결할 수 없습니다. /api/health 주소에 직접 접속할 수 있는지 확인하세요. 연결에 실패하면 MCP은 작동할 수 없습니다.
  • 계정이 활성화되지 않았습니다. app.engram.page에 로그인하여 구독 상태를 확인하세요.
  • 온보딩이 완료되지 않았습니다. app.engram.page에서 설정을 완료하세요 (이용 약관 및 일부 계정의 경우 보관함 설정). 403 오류 메시지에는 누락된 단계로 연결되는 링크가 포함되어 있습니다.
  • OAuth 사용 시 제한이 있을 수 있습니다. 잠시 후 다시 시도해주세요.

Claude에서 노트를 찾을 수 없습니다

섹션 제목: “Claude에서 노트를 찾을 수 없습니다”
  • Obsidian에서 보관함이 실제로 동기화되었는지 확인해 주세요. 동기화 센터와 app.engram.page를 확인해 보세요.
  • OAuth 토큰에 실제로 mcp 권한이 포함되어 있는지 확인해 주세요. 처음 설치 시 인증을 건너뛴 경우, 커넥터를 다시 추가해 보세요.
  • 더 구체적인 검색어를 사용해 보세요. 의미 기반 검색은 상위 K개의 결과만 반환하므로, 큰 보관함에서 너무 일반적인 검색어는 예상 결과를 제공하지 않을 수 있습니다.

OAuth 토큰은 유한한 수명을 가집니다. 대부분의 클라이언트는 자동 갱신을 처리합니다. 다시 시도해 보세요. 문제가 지속되면 커넥터를 제거하고 다시 추가해 보세요.

Codex가 Engram에 대한 접근 권한을 잃었습니다

섹션 제목: “Codex가 Engram에 대한 접근 권한을 잃었습니다”

Codex 0.163 이전 버전은 더 이상 유효하지 않은 로그인 시도를 계속하거나, 로그인을 잃어버릴 수 있습니다 (관련 문제: openai/codex#48507 및 openai/codex#39054, 둘 다 아직 해결되지 않음). Codex 0.164.0은 거부된 로그인 시도를 중단하므로, 먼저 Codex를 업데이트하십시오.

Engram 도구가 계속 실패하는 경우, 다시 연결해 보세요. 서버를 추가할 때 지정한 이름을 사용하여 다음 명령을 실행하세요.

터미널 창
codex mcp login engram

더 많은 정보를 얻을 수 있는 곳

섹션 제목: “더 많은 정보를 얻을 수 있는 곳”
  • 서버 측 로그: 셀프 호스팅의 경우, 셀프 호스팅 문서를 참조하세요
  • 클라이언트 측 로그: Claude 데스크톱 → 도움말 → 개발자 콘솔 열기
  • 문제 보고: engram-app/engram