Травень 2026 · 7 хв читання · Фран Олівареш, засновник OlivaresAI
@olivaresai/alma-mcp як сервер, вставте один блок JSON у конфігурацію Вашого MCP-клієнта (Claude Desktop, Cursor, Windsurf, Claude Code або будь-який інший сумісний клієнт) з Вашим ключем API Alma і перезапустіть. Сервер виставляє 35 інструментів памʼяті, які ШІ може викликати автономно: зберегти спогад, шукати memories, зібрати контекст, витягнути факти, налаштувати блоки Soul. Загальний час налаштування — близько пʼяти хвилин і працює на безкоштовному рівні Alma.Model Context Protocol (MCP) — це відкритий стандарт, що дозволяє клієнтам ШІ говорити із зовнішніми інструментами і джерелами даних. Щойно Ваш клієнт говорить MCP, Ви можете підключити сервер памʼяті — і ШІ негайно отримує інструменти для читання і запису у постійне сховище памʼяті — у кожній розмові, кожному проєкті, кожен день. Цей посібник проходить через 5-хвилинне налаштування для чотирьох найпоширеніших клієнтів 2026 року і відповідає на запитання, що виникають після.
Коли MCP-сервер Alma підключений, Ваш клієнт ШІ отримує 35 нових інструментів, які він може викликати без того, щоб Ви щось набирали. Найважливіші: alma_remember (зберегти факт або вподобання), alma_recall (шукати memories за запитом природною мовою), alma_assemble_context (побудувати структурований контекст для поточного запитання з усіх шарів памʼяті), alma_extract (видобути факти з блоку тексту), alma_update_block (налаштувати блоки Soul Engine для ідентичності ШІ), плюс інструменти для episodes, procedures, environments, conversations, вебпошуку, генерації файлів і більше.
На практиці ШІ викликає ці інструменти, коли користувач питає щось релевантне для памʼяті. «Запамʼятай, що я віддаю перевагу модулям ESM» → ШІ викликає alma_remember. «На якому стеку ми зупинилися для нового сервісу?» → ШІ викликає alma_recall. Раундтріп інструмента — субсекундний; користувач просто бачить трохи більш вдумливу відповідь.
Крок 1. Зареєструйтесь на alma.olivares.ai. Починайте з тарифу Starter ($14/місяць).
Крок 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 згадує.
UI MCP в Cursor живе у Settings → Features → MCP. Додайте новий сервер з імʼям alma, командою npx, args -y @olivaresai/alma-mcp, і додайте змінну env ALMA_API_KEY з Вашим ключем. Збережіть і перезапустіть Cursor. Інструменти Alma зʼявляються в індикаторі tool-use чату; Composer і inline-чат — обидва мають доступ. Поєднано з контекстом проєкту Cursor це дає ШІ обізнаність з Вашою кодовою базою і постійну памʼять між проєктами.
Windsurf читає конфіги MCP з ~/.windsurf/mcp_config.json. Структура віддзеркалює Claude Desktop: обʼєкт mcpServers з тим самим блоком Alma. Перезапустіть Windsurf після редагування. Інструменти Alma тоді зʼявляються у Cascade, і Windsurf може використовувати їх під час агентних потоків — особливо корисно для багатофайлових рефакторингів, де Ви хочете, щоб ШІ згадував конвенції з попередніх сесій.
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. Якщо Ви застрягли на клієнті, якого немає у списку, логи сервера (встановіть ALMA_DEBUG=1 в env) скажуть Вам, чи рукостискання було успішним.
Захоплення стека. Скажіть ШІ «я використовую Bun + Hono + D1 для нового сервісу» — він викликає alma_remember. Через два дні в іншій розмові: «створи обробник маршруту для /users» — ШІ згадує стек і виробляє ідіоматичний код Bun + Hono, без повторного пояснення.
Логування рішень. «Ми вирішили пропустити Redis для MVP і використати D1 напряму.» Агент зберігає рішення з категорією decision і високою важливістю. Через тижні, переглядаючи архітектуру, «чому без Redis?» повертає оригінальне рішення з обґрунтуванням.
Між-клієнтська безперервність. Збережіть спогад у Claude Desktop вранці, посилайтеся на нього з Cursor вдень, запитуйте з Claude Code в терміналі вночі. Той самий обліковий запис Alma, те саме сховище памʼяті, кожен клієнт бачить усе.
Так. MCP-сервер Alma також виставляє ресурси (read-only-дані, на які клієнт може підписатися): soul, memories, environments, conversations, budget, blocks, episodes, procedures та більше. Клієнти, що показують ресурси MCP (зокрема Claude Desktop), показують їх у сайдбарі і можуть стрімити оновлення. Ви можете переглядати все сховище памʼяті з Claude Desktop без відкриття браузера.
MCP-сервер робить лише те, що каже йому ШІ, і лише з Вашим ключем API — немає неявної трансляції. Усі записи памʼяті обмежені Вашим обліковим записом Alma, зашифровані у стані спокою і експортовні на вимогу. Сервер працює локально на Вашій машині; він не проксує через жодну третю сторону, окрім самого API Alma. Щодо вартості: сервер безкоштовний для встановлення; тариф Starter ($14/місяць) — початковий тариф Alma і включає все, потрібне для запуску MCP-сервера.
Щойно сервер працює, найбільш-важільний крок — це заповнити блоки Soul Engine (особистість, експертиза, стиль комунікації, жорсткі правила), щоб ШІ мав послідовну ідентичність на додачу до фактичної памʼяті. Вебзастосунок Alma на alma.olivares.ai виставляє редактор Soul; дивіться Soul Engine: особистість ШІ, що залишається для повного патерну.
Повʼязане читання: MCP-сервер для памʼяті ШІ · Як надати ШІ постійну памʼять · Постійна памʼять для ШІ: повний посібник 2026 · Документація MCP-сервера · Інтеграція Claude Code.