MCP 소개

**MCP(Model Context Protocol)**는 Anthropic, OpenAI 등 주요 AI 기업이 채택한 새로운 개방형 표준으로, Engram 같은 도구를 AI 어시스턴트에 바로 연결해 줍니다. 범용 커넥터라고 생각하면 됩니다. 표준이 하나라서 Claude, Cursor, ChatGPT 등 MCP를 지원하는 모든 AI 도구가 당신의 노트에 닿을 수 있습니다. 노트를 검색하고, 읽고, 새 노트를 저장할 수 있으며, 권한은 모두 당신이 정합니다.

Engram을 쓰는 데 MCP를 이해할 필요는 없습니다. AI 연동에서 쓰는 AI 도구를 고르고 몇 번 클릭하면 끝입니다. 이 페이지는 배경이 궁금한 분을 위한 것입니다.

MCP란

MCP가 나오기 전에는 노트를 AI 어시스턴트에 넣으려면 복사해 붙여 넣거나, 내보내거나, 앱마다 별도의 연동을 만들어야 했습니다. MCP는 이 연결을 표준화합니다.

• Engram은 MCP 엔드포인트를 하나만 제공합니다 (URL 하나, 프로토콜 하나).
• AI 클라이언트가 MCP를 사용합니다 (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed 등).
• 핸드셰이크는 OAuth입니다. 어떤 클라이언트로 무엇에 닿을 수 있는지는 당신이 통제합니다.
• 도구, 프롬프트, 리소스는 발견 가능합니다. 클라이언트가 Engram에 무엇이 있는지 물으면 Engram이 답합니다. 연동마다 미리 정해 둔 것은 없습니다.

한 줄 비유로, MCP는 AI의 USB-C입니다. 규격은 하나이고, 양쪽 끝에는 다양한 기기가 있습니다.

연결하면 할 수 있는 일

• AI에게 어떤 주제의 노트를 찾아 달라고 하세요. 보관함 전체를 의미 기반으로 검색해 가장 관련 있는 노트를 가져옵니다
• 폴더를 요약하게 하거나 관련 노트를 엮어 보게 할 수 있습니다
• 새 노트 초안을 쓰게 해서 (당신의 승인 후) 보관함에 바로 저장할 수 있습니다
• 노트를 내보내거나, 복사해 붙여 넣거나, 어딘가에 복제하지 않고도 AI 작업 흐름 안에서 Engram의 검색을 쓸 수 있습니다

Claude에게 “지난달에 X에 대해 뭐라고 썼지?” 라고 물으면, Claude가 Engram의 검색 도구를 호출해 실제로 답을 찾아 줍니다.

프로토콜 간단히 보기

깊이 알고 싶은 분을 위한 기술적인 내용입니다. 건너뛰어도 Engram을 쓰는 데는 문제가 없습니다.

Engram은 HTTPS 위에서 MCP를 사용합니다. 구체적으로는 다음과 같습니다.

• 인가: 동적 클라이언트 등록(Dynamic Client Registration, DCR)을 갖춘 OAuth 2.1이라서 클라이언트가 미리 발급된 자격 증명을 가질 필요가 없습니다.
• 디스커버리: GET /.well-known/oauth-authorization-server와 tools/list로 클라이언트가 접근 가능한 범위를 파악합니다.
• 도구: search, get_note, write_note, list_folders 등.
• 리소스: URI로 주소를 지정할 수 있는 노트.
• 스코프: 세션마다 부여하는 세분화된 권한 (스코프 참고).

이 섹션의 페이지

• MCP Config: GUI 대신 설정 파일로 연결하는 사용자를 위한 JSON 스니펫과 경로 표
• 스코프: 각 권한이 허용하는 것
• 문제 해결: 커넥터가 Engram과 통신하지 못할 때

클라이언트별 설정(Claude, Cursor, ChatGPT 등)은 AI 연동을 참고하세요.

대화형 도구 카탈로그(Engram이 제공하는 모든 도구와 입력 스키마, 예시)는 이후 단계에서 제공될 예정이며, 어긋나지 않도록 백엔드 코드에서 직접 생성됩니다.