Перейти к содержимому

Cursor

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

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

  • У вас есть аккаунт Engram на app.engram.page.
  • По крайней мере, одно хранилище синхронизировано. Откройте плагин Obsidian или веб-приложение и убедитесь, что заметки были синхронизированы за последние сутки.
  • Вы можете войти в систему через браузер. Процесс аутентификации MCP открывает окно браузера.
  • Если вы планируете использовать API-ключ вместо OAuth: API-ключи работают на всех планах, включая бесплатный. Аутентификация через OAuth по-прежнему является рекомендуемым способом.
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/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)

Заголовок раздела «Устранение неполадок (специфично для 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.
  3. Отзыв ключа API немедленно прекращает его работу. Отмененное подключение OAuth больше не может обновить доступ, а текущий токен доступа истекает через 15 минут. Чтобы подключиться снова, Cursor потребуется пройти повторную аутентификацию.

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