Области доступа
Когда вы добавляете Engram как MCP-коннектор, клиент получает OAuth-токен доступа. Токен несёт область доступа (scope), которая определяет, что клиент может делать с вашим хранилищем.
Что токен даёт сейчас
Заголовок раздела «Что токен даёт сейчас»Сейчас MCP-эндпоинт Engram работает с одной монолитной областью: mcp.
Токен с областью mcp предоставляет клиенту полный набор функций MCP: чтение заметок, семантический поиск, запись заметок, редактирование папок, прикрепление файлов. Он не разделен на отдельные разрешения для каждой операции, но ограничен хранилищами, которые вы выбираете на экране согласия при подключении. Вы можете выбрать определенные хранилища или все хранилища (включая хранилища, которые вы создадите позже).
Детальные области доступа запланированы
Заголовок раздела «Детальные области доступа запланированы»Разделение mcp на области по действиям (notes:read,
notes:search, notes:write, notes:delete, folders:write,
metadata:read) есть в планах. После выпуска при подключении коннектора
можно будет выдать агенту минимально необходимые разрешения
(«читать и искать, но никогда не писать»), а не всё сразу, как сейчас.
Если детальные разрешения важны вам уже сейчас, обходной путь такой: не подключайте агентов, которым вы не доверяете запись в своё хранилище. Ограничить выданные права средствами протокола сейчас нельзя.
Аудит и отзыв доступа
Заголовок раздела «Аудит и отзыв доступа»В приложении Engram раздел Настройки → Подключения содержит список всех активных OAuth-соединений и API-ключей. Нажмите Отменить доступ, чтобы отключить один из них:
- Отзыв ключа API немедленно прекращает его работу.
- Отмененное подключение OAuth больше не может обновить доступ, а текущий токен доступа истекает через 15 минут.
Грамматика областей (для разработчиков SDK)
Заголовок раздела «Грамматика областей (для разработчиков SDK)»Эндпоинт публикует поддерживаемые области через
/.well-known/oauth-authorization-server. Разработчикам SDK стоит читать
эти метаданные, а не прописывать строки областей в коде, потому что
детальное разбиение появится там в первую очередь.