Memory Core — Getting Started

Получите API ключ

Один запрос — и вы готовы.

# Регистрация curl -X POST https://api.memorycore.ru/api/v1/public/register -H "Content-Type: application/json" -d '{"name":"My Bot","email":"me@mail.ru"}'

В ответе получите api_key — сохраните его.

Самый быстрый путь — подключить по MCP

Если у вас Claude Desktop, Cursor, Cline или другой MCP-клиент — писать код не нужно. В настройках ассистента укажите один адрес, подставив свой ключ:

# один адрес — и у ассистента появляется постоянная память https://mcp.memorycore.ru/mc_live_ВАШ_КЛЮЧ/mcp

Больше настраивать нечего. Ассистент сразу получает шесть инструментов:

MCPmemory_recall — вспомнить, что известно о собеседнике

MCPmemory_store — запомнить факт, предпочтение, договорённость

MCPmemory_search — точечный поиск по памяти

MCPmemory_profile — портрет собеседника целиком

MCPmemory_stats — сколько всего накоплено

MCPmemory_forget — забыть запись

Память одна на всех или у каждого своя?

Пользуетесь ассистентом сами — добавлять ничего не нужно. Все записи лягут в одну память под именем me.

Людей или ботов несколько — допишите к адресу имя, своё для каждого. Памяти не перемешаются: под именем ivan ассистент не увидит то, что записано под maria.

# у Ивана своя память https://mcp.memorycore.ru/mc_live_ВАШ_КЛЮЧ/mcp?user=ivan # у Марии своя, они не пересекаются https://mcp.memorycore.ru/mc_live_ВАШ_КЛЮЧ/mcp?user=maria

Ключ во всех адресах один и тот же — ваш. Имя лишь раскладывает записи по полкам внутри вашего аккаунта, менять его можно когда угодно. Чужие клиенты вашу память не видят в любом случае — это отдельный уровень изоляции, он от имени не зависит. Готовый адрес с уже подставленным ключом и полем для имени — в кабинете.

Сохраните сообщение в память

Запись автоматически сохраняется в 3 слоя.

# curl curl -X POST https://api.memorycore.ru/api/v1/memory/upsert -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" -d '{"bot_id":"my_bot","user_id":"user_1","content":"Привет!"}'

# Python import requests r = requests.post( "https://api.memorycore.ru/api/v1/memory/upsert", headers={"X-API-Key": "YOUR_KEY"}, json={"bot_id": "my_bot", "user_id": "user_1", "content": "Привет!"} )

Получите контекст

Перед ответом бота — запросите контекст. Memory Core вернёт релевантные воспоминания.

curl -X POST https://api.memorycore.ru/api/v1/memory/context -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" -d '{"bot_id":"my_bot","user_id":"user_1","query":"что любит?"}'

Ответ: hot_messages (последние), warm_episodes (по смыслу), cold_graph (факты).

Все API endpoints

POST/memory/upsert — сохранить

POST/memory/context — получить контекст

POST/memory/search — семантический поиск

POST/memory/import — bulk импорт (до 100)

POST/memory/export — экспорт данных

DEL/memory/delete — удаление (ФЗ-152)

DEL/memory/forget/{id} — забыть один эпизод

GET/memory/trash — корзина удалённого

POST/memory/restore — восстановить из корзины

DEL/memory/purge — окончательная зачистка (admin)

GET/memory/browse — просмотр записей

PATCH/memory/edit/{id} — редактировать запись

GET/memory/stats — статистика памяти

POST/wiki/compile — собрать wiki-страницы

GET/wiki/pages — список wiki-страниц

RBACviewer / contributor / admin — роли доступа на каждом эндпойнте

GET/me — информация о тенанте

GET/payment/plans — тарифы

POST/payment/subscribe — оформить подписку

POST/account/regenerate-key — новый ключ