MCP Config

대부분의 사용자는 이 페이지가 필요하지 않습니다. 최신 AI 클라이언트(Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed)는 모두 몇 번의 클릭으로 Engram을 추가하는 GUI를 제공합니다. 클라이언트별 안내는 AI 연동을 참고하세요.

설정 파일을 직접 편집하고 싶거나 클라이언트에 GUI가 없다면 세 가지 방법이 있습니다. 쉬운 순서대로, AI에게 설정을 맡기거나, 클라이언트별 탭을 따라 하거나, API 키로 OAuth를 아예 건너뛸 수 있습니다.

AI에게 설정 맡기기

가장 빠른 방법입니다. 아래 프롬프트를 AI 어시스턴트에 붙여 넣으세요. AI가 어떤 클라이언트에서 실행 중인지 파악하고, 알맞은 설정 파일을 편집하거나 알맞은 CLI 명령을 실행한 뒤, 다음에 할 일을 알려 줍니다.

Add Engram as an MCP server in this AI client, then teach the AI to use it.

URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.

First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.

After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:

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.

Reference: https://engram.page/docs/mcp/manual-config/

문제가 생기거나 직접 진행하고 싶다면, 아래 클라이언트별 탭에 전체 수동 절차가 있습니다.

Engram의 MCP 엔드포인트

https://mcp.engram.page

Engram은 HTTPS 위에서 MCP를 사용합니다. 인증 방법은 두 가지입니다.

• OAuth (기본). 클라이언트가 위 URL에 처음 연결하면 로그인을 위한 브라우저 창이 열립니다. 이후에는 클라이언트가 토큰을 보관하고 조용히 다시 연결합니다. 복사할 키가 없습니다.
• API 키: 헤드리스, 스크립트, 보관함 공유 환경용입니다. 키를 Authorization 헤더의 Bearer 토큰으로 보냅니다. 아래 API 키 인증을 참고하세요.

어느 쪽이든 환경 변수도, 로컬 서버 프로세스도 필요 없습니다.

클라이언트 설정

아래에서 클라이언트를 고르세요. 각 탭은 설정, 다시 불러오기, 첫 실행 인증, AI가 Engram을 실제로 쓰도록 알려 주는 방법까지 담은 완전한 절차입니다.

셀프 호스트라면 아래 모든 스니펫에서 클라우드 URL 대신 자신의 백엔드 /api/mcp URL을 쓰세요. 기준이 되는 자리 표시자는 위의 엔드포인트 섹션을 참고하세요.

Claude Code

1. Engram 추가. 설정 편집을 대신 처리해 주는 Claude Code CLI를 사용하세요.

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

--scope user 플래그는 모든 프로젝트에서 Engram을 쓸 수 있게 합니다. 이 플래그를 빼거나 --scope project를 쓰면 현재 프로젝트의 .mcp.json에서만 Engram을 쓰게 됩니다.

수동으로 하고 싶다면 ~/.claude.json(사용자 범위) 또는 프로젝트 루트의 .mcp.json에 추가하세요.

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

2. 다시 불러오기. 현재 Claude Code 세션을 종료하고 claude를 다시 실행하세요. claude mcp list를 실행해 Engram이 등록되었는지 확인합니다.

3. 첫 실행 인증. Claude Code는 자동으로 묻지 않습니다. 새 세션에서 /mcp를 실행하고 engram(△ needs authentication으로 표시됨)을 선택한 뒤 Authenticate를 고르세요. 브라우저가 열려 OAuth가 진행됩니다. Engram에 로그인해 연결을 승인하면 Claude Code가 토큰을 저장하고 이후로 계속 재사용합니다. 현재 허용 범위는 전체 mcp 스코프이며, 동작별 세분화 스코프는 로드맵에 있습니다.

4. Claude에게 사용법 알려 주기. 아래 스니펫을 사용자 수준 지침 파일인 ~/.claude/CLAUDE.md에 덧붙이세요. 모든 프로젝트에 적용됩니다.

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

1. 설정 편집. ~/.cursor/mcp.json(사용자 범위) 또는 프로젝트 루트의 .cursor/mcp.json(프로젝트 범위)에 Engram을 추가하세요.

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

2. 다시 불러오기. Cursor를 완전히 종료(Cmd+Q / File → Exit)한 뒤 다시 여세요. 창 새로 고침으로는 부족합니다. MCP 서버는 앱 시작 시 등록됩니다.

3. 첫 실행 인증.

Cursor에서 Engram을 처음 호출하면 OAuth를 위해 브라우저가 열립니다. Engram에 로그인해 연결을 승인하면 끝입니다. 이후에는 토큰이 저장되어 계속 재사용됩니다. 현재 허용 범위는 전체 mcp 스코프이며, 동작별 세분화 스코프는 로드맵에 있습니다.

4. Cursor에게 사용법 알려 주기. 아래 스니펫을 Cursor Rules에 추가하세요. 사용자 범위는 ~/.cursor/rules, 프로젝트 범위는 프로젝트의 .cursor/rules입니다.

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.

VS Code

1. 설정 편집. 워크스페이스의 .vscode/mcp.json에 Engram을 추가하세요. VS Code는 mcpServers 대신 servers를 쓰며 "type": "http"가 필요합니다.

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

2. 다시 불러오기. 명령 팔레트(Cmd+Shift+P / Ctrl+Shift+P)에서 Developer: Reload Window를 실행하세요. VS Code를 완전히 다시 시작할 필요는 없습니다.

3. 첫 실행 인증.

Copilot Chat(또는 MCP를 지원하는 확장 프로그램)에서 Engram을 처음 호출하면 OAuth를 위해 브라우저가 열립니다. Engram에 로그인해 연결을 승인하면 끝입니다. 이후에는 토큰이 저장되어 계속 재사용됩니다. 현재 허용 범위는 전체 mcp 스코프이며, 동작별 세분화 스코프는 로드맵에 있습니다.

4. VS Code에게 사용법 알려 주기. 아래 스니펫을 워크스페이스의 custom instructions(Copilot Chat → 설정 → Custom Instructions, 또는 사용 중인 확장 프로그램의 같은 기능)에 추가하세요.

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.

Windsurf

1. 설정 편집. ~/.codeium/windsurf/mcp_config.json에 Engram을 추가하세요.

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

2. 다시 불러오기. Windsurf를 완전히 종료한 뒤 다시 여세요. 창 새로 고침으로는 MCP 서버가 등록되지 않을 수 있습니다.

3. 첫 실행 인증.

Windsurf에서 Engram을 처음 호출하면 OAuth를 위해 브라우저가 열립니다. Engram에 로그인해 연결을 승인하면 끝입니다. 이후에는 토큰이 저장되어 계속 재사용됩니다. 현재 허용 범위는 전체 mcp 스코프이며, 동작별 세분화 스코프는 로드맵에 있습니다.

4. Windsurf에게 사용법 알려 주기. 아래 스니펫을 Windsurf AI Rules 창(Workspace → AI Rules)에 추가하거나, 사용자 전체 규칙이라면 ~/.codeium/windsurf/global_rules.md에 추가하세요.

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.

Zed

1. 설정 편집. ~/.config/zed/settings.json을 열고 context_servers 아래에 Engram을 추가하세요(표준 mcpServers가 아닌 Zed 고유의 래퍼 키입니다).

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

2. 다시 불러오기. 명령 팔레트(Cmd+Shift+P)에서 zed: reload settings를 실행하세요. 그래도 안 되면 Zed를 완전히 종료한 뒤 다시 여세요.

3. 첫 실행 인증.

Zed의 어시스턴트에서 Engram을 처음 호출하면 OAuth를 위해 브라우저가 열립니다. Engram에 로그인해 연결을 승인하면 끝입니다. 이후에는 토큰이 저장되어 계속 재사용됩니다. 현재 허용 범위는 전체 mcp 스코프이며, 동작별 세분화 스코프는 로드맵에 있습니다.

4. Zed에게 사용법 알려 주기. 아래 스니펫을 settings.json의 어시스턴트 기본 프롬프트(assistant.default_prompt)에 추가하거나 어시스턴트 설정 UI에서 추가하세요.

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.

기타 / 사용자 지정

1. 설정 편집. 대부분의 MCP 클라이언트는 표준 mcpServers 래퍼를 받아들입니다.

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

클라이언트가 이 형태를 인식하지 못하면 문서에서 어떤 래퍼 키를 기대하는지 확인하세요(VS Code는 servers, Zed는 context_servers를 씁니다).

2. 다시 불러오기. 대부분의 클라이언트는 새 MCP 서버를 등록하려면 창 새로 고침이 아니라 완전한 재시작이 필요합니다.

3. 첫 실행 인증.

클라이언트에서 Engram을 처음 호출하면 OAuth를 위해 브라우저가 열립니다. Engram에 로그인해 연결을 승인하면 끝입니다. 이후에는 토큰이 저장되어 계속 재사용됩니다. 현재 허용 범위는 전체 mcp 스코프이며, 동작별 세분화 스코프는 로드맵에 있습니다.

4. AI에게 사용법 알려 주기. 아래 스니펫을 클라이언트가 장기 시스템 지침 또는 전역 지침을 받는 곳에 넣으세요.

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.

API 키 인증

기본은 OAuth입니다. 헤드리스나 스크립트 접근, 연결별 제어(쓰기 가능한 봇과 읽기 전용 에이전트), 전체 로그인 권한을 주지 않는 보관함 공유에는 API 키를 쓰세요. 키 하나로 MCP와 REST API를 모두 인증합니다. 현재는 모든 키가 계정의 전체 접근 권한을 가지며, 키별 세분화 스코프는 로드맵에 있습니다.

키 발급받기

app.engram.page/settings/api-keys에서 키를 만드세요. Engram은 전체 키를 만들 때 한 번만 보여 주고, 그 뒤에는 접두사만 표시합니다. 비밀번호처럼 다루고 안전한 곳에 보관하세요.

설정에 추가하기

키를 Bearer 토큰으로 보내는 headers 블록을 추가하세요. 래퍼 키 (mcpServers / servers / context_servers)는 설정 중인 클라이언트에 따라 달라지므로, 위 탭에서 본 것과 같은 형태를 쓰세요. 표준 mcpServers 클라이언트라면 다음과 같습니다.

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer engram_YOUR_KEY_HERE"
      }
    }
  }
}

API 키를 설정하면 처음 연결할 때 브라우저가 열리지 않습니다. 키로 즉시 인증됩니다. 교체하려면 설정에서 새 키를 만들고 설정 파일의 값을 바꾸세요.

주의

키를 비밀번호처럼 다루세요. 버전 관리에 커밋하지 마세요. API 키가 체크인되는 mcp.json 파일에 들어가지 않게 하세요. 클라이언트가 지원한다면 환경 변수 치환을 쓰거나, 설정을 프로젝트 수준이 아닌 사용자 수준 파일에 두세요.

문제 해결

• 편집했는데 클라이언트가 Engram을 인식하지 못함. 창만 새로 고치지 말고 클라이언트를 완전히 다시 시작하세요.
• 인증용 브라우저가 열리지 않음. 팝업 차단기가 막고 있지 않은지 확인하세요. 일부 클라이언트는 OAuth 창을 자체 브라우저 로직으로 처리하는데, 차단되면 아무 표시 없이 실패합니다.
• Failed to connect. URL에 닿는지 확인하세요. 클라이언트와 상관없는 문제는 문제 해결을 참고하세요.

클라이언트별 GUI 흐름은 AI 연동을 참고하세요.