Nacre — MCP-сервер для Claude Code: что делает и как установить
Nacre — MCP-сервер для Claude Code с индексом знаний и гранулярным контролем доступа. Агент видит только документы, на чтение которых у пользователя есть права.
Apache-2.0 ★ 2 обновлён 2026-10-10
claude mcp add nacre -e NACRE_SERVICE_KEY=<NACRE_SERVICE_KEY> -- npx -y @nacre.work/mcpЧто делает Nacre
Nacre — self-hosted слой контекста с наследуемыми правами. Организация содержит воркспейсы, воркспейс — слои, слой — документы. Права read, write и admin наследуются сверху вниз; write не даёт read автоматически. Фильтрация по правам встроена в граф HNSW: top_k возвращает k разрешённых результатов, а не k минус отсечённые.
Внутри — гибридный поиск (плотные векторы, BM25, реранкинг кросс-энкодером), парсер извлекает текст из PDF, Office, OpenDocument, EPUB и RTF. Эмбеддинги — через любой OpenAI-совместимый эндпоинт, привязанный к слою. Смена модели на существующем слое — это переиндексация с проверкой на recall: если новая модель теряет релевантность на контрольном наборе запросов, миграция останавливается.
Запускается через docker compose --profile minimal up -d. Клиент npx @nacre.work/cli авторизует, создаёт слой, загружает директорию и ищет. На Apple Silicon читай docs/apple-silicon.md перед стартом: образы arm64, но эмбеддер идёт на хосте.
Какие задачи решает
- Дать агенту доступ к корпоративному индексу, не показывая документы, на чтение которых у пользователя нет прав
- Убедиться, что поиск вернул именно k разрешённых результатов, а не отсёк часть после ранжирования
- Найти литеральное совпадение (код ошибки, номер счёта, имя переменной) там, где плотные векторы его упускают
- Переключить слой на другую модель эмбеддингов и остановить миграцию, если recall упал
- Распарсить PDF, DOCX, PPTX, EPUB или RTF и проиндексировать текст
Примеры запросов агенту
- Найди в нашем индексе упоминания
SQLSTATE 23505 - Покажи документы про архитектуру аутентификации, доступные текущему пользователю
- Загрузи файлы из
docs/в слойengineering-kbи проиндексируй
Как установить Nacre
Командой платформы
claude mcp add nacre -e NACRE_SERVICE_KEY=<NACRE_SERVICE_KEY> -- npx -y @nacre.work/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add nacre --env NACRE_SERVICE_KEY=<NACRE_SERVICE_KEY> -- npx -y @nacre.work/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"nacre": {
"command": "npx",
"args": [
"-y",
"@nacre.work/mcp"
],
"env": {
"NACRE_SERVICE_KEY": "<NACRE_SERVICE_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"nacre": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nacre.work/mcp"
],
"env": {
"NACRE_SERVICE_KEY": "<NACRE_SERVICE_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NACRE_SERVICE_KEY=<NACRE_SERVICE_KEY> nacre npx -y @nacre.work/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Nacre
Как установить Nacre в Claude Code?
Выполни claude mcp add nacre -e NACRE_SERVICE_KEY=<NACRE_SERVICE_KEY> -- npx -y @nacre.work/mcp, подставив ключ сервисного аккаунта.
Что делает Nacre?
Nacre — это self-hosted индекс знаний с контролем доступа на уровне слоёв и документов. Агент видит только те результаты поиска, на чтение которых у запросившего пользователя есть права. Фильтрация встроена в обход графа HNSW.
Зачем нужна проверка recall при смене модели?
Перед переключением слоя на новую модель эмбеддингов Nacre прогоняет контрольный набор запросов. Если recall упал, миграция останавливается, и старая модель остаётся в работе. Это защищает от деградации качества поиска.