Naumu — MCP-сервер для Claude Code: граф знаний команды
Подключает к агенту рабочий граф знаний Naumu: заметки, узлы, обсуждения. Пригодится, когда нужно искать по базе команды и дописывать в неё прямо из сессии.
claude mcp add --transport http mcp https://naumu.ai/api/mcpЧто делает Naumu
Сервер отдаёт агенту доступ к пространствам Naumu. Через него можно искать по узлам гибридным поиском, фильтровать их по типу и атрибутам, читать один узел вместе с его связями, заметками и обсуждениями, а также задавать вопросы @Naumu и получать ответ со ссылками на узлы. Запись тоже есть: создание узлов и рёбер пачками, перепривязка родителя, удаление связей одной операцией.
Основной путь подключения — удалённый, по OAuth на https://naumu.ai/api/mcp. Браузер открывается при первом вызове инструмента, ключ создавать не нужно. Локальный вариант через npx нужен там, где браузерного входа нет: CI, боты, внешние агент-идентичности. Для него понадобится ключ вида nmu_, он показывается один раз при создании. Советую заводить отдельный ключ под каждый инструмент — тогда утечка стоит одной строки, а не всего доступа.
Часть инструментов регистрируется только для ключей бот-идентичностей nmu_bot_*, и их набор урезан правами этой идентичности. Удаление узла забирает с собой все его связи, так что перед вызовом naumu_remove_node стоит убедиться, что узел не нужен. Переменная NAUMU_API_URL необязательна, её значение по умолчанию — https://naumu.ai.
Какие задачи решает
- найти нужный узел в графе команды по смыслу, а не по точному слову
- выгрузить узлы одного типа с их атрибутами
- прочитать узел вместе со связями и обсуждениями
- завести пачку узлов и рёбер одной операцией
- перевесить узел на нового родителя без ручной правки связей
Примеры запросов агенту
- Найди в Naumu всё, что относится к онбордингу новых клиентов
- Покажи схему пространства и перечисли типы узлов
- Создай узел «Разбор инцидента» и свяжи его с узлом «Платежи»
Как установить Naumu
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://naumu.ai/api/mcp2Командой платформы
claude mcp add --env NAUMU_API_KEY=<NAUMU_API_KEY> --env NAUMU_API_URL=<NAUMU_API_URL> --env NAUMU_IDENTITY_ID=<NAUMU_IDENTITY_ID> --transport stdio naumu -- npx -y @naumu/mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add naumu --url https://naumu.ai/api/mcp2Командой платформы
codex mcp add naumu --env NAUMU_API_KEY=<NAUMU_API_KEY> --env NAUMU_API_URL=<NAUMU_API_URL> --env NAUMU_IDENTITY_ID=<NAUMU_IDENTITY_ID> -- npx -y @naumu/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"naumu": {
"url": "https://naumu.ai/api/mcp"
}
}
}{
"mcpServers": {
"naumu": {
"command": "npx",
"args": [
"-y",
"@naumu/mcp"
],
"env": {
"NAUMU_API_KEY": "<NAUMU_API_KEY>",
"NAUMU_API_URL": "<NAUMU_API_URL>",
"NAUMU_IDENTITY_ID": "<NAUMU_IDENTITY_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"naumu": {
"type": "http",
"url": "https://naumu.ai/api/mcp"
}
}
}{
"servers": {
"naumu": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@naumu/mcp"
],
"env": {
"NAUMU_API_KEY": "<NAUMU_API_KEY>",
"NAUMU_API_URL": "<NAUMU_API_URL>",
"NAUMU_IDENTITY_ID": "<NAUMU_IDENTITY_ID>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http naumu https://naumu.ai/api/mcp2Командой платформы
gemini mcp add -e NAUMU_API_KEY=<NAUMU_API_KEY> -e NAUMU_API_URL=<NAUMU_API_URL> -e NAUMU_IDENTITY_ID=<NAUMU_IDENTITY_ID> naumu npx -y @naumu/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Naumu
Как установить Naumu в Claude Code?
Для удалённого подключения по OAuth выполните claude mcp add --transport http naumu https://naumu.ai/api/mcp. При первом вызове инструмента откроется браузер для входа.
Что делает Naumu?
Даёт агенту доступ к графу знаний Naumu: поиск и фильтрация узлов, чтение связей и обсуждений, запись узлов и рёбер, вопросы к @Naumu с опорой на узлы.
Когда нужен локальный запуск с ключом API?
Если клиент не умеет браузерный OAuth: задачи CI, боты, внешние агент-идентичности. Сервер запускается через npx и требует ключ nmu_ в переменной NAUMU_API_KEY.
