Engram을 AI에 연결하기

Engram은 원격 MCP 서버입니다. 아래 모든 클라이언트는 같은 URL에 연결해 OAuth로 로그인한 뒤, 보관함의 노트를 읽고 씁니다. 설치할 것도 없고 Obsidian을 열어 둘 필요도 없습니다.

https://mcp.engram.page

서버는 Streamable HTTP를 사용하고 OAuth 2.1로 인증합니다. 클라이언트가 스스로 등록하므로 클라이언트 ID나 시크릿을 복사할 일이 없습니다.

시작하기 전에

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

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

Claude (웹 및 데스크톱)

claude.ai/customize/connectors를 엽니다. 여기서 한 설정은 claude.ai와 데스크톱 앱 모두에 적용됩니다.
**+**를 누른 뒤 Add custom connector를 선택합니다.
이름에 Engram을, 원격 MCP 서버 URL에 https://mcp.engram.page를 입력합니다. Advanced settings는 비워 둡니다.
Add, Connect를 차례로 누르고 로그인 창에서 승인합니다.

Claude의 무료 플랜은 커스텀 커넥터를 하나 허용합니다. 자세한 안내: Claude Desktop.

ChatGPT

커스텀 커넥터는 ChatGPT의 Developer mode 뒤에 있으며, 웹 앱에서 해당되는 유료 플랜으로 사용할 수 있습니다. Business나 Enterprise 워크스페이스에서는 관리자가 먼저 허용해야 합니다.

Settings → Apps → Advanced settings로 가서 Developer mode를 켭니다.
Settings → Apps로 돌아와 Create app을 누릅니다.
이름을 Engram으로, MCP 서버 URL을 https://mcp.engram.page로 정하고 인증은 OAuth를 선택합니다.
Scan Tools를 누르고 끝날 때까지 기다립니다.
Create를 누르고 로그인 창에서 승인합니다.
대화에서 입력창의 도구 메뉴에 있는 Engram을 선택합니다.

Business 워크스페이스에서는 관리자가 게시할 때까지 앱이 Workspace settings → Apps → Drafts에 있습니다.

자세한 안내: ChatGPT.

Grok

Grok에는 Engram이 커넥터 디렉터리에 올라 있지 않습니다. URL로 커스텀 커넥터를 추가하세요.

grok.com/connectors를 엽니다.
New Connector를 누른 뒤 Custom을 선택합니다.
https://mcp.engram.page를 붙여 넣고 로그인을 완료합니다.

Grok 앱이 아니라 xAI API로 개발하시나요? Grok (xAI API)를 참고하세요.

Cursor

~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(프로젝트 하나)에 Engram을 추가하세요.

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

Cursor를 완전히 종료했다가 다시 여세요. 에이전트가 Engram 도구를 처음 호출할 때 로그인 창이 열립니다. 자세한 안내: Cursor.

VS Code

VS Code는 Copilot Chat의 Agent 모드에서 MCP 서버를 읽습니다. 명령 팔레트에서 MCP: Add Server를 실행하거나 .vscode/mcp.json에 다음을 추가하세요.

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

engram 항목 위의 Auth 코드 렌즈를 눌러 로그인하세요. 자세한 안내: GitHub Copilot.

Claude Code

claude mcp add --transport http engram https://mcp.engram.page

claude를 다시 시작하고 /mcp를 실행해 engram을 고른 뒤 Authenticate를 선택하세요. 모든 프로젝트에서 Engram을 쓰려면 --scope user를 추가하세요. 자세한 안내: Claude Code.

모든 MCP 클라이언트

클라이언트가 원격 MCP 서버를 지원한다면 다음을 입력하세요.

URL: https://mcp.engram.page
전송 방식: Streamable HTTP
인증: OAuth. Engram은 인가 서버 메타데이터를 공개하고 동적 클라이언트 등록(Dynamic Client Registration)을 받으므로, 규격을 따르는 클라이언트라면 다른 것은 필요 없습니다.

브라우저 로그인을 실행할 수 없는 클라이언트는 대신 Engram API 키를 Bearer 헤더로 보낼 수 있습니다. API 키에는 Pro가 필요합니다. 두 방식의 설정 형태는 MCP Config에 있습니다.

첫 로그인

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

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

동작 확인

노트만 답할 수 있는 질문을 AI에게 해 보세요. 예를 들면 다음과 같습니다.

배포 노트에서 POOL_SIZE를 어떤 값으로 설정했지?

보관함의 내용으로 답한다면 연결된 것입니다. 그렇지 않다면 문제 해결을 참고하세요.

연결 해제

AI 클라이언트에서 커넥터를 제거한 다음, app.engram.page/settings/connections에서 해당 세션을 해제하세요.