시작하기

Engram은 마크다운 노트를 위한 실시간 동기화, 시맨틱 검색, AI 접근 계층입니다. 노트는 계속 일반 .md 파일로 당신의 소유로 남습니다. 가장 풍부한 기록 환경을 원하면 Obsidian과 함께 쓰고, Engram 웹 앱과 Claude 같은 AI 어시스턴트만으로 작업해도 됩니다. 보관함은 이 모두에 동기화되며, MCP 엔드포인트를 통해 AI 도구가 당신의 허락 아래 노트를 읽고 수정할 수 있습니다.

구성 방식

┌──────────────────────┐         ┌──────────────────────┐
│  Obsidian            │ ◄────►  │  Engram backend      │
│  + Engram plugin     │  sync   │  (Elixir / Phoenix)  │
└──────────────────────┘         └──────────┬───────────┘
                                            │
   ┌────────────────────────────────────────┤
   │                                        │
   ▼                                        ▼
┌──────────────────┐               ┌──────────────────┐
│  Web app         │               │  AI assistants   │
│  (browser)       │               │  via MCP         │
└──────────────────┘               └──────────────────┘

같은 보관함 데이터를 세 가지 인터페이스로 다룹니다.

Obsidian 플러그인이 기본 기록 창구입니다. 노트는 Obsidian에서 작성되어 실시간으로 백엔드에 동기화됩니다.
웹 앱은 app.engram.page에 있습니다. 어떤 브라우저에서든 보관함을 둘러보고, 검색하고, 편집할 수 있습니다. 위키링크, 임베드, KaTeX, Mermaid를 Obsidian과 같은 방식으로 렌더링합니다.
MCP 엔드포인트는 Claude, Cursor, ChatGPT 등 보관함과 대화할 수 있는 AI 어시스턴트를 연결합니다. 노트가 도구 호출로 접근 가능해집니다.

클라우드 또는 셀프 호스팅

Engram은 호스팅 서비스로도, 직접 운영하는 인프라에서도 실행됩니다. 원하는 쪽을 고르세요.

	클라우드	셀프 호스팅
위치	`app.engram.page`	내 서버 (Docker)
운영	관리형	직접 운영
임베딩 모델	Voyage AI (호스팅)	Ollama (로컬) 또는 직접 준비
저장소	AWS S3	MinIO / 내 S3
결제	Paddle을 통한 구독	무료, 하드웨어 비용은 본인 부담
라이선스	당사 약관에 따른 호스팅	PolyForm Small Business 1.0.0
이런 분께	그냥 잘 돌아가면 좋은 분	주권, 대용량 보관함, 연구용

플러그인은 양쪽이 같으며, 백엔드 URL만 다르게 지정하면 됩니다. 보관함 내용은 어느 쪽이든 Obsidian에 있으므로, 쪽을 옮기는 일은 플러그인을 다시 지정하고 보관함을 다시 올리는 것으로 끝납니다. 클라우드 ↔ 셀프 호스팅 간 자동 내보내기/가져오기 도구는 로드맵에 있습니다. 현재는 수동 방식입니다(Obsidian에서 옮겨 갈 쪽으로 다시 올리면 됩니다).

클라우드 빠른 시작

다섯 단계, 약 5분이 걸립니다.

app.engram.page에서 가입하고 온보딩 마법사를 마칩니다(약관 동의, 요금제 선택).
Obsidian에 Engram Vault Sync 플러그인을 설치합니다. 설정 → 커뮤니티 플러그인 → 탐색을 열어 Engram Vault Sync를 검색하거나, community.obsidian.md/plugins/engram-vault-sync 목록 페이지를 바로 엽니다.
플러그인에서 Engram 계정으로 로그인합니다. 플러그인이 OAuth 창을 열면 승인하세요.
동기화할 보관함을 고릅니다. Engram이 최초 스냅샷을 올린 뒤 실시간으로 유지합니다.
검색하고 사용합니다. 웹 앱이나 명령 팔레트에서 시맨틱 검색을 써 보세요. 노트는 Obsidian, 웹 앱, 그리고 (설정 후) MCP 클라이언트에서 접근할 수 있습니다.

셀프 호스팅 빠른 시작

Engram을 직접 서버에서 실행하려면 셀프 호스팅으로 이동하세요. 요약하면 Docker Compose 스택을 받아 환경 변수 몇 개를 설정하고 docker compose up을 실행합니다. 전체 가이드에서 환경 설정, 암호화 설정, 백업, 업그레이드 방법을 다룹니다.

AI 어시스턴트 연결

보관함이 동기화되면 Claude Desktop(또는 아무 MCP 클라이언트)에 연결하세요. 노트가 검색하고 쓸 수 있는 도구가 됩니다. 클라이언트별 설정은 AI 연동을, 프로토콜 수준의 배경은 AI / MCP를 참고하세요.

다음 단계

왜 Engram인가요? 왜 Engram인가를 읽어 보세요.
처음이신가요? Obsidian 플러그인부터 시작하세요.
셀프 호스팅하시나요? 셀프 호스팅을 처음부터 끝까지 읽으세요.
어떻게 작동하는지 궁금하신가요? 개념에서 시맨틱 검색, 암호화 모델, 동기화 알고리즘을 훑어보세요.
연동을 만드시나요? API 레퍼런스 + AI / MCP.
요금이나 결제 문의가 있으신가요? 결제.