Cursor

Cursor는 MCP를 기본으로 지원합니다. mcp.json 파일을 넣고 Cursor를 재시작하면, 에이전트가 처음 Engram을 호출할 때 브라우저에서 OAuth가 실행됩니다. 프로토콜 배경은 MCP를 참고하세요.

사전 준비

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

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

엔드포인트

https://mcp.engram.page

설정

1. 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 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 전용)

Tools & MCP에 engram 항목이 두 개. 서버가 ~/.cursor/mcp.json과 .cursor/mcp.json 양쪽에 정의되어 있습니다. 하나를 제거하세요(프로젝트 범위가 우선합니다).
Settings에는 서버가 보이는데 에이전트가 호출하지 않음. 일부 Cursor 빌드의 전역 설정 주입 문제로 알려져 있습니다. 우회책: 설정을 프로젝트 수준 .cursor/mcp.json으로 옮기세요.
OAuth가 시작되지 않음. 에이전트가 아직 도구를 호출하지 않았습니다. 에이전트에게 engram의 search 도구를 이름으로 호출하라고 시키세요. 그래도 반응이 없으면 Cursor를 재시작하세요. 오래된 연결 상태가 첫 호출을 막을 수 있습니다.

클라이언트와 상관없는 문제는 문제 해결을 참고하세요.

연결 해제

**Cursor**와 Engram의 연결을 해제하려면 다음과 같이 하세요.

Cursor에서 커넥터 또는 MCP 서버 항목을 찾아 제거합니다.
Engram에서 계정 → API Keys & Sessions를 열어 해당 세션을 해제(revoke)합니다.
OAuth 토큰은 서버에서 무효화됩니다. 다시 연결하려면 Cursor에서 다시 인증해야 합니다.

클라이언트에서 제거하려면 mcp.json에서 engram 블록을 삭제하고 Cursor를 재시작하세요.

다음 단계

MCP프로토콜 개요.

스코프허용 범위가 포함하는 것.

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