Claude Desktop

Claude Desktop의 Connectors UI는 Engram을 연결하는 가장 매끄러운 방법입니다. URL을 붙여 넣고 로그인하는 흐름이며, 설정 파일도 복사할 API 키도 없습니다. 내부에서 무슨 일이 일어나는지는 MCP를 참고하세요.

사전 준비

시작하기 전에 다음을 확인하세요.

app.engram.page에 Engram 계정이 있습니다.
보관함이 하나 이상 동기화되어 있습니다. Obsidian 플러그인이나 웹 앱을 열어 최근 하루 안에 노트가 동기화되었는지 확인하세요.
브라우저로 로그인할 수 있습니다. MCP 인증 흐름은 브라우저 창을 엽니다.
OAuth 대신 API 키를 쓸 계획이라면 API 키에는 Pro가 필요합니다. OAuth 로그인은 무료를 포함한 모든 요금제에서 동작하며 권장 방식입니다. 무료와 Starter에서는 API 키를 만들거나 사용할 수 없습니다.

설정

Engram 커넥터 추가 페이지를 엽니다. Engram의 이름과 URL이 미리 채워진 상태로 Claude의 커넥터 설정이 시작됩니다. 이 설정은 데스크톱 앱과 claude.ai 모두에 반영됩니다.

직접 하고 싶다면 claude.ai/customize/connectors로 가서 + 버튼을 눌러 커스텀 커넥터를 추가하세요.
두 필드를 채운 뒤 Add를 누릅니다. 위 링크로 모달을 열었다면 둘 다 미리 채워져 있고, 아니라면 직접 입력하세요.

Name: 원하는 이름이면 됩니다. 예를 들면 다음과 같습니다.
```
Engram
```
Remote MCP server URL:
```
https://mcp.engram.page
```
브라우저 인증 창이 열립니다. 어떤 화면이 나오는지는 첫 실행 인증을 참고하세요.
스코프 화면에서 요청된 권한을 검토하고 승인합니다.
Claude에게 사용법 알려 주기를 해 두면 Claude가 Engram을 알아서 찾아 씁니다.
사용해 보기로 커넥터가 동작하는지 확인합니다.

첫 실행 인증

처음 연결하면 **Claude Desktop**에서 Engram 로그인을 요청하는 브라우저 창이 자동으로 열립니다. 로그인하고, 허용할 권한에 체크한 뒤 승인을 누르세요. 그러면 브라우저가 자동으로 Claude Desktop 쪽으로 돌려보냅니다. 토큰을 복사해 붙여 넣을 일도, 환경 변수도 없습니다. Google, Dropbox, GitHub에 앱을 연결할 때 쓰는 것과 같은 방식의 로그인 흐름입니다.

브라우저 흐름을 건너뛰고 싶다면(헤드리스, 스크립트, 보관함 공유 환경), 대신 API 키로 인증할 수 있습니다. MCP Config → API 키 인증을 참고하세요.

Claude에게 사용법 알려 주기

커넥터를 추가하는 것은 절반일 뿐입니다. 알려 주지 않으면 Claude는 Engram을 찾아 쓰지 않습니다. Claude의 전역 환경설정에 짧은 지시문을 넣어, 모든 대화가 Engram을 메모리로 쓰도록 하세요.

claude.ai/settings/general을 엽니다.
What personal preferences should Claude consider in responses? 필드(전역 지침 입력란)를 찾습니다.
아래 스니펫을 붙여 넣습니다. 모든 대화에 적용되도록 별도의 줄에 두세요.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

이제 Claude는 무언가를 찾아보거나 당신이 공유한 내용을 저장해야 할 때 Engram을 자동으로 사용합니다.

사용해 보기

연결과 전역 프롬프트 설정이 끝나면 사이드바에 커넥터가 나타납니다. 이렇게 물어보세요.

내 보관함에서 엔지니어 면접 과정에 관한 노트를 검색해서 상위 세 개를 요약해 줘.
지난달에 임베딩에 대해 쓴 내용이 있으면 전부 찾아줘.
'Q3 planning'이라는 제목의 노트를 읽고 할 일 항목을 뽑아줘.
'project-ideas.md'의 frontmatter와 나가는 링크를 보여줘.
'Meeting notes' 폴더에 '디자인 팀 회의, 5월 21일'이라는 제목으로 오늘 회의 요점을 담은 새 노트를 작성해 줘.
'roadmap.md'에 '결정 사항' 섹션을 추가하고 이 세 가지 항목을 넣어줘.
내 보관함의 최상위 폴더를 나열해 줘.
'inbox'에서 'Q4'를 언급하는 노트를 모두 'Q4-planning'으로 옮겨줘.

Claude가 Engram의 search(또는 get_note, write_note 등) 도구를 호출해 결과를 가져오고 그 맥락에서 답합니다.

허용되는 스코프

Claude Desktop은 승인 화면에서 mcp 스코프를 요청합니다. 보관함에 대한 MCP 도구 전체를 포괄하는 단일 허용입니다. 동작별 세분화 스코프(읽기 전용, 삭제 불가 등)는 로드맵에 있습니다. 자세한 내용과 해제 방법은 스코프를 참고하세요.

문제 해결 (Claude Desktop 전용)

인증 창이 열리지 않음. Claude Desktop이 최신 버전인지, 팝업 차단기가 꺼져 있는지 확인하세요.
“Connector failed to load.” MCP URL에 닿는지 확인하세요. 브라우저 탭에 붙여 넣어 보세요. 오류가 아니라 구조화된 응답 페이지가 보인다면 연결은 정상이고 문제는 Claude Desktop 쪽에 있습니다. 재시작한 뒤 다시 시도하세요.

클라이언트와 상관없는 문제(인증 거부, 스코프 오류, 동기화 누락)는 문제 해결을 참고하세요.

연결 해제

어느 쪽에서든 연결을 끊을 수 있고 효과는 같습니다. 편한 쪽을 고르세요.

Claude 앱에서: Settings → Connectors를 열어 Engram을 찾고 Disconnect를 선택합니다.

웹의 Claude에서: claude.ai/customize/connectors로 가서 Engram 커넥터를 클릭하고 Disconnect를 선택합니다.

Engram에서: app.engram.page/settings/connections로 가서 세션을 해제합니다.

어느 쪽이든 OAuth 토큰은 서버에서 무효화되며, 다시 연결하려면 Claude Desktop에서 다시 인증해야 합니다.

다음 단계

MCP프로토콜 개요.

스코프최소 권한 고르기.

모든 연동다른 클라이언트 고르기.