О MCP

MCP (Model Context Protocol) — новый открытый стандарт, который приняли крупные ИИ-компании (Anthropic, OpenAI и другие), чтобы инструменты вроде Engram подключались прямо к ИИ-ассистентам. Это универсальный разъём: один стандарт, и Claude, Cursor, ChatGPT или любой другой ИИ-инструмент с поддержкой MCP получает доступ к вашим заметкам. Он может искать в них, читать их и сохранять новые, причём с разрешениями, которыми управляете вы.

Чтобы пользоваться Engram, понимать MCP не нужно. Выберите свой ИИ-инструмент в разделе ИИ-интеграции, сделайте несколько кликов, и всё готово. Эта страница нужна, если вам интересна подоплёка.

Что такое MCP

До MCP, чтобы передать заметки ИИ-ассистенту, их приходилось копировать и вставлять, экспортировать или писать отдельную интеграцию для каждого приложения. MCP стандартизирует подключение:

• Engram предоставляет одну точку доступа MCP (один URL, один протокол).
• Ваш ИИ-клиент говорит на MCP (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed и другие).
• Рукопожатие выполняется через OAuth. Вы сами решаете, что и через какой клиент доступно.
• Инструменты, промпты и ресурсы обнаруживаются автоматически. Клиент спрашивает Engram, что доступно, и Engram отвечает. Ничего не зашито заранее под конкретную интеграцию.

Короткая метафора: MCP — это USB-C для ИИ. Один формат кабеля, много разных устройств на обоих концах.

Что можно делать после подключения

• Попросите ИИ найти заметки по теме. Он выполнит семантический поиск по вашему хранилищу и вернёт самые подходящие
• Попросите кратко изложить папку или связать между собой родственные заметки
• Поручите ему набросать новую заметку и сохранить её прямо в хранилище (с вашего одобрения)
• Используйте поиск Engram в своей работе с ИИ без экспорта, копирования и дублирования заметок куда-либо

Можно спросить Claude «что я писал про X в прошлом месяце?», и он действительно найдёт ответ, вызвав инструмент поиска Engram.

Протокол вкратце

Для тех, кто хочет подробностей, вот техническая сторона. Её можно пропустить и всё равно прекрасно пользоваться Engram.

Engram работает с MCP по HTTPS. А именно:

• Авторизация: OAuth 2.1 с Dynamic Client Registration (DCR), поэтому клиентам не нужны заранее выданные учётные данные.
• Обнаружение: GET /.well-known/oauth-authorization-server и tools/list, чтобы клиенты узнавали, что доступно.
• Инструменты: search, get_note, write_note, list_folders и другие.
• Ресурсы: заметки, адресуемые как URI.
• Области доступа: детальные разрешения, которые вы выдаёте на сессию (см. Области доступа).

Страницы раздела

• MCP Config: JSON-фрагмент и таблица путей для тех, кто подключается через файлы конфигурации, а не через графический интерфейс
• Области доступа: что даёт каждое разрешение
• Устранение неполадок: если коннектор не может связаться с Engram

Инструкции по отдельным клиентам (Claude, Cursor, ChatGPT и другие) см. в разделе ИИ-интеграции.

Интерактивный каталог инструментов (все инструменты Engram с входными схемами и примерами) появится позже и будет генерироваться прямо из кода бэкенда, чтобы не расходиться с ним.