Май 2026 · чтение 7 мин · Fran Olivares, основатель OlivaresAI
@olivaresai/alma-mcp как сервер, вставьте один блок JSON в конфигурацию Вашего MCP-клиента (Claude Desktop, Cursor, Windsurf, Claude Code или любой другой совместимый клиент) с Вашим API-ключом Alma и перезапустите. Сервер открывает 35 инструментов памяти, которые AI может вызывать автономно: сохранить memory, поиск по memories, собрать контекст, извлечь факты, настроить Soul-блоки. Общее время настройки — около пяти минут, и работает на бесплатном уровне Alma.Model Context Protocol (MCP) — это открытый стандарт, который позволяет AI-клиентам общаться с внешними инструментами и источниками данных. Как только Ваш клиент говорит по MCP, Вы можете подключить сервер памяти, и AI немедленно получает инструменты для чтения и записи в хранилище устойчивой памяти — во всех разговорах, во всех проектах, каждый день. Это руководство проводит через пятиминутную настройку для четырёх самых распространённых клиентов в 2026 и отвечает на вопросы, которые возникают потом.
Когда MCP-сервер Alma подключён, Ваш AI-клиент получает 35 новых инструментов, которые он может вызывать без того, чтобы Вы что-то печатали. Самые важные: alma_remember (сохранить факт или предпочтение), alma_recall (поиск memories по запросу на естественном языке), alma_assemble_context (построить структурированный контекст для текущего вопроса из всех уровней памяти), alma_extract (добыть факты из блока текста), alma_update_block (настроить блоки Soul Engine для идентичности AI), плюс инструменты для episodes, procedures, environments, conversations, веб-поиска, генерации файлов и больше.
На практике AI вызывает эти инструменты, когда пользователь спрашивает что-то релевантное памяти. «Запомни, что я предпочитаю ESM-модули» → AI вызывает alma_remember. «Какой стек мы согласовали для нового сервиса?» → AI вызывает alma_recall. Round-trip инструмента — субсекунда; пользователь просто видит чуть более вдумчивый ответ.
Шаг 1. Зарегистрируйтесь на alma.olivares.ai. Начните с тарифа Starter ($14/month) для начального уровня.
Шаг 2. В Settings → API Keys сгенерируйте ключ и скопируйте его.
Шаг 3. Откройте конфигурационный файл Claude Desktop. На macOS он лежит в ~/Library/Application Support/Claude/claude_desktop_config.json; на Windows — в %APPDATA%\Claude\claude_desktop_config.json.
Шаг 4. Добавьте сервер Alma внутри объекта mcpServers: { "alma": { "command": "npx", "args": ["-y", "@olivaresai/alma-mcp"], "env": { "ALMA_API_KEY": "your-key" } } }. Если mcpServers ещё не существует, создайте его на верхнем уровне JSON.
Шаг 5. Перезапустите Claude Desktop. Инструменты Alma появляются в slash-меню, и Claude может вызывать их автономно. Попробуйте: «запомни, что мой любимый редактор — Helix». Ход спустя: «какой мой любимый редактор?» — Claude вспоминает.
MCP UI Cursor живёт в Settings → Features → MCP. Добавьте новый сервер с именем alma, command npx, args -y @olivaresai/alma-mcp, и добавьте env-переменную ALMA_API_KEY с Вашим ключом. Сохраните и перезапустите Cursor. Инструменты Alma появляются в индикаторе использования инструмента чата; и Composer, и inline-чат имеют доступ. Вместе с осознанием контекста проекта Cursor это даёт AI и осведомлённость о Вашей кодовой базе, и устойчивую межпроектную память.
Windsurf читает MCP-конфигурации из ~/.windsurf/mcp_config.json. Структура зеркалит Claude Desktop: объект mcpServers с тем же блоком Alma. Перезапустите Windsurf после редактирования. Инструменты Alma затем появляются в Cascade, и Windsurf может использовать их во время agentic-потоков — особенно полезно для multi-file рефакторингов, где Вы хотите, чтобы AI вспомнил соглашения из предыдущих сессий.
Claude Code (терминальный клиент Claude) имеет собственную MCP-конфигурацию в ~/.config/claude-code/mcp.json. Вставьте тот же блок Alma. Запустите claude mcp list, чтобы убедиться, что сервер зарегистрирован. После подключения Claude Code может использовать инструменты Alma во время сессий кода; особенно мощно в сочетании с функцией environments Alma, чтобы у каждого репозитория было своё пространство имён памяти. См. документацию интеграции Claude Code для точного JSON.
MCP-сервер Alma говорит по чистому MCP через stdio, так что любой совместимый клиент работает. Шаблон всегда тот же: клиент ожидает блок конфигурации command + args + env, запускает сервер как дочерний процесс и обнаруживает инструменты через MCP-handshake. Если Вы застряли на не-перечисленном клиенте, логи сервера (установите ALMA_DEBUG=1 в env) подскажут Вам, удался ли handshake.
Фиксация стека. Скажите AI «я использую Bun + Hono + D1 для нового сервиса» — он вызывает alma_remember. Через два дня в другом разговоре: «накидай route handler для /users» — AI вспоминает стек и выдаёт идиоматический код Bun + Hono, без повторного объяснения.
Логирование решений. «Мы решили пропустить Redis для MVP и использовать D1 напрямую». Агент сохраняет решение с категорией decision и высокой важностью. Через недели при ревью архитектуры «почему без Redis?» возвращает оригинальное решение с обоснованием.
Cross-client непрерывность. Сохраните memory в Claude Desktop утром, обращайтесь к нему из Cursor днём, запрашивайте из Claude Code в терминале ночью. Тот же аккаунт Alma, то же хранилище памяти, каждый клиент видит всё.
Да. MCP-сервер Alma также открывает ресурсы (только для чтения, на которые клиент может подписаться): soul, memories, environments, conversations, budget, blocks, episodes, procedures и больше. Клиенты, которые отображают MCP-ресурсы (особенно Claude Desktop), показывают их в боковой панели и могут стримить обновления. Вы можете просматривать всё хранилище памяти изнутри Claude Desktop, не открывая браузер.
MCP-сервер делает только то, что AI ему говорит, и только с Вашим API-ключом — нет неявной трансляции. Все записи памяти ограничены Вашим аккаунтом Alma, зашифрованы в покое и экспортируются по требованию. Сервер работает локально на Вашей машине; он не проксирует через третью сторону, кроме самого API Alma. По стоимости: сервер бесплатен для установки; тариф Starter ($14/month) — начальный уровень Alma и включает всё необходимое для запуска MCP-сервера.
Как только сервер работает, ход с наивысшим рычагом — заполнить блоки Soul Engine (характер, экспертиза, стиль общения, жёсткие правила), чтобы у AI была последовательная идентичность в дополнение к фактической памяти. Веб-приложение Alma на alma.olivares.ai открывает редактор Soul; см. «Soul Engine: личность AI, которая держится» для полного шаблона.
Связанное чтение: MCP-сервер для памяти AI · Как дать AI устойчивую память · Устойчивая память для AI: полное руководство 2026 · Документация MCP-сервера · Интеграция Claude Code.