Cursor

У Cursor полноценная поддержка MCP. Положите файл mcp.json, перезапустите Cursor, и OAuth пройдёт в браузере, когда агент впервые обратится к Engram. О протоколе см. MCP.

Требования

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

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

Эндпоинт

https://mcp.engram.page

Настройка

1. Измените mcp.json. Создайте или отредактируйте ~/.cursor/mcp.json (глобально для пользователя) или .cursor/mcp.json в корне проекта (на уровне проекта, для сервера с тем же именем переопределяет глобальный):

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

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

3. Проверьте. Откройте Settings → Tools & MCP и убедитесь, что engram есть в списке серверов.

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

Cursor не запрашивает OAuth при подключении. Это происходит при первом вызове инструмента. Откройте новый чат и попросите агента искать в вашем Engram. В браузере откроется вход в Engram и подтверждение подключения. Cursor сохраняет токен и дальше использует его. Выдаётся полная область mcp. Детальные области по отдельным действиям есть в планах.

Чтобы обойтись без OAuth (для headless-сред или общих хранилищ), замените блок на вариант с API-ключом:

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

Получите ключ на странице app.engram.page/settings/api-keys.

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

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

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:

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

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

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

• Две записи engram в Tools & MCP. Сервер определён и в ~/.cursor/mcp.json, и в .cursor/mcp.json. Удалите одну (приоритет у файла проекта).
• Сервер виден в настройках, но агент его не вызывает. Известная проблема с подхватом глобальной конфигурации в некоторых сборках Cursor. Обходной путь: перенесите конфигурацию в .cursor/mcp.json на уровне проекта.
• OAuth не запрашивается. Агент ещё не вызывал инструмент. Заставьте его: попросите агента вызвать инструмент engram search по имени. Если по-прежнему тихо, перезапустите Cursor; устаревшее состояние соединения может блокировать первый вызов.

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

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

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

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

Чтобы удалить на стороне клиента, удалите блок engram из вашего mcp.json и перезапустите Cursor.

Дальше

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

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

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