Квітень 2026 · 10 хв читання · Фран Олівареш, засновник OlivaresAI
@olivaresai/alma-mcp у конфігурацію клієнта за пʼять хвилин — без коду; використовуйте JavaScript SDK, щоб отримувати контекст перед викликами LLM і витягувати memories після; або викликайте REST API напряму з будь-якої мови. Усі три підключаються до того самого шару памʼяті Alma.Кожна розмова зі ШІ починається з нуля. Ваш асистент забуває Ваше імʼя, Ваш проєкт, Ваші вподобання — щоразу. Це фундаментальне обмеження стейтлес-ШІ, і це єдина найбільша причина, чому ШІ відчувається як інструмент, а не як колега. Цей посібник проводить Вас через три конкретні підходи до розвʼязання цього — від налаштування без коду до повної інтеграції API.
Коли Ви користуєтесь ChatGPT, Claude або будь-яким чатом ШІ, контекст зникає, коли розмова закінчується. Ви знову і знову пояснюєте ті самі речі: Ваш техстек, Ваш стиль кодування, архітектуру проєкту, Ваші вподобання. Це марнує час і дає гірші результати, бо ШІ ніколи не будує глибоке розуміння того, хто Ви або над чим Ви працюєте.
Рідні функції памʼяті платформи (ChatGPT Memory, Claude Projects) допомагають, але вони обмежені у ємності, замкнені на одну платформу і не пропонують API для розробників. Якщо Ви будуєте продукт на основі ШІ, Вам потрібен незалежний шар памʼяті.
Model Context Protocol (MCP) — найшвидший шлях. Якщо Ваш ШІ працює у Claude Desktop, Cursor, Windsurf, Claude Code або будь-якому MCP-сумісному клієнті, Ви можете додати постійну памʼять менш ніж за 5 хвилин.
Крок 1: Зареєструйтесь на alma.olivares.ai і згенеруйте ключ API у Settings.
Крок 2: Додайте @olivaresai/alma-mcp до конфігурації MCP-клієнта з Вашим ключем API. Для Claude Desktop відредагуйте claude_desktop_config.json. Для Cursor скористайтеся панеллю налаштувань MCP.
Крок 3: Перезапустіть клієнта. Сервер виставляє 35 інструментів: alma_remember (зберегти спогад), alma_recall (шукати memories), alma_assemble (зібрати контекст з усіх шарів памʼяті), alma_extract (витягнути факти з тексту) і більше. Ваш ШІ тепер може читати і записувати у постійне сховище памʼяті, що виживає у кожній розмові.
MCP ідеальний для особистих робочих процесів — Claude Desktop для загальної роботи зі ШІ, Cursor для кодування, Claude Code для розробки у терміналі. Одна памʼять, скрізь.
JavaScript SDK (@olivaresai/alma-sdk) дає Вам повний програмний контроль для користувацьких застосунків. Основний патерн інтеграції має три кроки:
client.context.assemble({ query }), щоб отримати системний промпт, збагачений релевантними memories, episodes, procedures і блоками soul.client.memories.extract({ text }), щоб зберегти нові факти з розмови. Або створіть memories напряму з client.memories.create().SDK обгортає всі 140+ ендпоінтів API з повноцінними типами TypeScript. Встановіть з npm install @olivaresai/alma-sdk. ESM-only, потребує Node.js 18+.
REST API надає прямий доступ HTTP з будь-якої мови чи платформи. Ключові ендпоінти:
POST /api/v1/context/assemble — Побудувати контекстний промпт з memories, episodes, procedures і блоків soulPOST /api/v1/memories — Створити спогад з контентом, категорією, важливістю і впевненістюGET /api/v1/memories/search?q=query&mode=hybrid — Гібридний семантичний + ключове слово пошукPOST /api/v1/memories/extract — Екстракція фактів з тексту через LLMPOST /api/v1/blocks — Налаштування блоків Soul Engine для ідентичності ШІАвтентифікація через ключ API (заголовок X-API-Key). Базовий URL: https://alma.olivares.ai/api/v1.
Тришарова архітектура Alma розділяє знання на три типи:
Коли Ви починаєте розмову, збирання контексту шукає в усіх трьох шарах за допомогою гібридного пошуку, оцінює результати за релевантністю (50%), важливістю (15%), впевненістю (15%), свіжістю (10%) і частотою (10%), а потім впорскує контекст з найвищим рангом у системний промпт — усе менш ніж за 100 мс.
Memories автоматично витягуються з розмов кожні 4 повідомлення. Екстрактор ідентифікує 0-30 фактів на розмову, використовуючи Claude Haiku. Дублікати виявляються через подібність Жакара (поріг 60%) і обʼєднуються. Застарілі memories з низькою важливістю застарівають після 120 днів неактивності.
Сама памʼять дає Вашому ШІ факти. Soul Engine дає йому ідентичність. Налаштуйте структуровані блоки — особистість, експертиза, стиль комунікації, правила і контекст, — що зберігаються у кожній розмові. На відміну від одного системного промпта, що розчиняється у довгих розмовах, блоки Soul Engine версіонуються, організовані і завжди впорскуються з пріоритетом.
Environments дозволяють Вам ізолювати контексти памʼяті. Тримайте робочі, особисті і клієнт-специфічні memories повністю окремо. Кожен environment має власні memories, episodes, procedures і блоки soul. ШІ перемикає особистість і знання, коли Ви перемикаєте environments.
Почніть на alma.olivares.ai. Тариф Starter ($14/місяць) включає необмежену памʼять у межах тижневого бюджету ШІ $2, 1 environment і повний доступ до чату. Усі методи інтеграції — MCP, SDK, API — працюють на кожному тарифі.
Для більшої глибини: Управління памʼяттю ШІ: повний посібник 2026 · Побудова асистентів ШІ, які памʼятають усе · Постійна памʼять проти RAG