Claude Desktop

Интерфейс Connectors в Claude Desktop — самый гладкий способ подключить Engram. Нужно вставить URL и войти: без файлов конфигурации и без API-ключей, которые надо копировать. Что происходит под капотом, описано в разделе MCP.

Требования

Прежде чем начать, убедитесь, что:

У вас есть учётная запись Engram на app.engram.page.
Синхронизировано хотя бы одно хранилище. Откройте плагин Obsidian или веб-приложение и проверьте, что заметки синхронизировались за последние сутки.
Вы можете войти через браузер. Для авторизации MCP открывается окно браузера.
Если вы собираетесь использовать API-ключ вместо OAuth: API-ключи доступны на Pro. Вход через OAuth работает на любом тарифе, включая Free, и это рекомендуемый путь. На Free и Starter создавать и использовать API-ключи нельзя.

Настройка

Откройте страницу Add Engram connector. Она запускает настройку коннектора Claude с уже заполненными именем и URL Engram. Эти настройки действуют и в настольном приложении, и на claude.ai.

Хотите сделать вручную? Перейдите на claude.ai/customize/connectors и нажмите кнопку +, чтобы добавить пользовательский коннектор.
Заполните два поля и нажмите Add. Оба уже заполнены, если вы открыли окно по ссылке выше; иначе введите их сами.

Name: любое, например:
```
Engram
```
Remote MCP server URL:
```
https://mcp.engram.page
```
Откроется окно авторизации в браузере. О том, чего ожидать, см. Первая авторизация.
Просмотрите запрашиваемые разрешения на экране областей доступа и подтвердите.
Скажите Claude, как этим пользоваться, чтобы он обращался к Engram автоматически.
Попробуйте, чтобы убедиться, что коннектор работает.

Первая авторизация

При первом подключении Claude Desktop автоматически открывает окно браузера с предложением войти в Engram. Войдите, отметьте разрешения, которые хотите предоставить, и нажмите Approve. Браузер сам возвращает вас в Claude Desktop. Копировать токены не нужно, переменные окружения не нужны. Это тот же вход, каким вы подключаете любое приложение к Google, Dropbox или GitHub.

Если браузерный вход вам не подходит (headless-среда, скрипты или общие хранилища), можно авторизоваться с помощью API-ключа. См. MCP Config → API Key Authentication.

Как научить Claude пользоваться им

Добавить коннектор — полдела. Claude не станет обращаться к Engram, пока вы ему об этом не скажете. Добавьте короткую инструкцию в глобальные настройки Claude, чтобы в каждой беседе он знал: Engram служит памятью.

Откройте claude.ai/settings/general.
Найдите поле What personal preferences should Claude consider in responses? (поле глобальных инструкций).
Вставьте этот фрагмент. Оставьте его на отдельной строке, чтобы он действовал в каждой беседе:

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.

Теперь Claude сам обращается к Engram, когда нужно что-то найти или сохранить то, чем вы поделились.

Попробуйте

Когда коннектор подключён и глобальный промпт добавлен, коннектор появляется на боковой панели. Попробуйте спросить:

Найди в моём хранилище заметки о процессе технических собеседований и кратко изложи три самые важные.
Найди всё, что я писал об эмбеддингах за последний месяц.
Прочитай мою заметку «Q3 planning» и выпиши из неё задачи.
Покажи frontmatter и исходящие ссылки в 'project-ideas.md'.
Создай черновик заметки «Sync with design, May 21» в моей папке «Meeting notes» с сегодняшними выводами.
Добавь в 'roadmap.md' раздел «Decisions» с этими тремя пунктами.
Покажи папки верхнего уровня в моём хранилище.
Перенеси всё из 'inbox', где упоминается 'Q4', в 'Q4-planning'.

Claude вызывает инструмент Engram search (или get_note, write_note и т. д.), получает результаты и отвечает с учётом контекста.

Выданные области доступа

Claude Desktop запрашивает область mcp на экране подтверждения. Это единое разрешение, которое охватывает весь набор MCP-инструментов для вашего хранилища. Детальные области по отдельным действиям (только чтение, без удаления и т. д.) есть в планах. Подробности и порядок отзыва см. в разделе Области доступа.

Устранение неполадок (специфично для Claude Desktop)

Окно авторизации не открывается. Убедитесь, что Claude Desktop последней версии и что блокировщик всплывающих окон не активен.
«Connector failed to load». Проверьте, что MCP URL доступен. Вставьте его во вкладку браузера. Если вы видите страницу со структурированным ответом, а не ошибку, соединение в порядке, а проблема на стороне Claude Desktop. Перезапустите его и повторите.

Об общих для всех клиентов сбоях (отказ в авторизации, ошибки областей, расхождения синхронизации) см. Устранение неполадок.

Отзыв доступа

Отключение действует с любой из сторон. Выберите, что удобнее:

Через приложение Claude: откройте Settings → Connectors, найдите Engram и выберите Disconnect.

Через Claude в вебе: перейдите на claude.ai/customize/connectors, нажмите на коннектор Engram и выберите Disconnect.

Через Engram: перейдите на app.engram.page/settings/connections и отключите сессию.

В любом случае OAuth-токен аннулируется на стороне сервера, и Claude Desktop потребуется пройти аутентификацию заново, чтобы подключиться.

Дальше

MCPОбзор протокола.

Области доступаВыберите минимально необходимые разрешения.

Все интеграцииВыберите другой клиент.