Cursor
Cursor는 MCP를 기본으로 지원합니다. mcp.json 파일을 넣고 Cursor를
재시작하면, 에이전트가 처음 Engram을 호출할 때 브라우저에서 OAuth가 실행됩니다.
프로토콜 배경은 MCP를 참고하세요.
사전 준비
섹션 제목: “사전 준비”시작하기 전에 다음 사항을 확인하세요:
- 다음 주소에서 Engram 계정을 가지고 있습니다: app.engram.page.
- 최소 하나의 보관함이 동기화되어 있어야 합니다. Obsidian 플러그인 또는 웹 앱을 열고 최근 하루 동안 메모가 동기화되었는지 확인하세요.
- 브라우저를 통해 로그인할 수 있습니다. MCP 인증 과정은 브라우저 창을 엽니다.
- API 키를 사용하려는 경우: API 키는 모든 요금제에서 사용할 수 있으며, 무료 요금제도 포함됩니다. OAuth 로그인은 여전히 권장되는 방법입니다.
엔드포인트
섹션 제목: “엔드포인트”https://mcp.engram.page1. mcp.json 편집. ~/.cursor/mcp.json(사용자 전역) 또는 프로젝트 루트의
.cursor/mcp.json(프로젝트 범위, 같은 서버 이름이면 전역 설정보다 우선)을
만들거나 편집하세요.
{ "mcpServers": { "engram": { "url": "https://mcp.engram.page" } }}2. Cursor 재시작. 완전히 종료(Cmd+Q / File → Exit)한 뒤 다시 여세요.
창 새로 고침으로는 부족합니다. MCP 서버는 앱 시작 시 등록됩니다.
3. 확인. Settings → Tools & MCP를 열어 서버 목록에 engram이 보이는지
확인하세요.
첫 실행 인증
섹션 제목: “첫 실행 인증”Cursor는 연결할 때 OAuth를 묻지 않습니다. 첫 도구 호출 때 실행됩니다. 새
대화를 열고 에이전트에게 Engram을 검색해 보라고 하세요. 브라우저가 열려 Engram에
로그인하고 연결을 승인합니다. Cursor는 토큰을 저장하고 이후로 계속 재사용합니다.
허용 범위는 전체 mcp 스코프입니다. 동작별 세분화
스코프는 로드맵에 있습니다.
OAuth를 건너뛰려면(헤드리스나 보관함 공유 환경) 블록을 API 키 방식으로 바꾸세요.
{ "mcpServers": { "engram": { "url": "https://mcp.engram.page", "headers": { "Authorization": "Bearer ${env:ENGRAM_API_KEY}" } } }}키는 app.engram.page/settings/api-keys에서
발급받으세요.
Cursor에게 사용법 알려 주기
섹션 제목: “Cursor에게 사용법 알려 주기”아래 스니펫을 Cursor Rules에 추가하세요. 사용자 범위는 ~/.cursor/rules,
프로젝트 범위는 프로젝트의 .cursor/rules/*.mdc 파일입니다.
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.사용해 보기
섹션 제목: “사용해 보기”연결되면 Cursor의 에이전트에게 이렇게 물어보세요.
- 내 보관함에서 엔지니어 면접 과정에 관한 노트를 검색해서 상위 세 개를 요약해 줘.
- 지난달에 임베딩에 대해 쓴 내용이 있으면 전부 찾아줘.
Cursor가 Engram의 search(또는 get_note, write_note 등) 도구를 호출해
결과를 가져오고 그 맥락에서 답합니다. 도구가 실행되면 설정이 끝난 것입니다.
문제 해결 (Cursor 전용)
섹션 제목: “문제 해결 (Cursor 전용)”- Tools & MCP에
engram항목이 두 개. 서버가~/.cursor/mcp.json과.cursor/mcp.json양쪽에 정의되어 있습니다. 하나를 제거하세요(프로젝트 범위가 우선합니다). - Settings에는 서버가 보이는데 에이전트가 호출하지 않음. 일부 Cursor
빌드의 전역 설정 주입 문제로 알려져 있습니다. 우회책: 설정을 프로젝트 수준
.cursor/mcp.json으로 옮기세요. - OAuth가 시작되지 않음. 에이전트가 아직 도구를 호출하지 않았습니다.
에이전트에게 engram의
search도구를 이름으로 호출하라고 시키세요. 그래도 반응이 없으면 Cursor를 재시작하세요. 오래된 연결 상태가 첫 호출을 막을 수 있습니다.
클라이언트와 상관없는 문제는 문제 해결을 참고하세요.
연결 해제
섹션 제목: “연결 해제”**Cursor**와 Engram의 연결을 해제하려면 다음과 같이 하세요.
- Cursor에서 커넥터 또는 MCP 서버 항목을 찾아 제거합니다.
- Engram 앱에서 설정 → 연결을 열고, 연결된 항목 또는 API 키에 해당하는 철회를 클릭하세요.
- API 키가 해제되면 즉시 작동이 중단됩니다. 철회된 OAuth 연결은 더 이상 접근 권한을 갱신할 수 없으며, 현재 접근 토큰은 15분 이내에 만료됩니다. 다시 연결하려면 Cursor에서 다시 인증해야 합니다.
클라이언트에서 제거하려면 mcp.json에서 engram 블록을 삭제하고 Cursor를
재시작하세요.