MCP Config

Большинству пользователей эта страница не понадобится. Каждый современный ИИ-клиент (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed) имеет графический интерфейс, который добавляет Engram за несколько кликов. Пошаговые инструкции по клиентам см. в разделе ИИ-интеграции.

Если вы предпочитаете править файл конфигурации (или у вашего клиента нет графического интерфейса), есть три пути, от простого к сложному: поручить настройку своему ИИ, пройти инструкцию на вкладке нужного клиента или вовсе обойтись без OAuth, используя API-ключ.

Пусть ваш ИИ всё настроит

Самый быстрый путь: вставьте приведённый ниже промпт в своего ИИ-ассистента. Он определит, в каком клиенте работает, отредактирует нужный файл конфигурации (или выполнит нужную команду CLI) и подскажет, что делать дальше.

Add Engram as an MCP server in this AI client, then teach the AI to use it.

URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.

First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.

After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:

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.

Reference: https://engram.page/docs/mcp/manual-config/

Если что-то пойдёт не так (или вы хотите всё сделать сами), на вкладках клиентов ниже есть полная инструкция для ручной настройки.

MCP-эндпоинт Engram

https://mcp.engram.page

Engram работает с MCP по HTTPS. Есть два способа аутентификации:

• OAuth (по умолчанию). При первом подключении клиента к указанному выше URL открывается окно браузера для входа. После этого клиент хранит токен и подключается заново без вашего участия. Копировать ключи не нужно.
• API-ключ для headless-сред, скриптов и общих хранилищ. Передавайте ключ как токен Bearer в заголовке Authorization. См. Аутентификация по API-ключу ниже.

В обоих случаях переменные окружения и локальный серверный процесс не нужны.

Настройка клиента

Выберите свой клиент на вкладках ниже. Каждая вкладка — полная инструкция: конфигурация, перезагрузка, первая авторизация и то, где научить ИИ действительно пользоваться Engram.

Для самостоятельного хостинга замените облачный URL в любом из фрагментов ниже на URL /api/mcp вашего собственного бэкенда. Канонические значения-заполнители см. в разделе эндпоинты выше.

Claude Code

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 зарегистрирован.

3. Первая авторизация. Claude Code не предлагает её сам. В новом сеансе выполните /mcp, выберите engram (рядом будет △ needs authentication), затем выберите Authenticate. В браузере откроется OAuth. Войдите в Engram, подтвердите подключение, и Claude Code сохранит токен и будет использовать его дальше. Сейчас выдаётся полная область mcp; детальные области по отдельным действиям есть в планах.

4. Скажите Claude пользоваться им. Добавьте приведённый ниже фрагмент в ~/.claude/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.

Cursor

1. Измените конфигурацию. Добавьте Engram в ~/.cursor/mcp.json (на уровне пользователя) или в .cursor/mcp.json в корне проекта (на уровне проекта):

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

2. Перезагрузите. Полностью закройте Cursor (Cmd+Q / File → Exit) и откройте снова. Перезагрузки окна недостаточно: MCP-серверы регистрируются при запуске приложения.

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

При первом обращении Cursor к Engram в браузере открывается окно OAuth. Войдите в Engram, подтвердите подключение, и всё. Cursor сохранит токен и будет использовать его дальше. Сейчас выдаётся полный доступ в рамках области mcp; детальные области по отдельным действиям есть в планах.

4. Скажите Cursor пользоваться им. Добавьте приведённый ниже фрагмент в правила Cursor: ~/.cursor/rules (на уровне пользователя) или .cursor/rules в проекте.

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.

VS Code

1. Измените конфигурацию. Добавьте Engram в .vscode/mcp.json в вашем рабочем пространстве. VS Code использует servers вместо mcpServers и требует "type": "http":

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

2. Перезагрузите. Выполните Developer: Reload Window из палитры команд (Cmd+Shift+P / Ctrl+Shift+P). Полный перезапуск VS Code не требуется.

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

При первом обращении Copilot Chat (или вашего расширения с поддержкой MCP) к Engram в браузере открывается окно OAuth. Войдите в Engram, подтвердите подключение, и всё. Copilot Chat (или вашего расширения с поддержкой MCP) сохранит токен и будет использовать его дальше. Сейчас выдаётся полный доступ в рамках области mcp; детальные области по отдельным действиям есть в планах.

4. Скажите VS Code пользоваться им. Добавьте приведённый ниже фрагмент в custom instructions вашего рабочего пространства (Copilot Chat → настройки → Custom Instructions или аналог в вашем расширении).

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.

Windsurf

1. Измените конфигурацию. Добавьте Engram в ~/.codeium/windsurf/mcp_config.json:

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

2. Перезагрузите. Полностью закройте Windsurf и откройте снова. Перезагрузка окна может не запустить регистрацию MCP-сервера.

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

При первом обращении Windsurf к Engram в браузере открывается окно OAuth. Войдите в Engram, подтвердите подключение, и всё. Windsurf сохранит токен и будет использовать его дальше. Сейчас выдаётся полный доступ в рамках области mcp; детальные области по отдельным действиям есть в планах.

4. Скажите Windsurf пользоваться им. Добавьте приведённый ниже фрагмент в панель AI Rules Windsurf (Workspace → AI Rules) или в ~/.codeium/windsurf/global_rules.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.

Zed

1. Измените конфигурацию. Откройте ~/.config/zed/settings.json и добавьте Engram в context_servers (это собственный ключ-обёртка Zed, а не стандартный mcpServers):

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

2. Перезагрузите. Выполните zed: reload settings из палитры команд (Cmd+Shift+P). Если не помогает, полностью закройте Zed и откройте снова.

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

При первом обращении ассистента Zed к Engram в браузере открывается окно OAuth. Войдите в Engram, подтвердите подключение, и всё. ассистента Zed сохранит токен и будет использовать его дальше. Сейчас выдаётся полный доступ в рамках области mcp; детальные области по отдельным действиям есть в планах.

4. Скажите Zed пользоваться им. Добавьте приведённый ниже фрагмент в промпт ассистента по умолчанию в settings.json (в assistant.default_prompt) или через интерфейс настроек ассистента.

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.

Other / Custom

1. Измените конфигурацию. Большинство MCP-клиентов принимают стандартную обёртку mcpServers:

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

Если ваш клиент не распознаёт такую структуру, посмотрите в его документации, какой ключ-обёртку он ожидает (VS Code использует servers, Zed использует context_servers).

2. Перезагрузите. Большинству клиентов нужен полный перезапуск, а не просто перезагрузка окна, чтобы новые MCP-серверы зарегистрировались.

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

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

4. Скажите своему ИИ пользоваться им. Вставьте приведённый ниже фрагмент туда, куда ваш клиент принимает долговременные системные или глобальные инструкции.

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.

Аутентификация по API-ключу

OAuth используется по умолчанию. API-ключ нужен для headless- и скриптового доступа, для раздельного контроля подключений (бот с правом записи или агент только для чтения) и для общего доступа к хранилищу без полноценного входа. Один ключ аутентифицирует и MCP, и REST API. Сейчас каждый ключ несёт полный доступ вашей учётной записи; детальные области для отдельных ключей есть в планах.

Получение ключа

Создайте ключ на странице app.engram.page/settings/api-keys. Engram показывает полный ключ один раз при создании, затем только его префикс. Относитесь к нему как к паролю и сохраните в надёжном месте.

Добавление в конфигурацию

Добавьте блок headers, передающий ключ как токен Bearer. Ключ-обёртка (mcpServers / servers / context_servers) зависит от настраиваемого клиента, поэтому используйте ту же структуру, что показана на вашей вкладке выше. Для стандартных клиентов с mcpServers:

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

Когда ключ задан, при первом подключении браузер не открывается; ключ аутентифицирует сразу. Чтобы сменить ключ, создайте новый в настройках и замените значение в конфигурации.

Осторожно

Относитесь к ключу как к паролю. Не добавляйте его в систему контроля версий; не храните API-ключи в файлах mcp.json, которые попадают в репозиторий. Либо используйте подстановку переменных окружения, если клиент её поддерживает, либо держите конфигурацию в файле уровня пользователя (а не проекта).

Устранение неполадок

• Клиент не видит Engram после правки. Перезапустите клиент полностью, а не только окно.
• Браузер не открывается для авторизации. Проверьте, что окно не блокирует блокировщик всплывающих окон; некоторые клиенты пропускают окно OAuth через собственную логику браузера, и при блокировке это молча не срабатывает.
• Failed to connect. Проверьте, что URL доступен. Об общих для всех клиентов проблемах см. Устранение неполадок.

О сценариях с графическим интерфейсом для конкретных клиентов см. ИИ-интеграции.