Knowl — MCP-сервер для Claude Code: память агента с устареванием
Локальная память для ИИ-агентов: когда факт меняется, старый уходит в архив и не спорит с новым. Пригодится, если CLAUDE.md разросся и врёт.
claude mcp add --transport http knowl https://api.knowl.cloud/mcp/Что делает Knowl
Knowl хранит факты о проекте и отдаёт их агенту через MCP или CLI. Работает с кодом, исследованиями и бытовыми заметками. Ключ API не нужен, данные лежат локально.
Главная механика — вытеснение. Записали, что проект переехал на Postgres, — прежняя запись про MySQL перестаёт быть активной, и агент не выдаёт оба ответа сразу. Если Knowl не уверен, что новый факт заменяет старый, он оставляет обе записи и подсказывает команду knowl supersede. По замерам автора, без этого механизма качество поиска падает с 98% до 47%.
Ставится через npm install -g @dat999zx/knowl, дальше knowl init в каталоге проекта: создаётся .knowl/, дописывается .gitignore, регистрируются найденные агенты. Нужен Node.js 22 или новее. Внутри — нативные модули, поэтому запускать CLI напрямую под Bun или Deno не выйдет: Bun годится только для установки пакета.
Какие задачи решает
- убрать из памяти агента факты, которые уже неверны
- дать нескольким агентам один общий источник знаний о проекте
- не тащить в контекст весь разросшийся
CLAUDE.md - сохранить решения по архитектуре между сессиями
- вести заметки по исследованиям рядом с кодом
Примеры запросов агенту
- Какую базу данных использует этот проект? Посмотри в памяти Knowl.
- Запомни: мы перешли на Postgres, решение по MySQL больше не действует.
- Проверь через Knowl, что мы уже решили про авторизацию.
Как установить Knowl
1Командой платформы: удалённый сервер
claude mcp add --transport http knowl https://api.knowl.cloud/mcp/2Командой платформы
claude mcp add knowl -- npx -y @dat999zx/knowl1Командой платформы: удалённый сервер
codex mcp add knowl --url https://api.knowl.cloud/mcp/2Командой платформы
codex mcp add knowl -- npx -y @dat999zx/knowlФайл настроек
{
"mcpServers": {
"knowl": {
"url": "https://api.knowl.cloud/mcp/"
}
}
}{
"mcpServers": {
"knowl": {
"command": "npx",
"args": [
"-y",
"@dat999zx/knowl"
]
}
}
}Файл настроек
{
"servers": {
"knowl": {
"type": "http",
"url": "https://api.knowl.cloud/mcp/"
}
}
}{
"servers": {
"knowl": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dat999zx/knowl"
]
}
}
}1Командой платформы: удалённый сервер
gemini mcp add -t http knowl https://api.knowl.cloud/mcp/2Командой платформы
gemini mcp add knowl npx -y @dat999zx/knowlПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Knowl
Как установить Knowl в Claude Code?
Два способа. Через хост: claude mcp add --transport http knowl https://api.knowl.cloud/mcp/. Локально: claude mcp add knowl -- npx -y @dat999zx/knowl.
Что делает Knowl?
Держит долговременную память агента и следит за актуальностью записей: заменённый факт помечается неактивным, а не копится рядом с новым.
Что нужно для работы Knowl?
Node.js 22 или новее. Ключ API не требуется, хранилище локальное. Запуск CLI под Bun или Deno не поддерживается.
