스코프

Engram을 MCP 커넥터로 추가하면 클라이언트는 OAuth 액세스 토큰을 받습니다. 이 토큰에는 클라이언트가 보관함에서 무엇을 할 수 있는지 결정하는 스코프가 들어 있습니다.

현재 토큰이 허용하는 것

현재 Engram의 MCP 엔드포인트는 하나로 통합된 스코프인 **mcp**만 제공합니다.

mcp 권한을 가진 토큰은 클라이언트에게 MCP 도구의 모든 기능을 제공합니다: 노트 읽기, 의미 검색, 노트 작성, 폴더 편집, 파일 첨부. 이 권한은 개별 작업별로 세분화되지 않지만, 연결 시 동의 화면에서 선택한 보관함으로 제한됩니다. 특정 보관함만 선택하거나, 모든 보관함 (나중에 생성하는 보관함 포함)을 선택할 수 있습니다.

세분화된 스코프는 계획 중입니다

mcp를 동작별 스코프(notes:read, notes:search, notes:write, notes:delete, folders:write, metadata:read)로 나누는 것은 로드맵에 있습니다. 출시되면 커넥터 흐름에서 에이전트에 필요한 최소한의 권한만 허용할 수 있게 됩니다(“읽기와 검색은 되지만 쓰기는 안 됨”). 지금처럼 전부 허용하거나 전부 거부하는 방식이 아니게 됩니다.

세분화된 권한이 지금 당장 중요하다면 우회책은 보관함에 쓰기를 맡길 만큼 신뢰하지 않는 에이전트는 연결하지 않는 것입니다. 한 번 발급된 허용 범위를 프로토콜 안에서 제한하는 방법은 현재 없습니다.

접근 감사와 해제

Engram 앱의 설정 → 연결에서는 모든 활성화된 OAuth 연결 및 API 키 목록을 확인할 수 있습니다. 철회를 클릭하여 연결을 해제하세요.

• API 키가 해제되면 즉시 작동이 중단됩니다.
• 철회된 OAuth 연결은 더 이상 접근 권한을 갱신할 수 없으며, 현재 접근 토큰은 15분 이내에 만료됩니다.

스코프 문법 (SDK 개발자용)

엔드포인트는 지원하는 스코프를 /.well-known/oauth-authorization-server로 알립니다. 세분화된 분할은 이 메타데이터에 가장 먼저 나타나므로, SDK 개발자는 스코프 문자열을 하드코딩하지 말고 이 메타데이터를 읽어야 합니다.