Claude Code

CLI-команда Claude Code claude mcp add сама правит конфигурацию и хранит регистрацию на уровне проекта или пользователя. OAuth проходит в браузере при первом вызове инструмента Engram. О протоколе см. MCP.

Требования

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

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

Эндпоинт

https://mcp.engram.page

Настройка

1. Зарегистрируйте Engram через CLI Claude Code.

claude mcp add --transport http --scope user engram https://mcp.engram.page

--scope user делает Engram доступным во всех проектах. Используйте --scope project, чтобы ограничить Engram файлом .mcp.json текущего репозитория.

Предпочитаете править вручную? Добавьте блок ниже в ~/.claude.json (на уровне пользователя) или в .mcp.json в корне проекта:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Перезагрузите. Завершите текущий сеанс Claude Code и снова запустите claude. Выполните claude mcp list, чтобы убедиться, что Engram зарегистрирован. Он должен отображаться со статусом △ needs authentication.

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

Claude Code не предлагает OAuth сам. В новом сеансе выполните /mcp, выберите engram, затем нажмите Authenticate. В браузере откроется вход в Engram и подтверждение подключения. Claude Code сохраняет токен и дальше использует его. Выдаётся полная область mcp. Детальные области по отдельным действиям есть в планах.

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

Добавьте приведённый ниже фрагмент в ~/.claude/CLAUDE.md, файл инструкций Claude Code уровня пользователя. Он применяется ко всем проектам. Переопределения для отдельного репозитория пишутся в CLAUDE.md уровня проекта в корне репозитория.

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:

Найди в моём хранилище заметки о процессе технических собеседований и кратко изложи три самые важные.
Найди всё, что я писал об эмбеддингах за последний месяц.

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

API-ключ вместо OAuth

Для headless-машин, CI или общего хранилища пропустите OAuth и привяжите подключение к API-ключу Engram. Создайте его на странице app.engram.page/settings/api-keys и передавайте в заголовке Bearer.

Быстрый вариант записывает ключ прямо в файл конфигурации:

claude mcp add --transport http --scope user engram https://mcp.engram.page \
  --header "Authorization: Bearer engram_YOUR_KEY_HERE"

Для --scope user это нормально (~/.claude.json остаётся на вашей машине). Для --scope project это недопустимо, потому что .mcp.json предназначен для коммита. Вместо этого загружайте ключ из окружения.

Загрузка ключа из переменной окружения

Claude Code раскрывает ${VAR} и ${VAR:-default} при чтении .mcp.json. Для HTTP-серверов подстановка охватывает поля url и headers, то есть именно то место, где находится API-ключ. Закоммитьте вот это:

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer ${ENGRAM_API_KEY}"
      }
    }
  }
}

В репозитории остаётся только имя переменной. Каждый участник подставляет свой ключ, а Engram привязывает каждый ключ к его собственной учётной записи, так что общий .mcp.json никогда не означает общего хранилища.

Claude Code читает окружение, с которым был запущен, поэтому экспортируйте ключ до запуска claude:

export ENGRAM_API_KEY="engram_YOUR_KEY_HERE"

Для ключа на уровне репозитория используйте direnv и храните значение в .envrc, добавленном в gitignore:

export ENGRAM_API_KEY="engram_YOUR_KEY_HERE"

Один раз выполните direnv allow, затем запускайте claude из этого каталога.

Если переменная не задана, конфигурация всё равно загрузится, а Claude Code отправит буквальную строку Bearer ${ENGRAM_API_KEY}, которую Engram отклонит с ошибкой 401. claude mcp list сообщает об этом:

[Warning] [engram] mcpServers.engram: Missing environment variables: ENGRAM_API_KEY

Если настройка с ключом не подключается, сначала поищите эту строку.

С использованием ключа меняются две вещи. Браузер не открывается при первом подключении, а /mcp больше не предлагает Authenticate: заданный заголовок Authorization полностью отключает запасной вариант с OAuth. О том, что охватывает ключ и как его сменить, см. MCP Config → API Key Authentication.

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

claude mcp list не показывает engram. Команда выполнена в другой области, чем ожидалось. Проверьте запись и в ~/.claude.json (пользователь), и в .mcp.json (проект), затем повторите claude mcp add с нужным флагом --scope.
/mcp не показывает engram в списке. Вы не завершили и не перезапустили CLI после claude mcp add. Перезапустите claude.
Пункт Authenticate ничего не делает или браузер не открывается. Headless- или удалённый сеанс не может открыть браузер. Запустите Claude Code на хосте с браузером на рабочем столе или используйте API-ключ.

Об общих для всех клиентов сбоях см. Устранение неполадок.

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

Чтобы отключить Claude Code от Engram:

В Claude Code найдите запись коннектора или MCP-сервера и удалите её.
В Engram откройте свою учётную запись → API Keys & Sessions и отзовите соответствующую сессию.
OAuth-токен аннулируется на стороне сервера. Чтобы подключиться снова, Claude Code потребуется пройти повторную аутентификацию.

Регистрацию можно также удалить локально командой claude mcp remove engram. Это удалит запись конфигурации, но токен на сервере останется действующим, пока вы не отзовёте его в Engram.

Дальше

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

Области доступаЧто охватывает разрешение.

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