# Naumu

Подключает к агенту рабочий граф знаний Naumu: заметки, узлы, обсуждения. Пригодится, когда нужно искать по базе команды и дописывать в неё прямо из сессии.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: naumu-ai
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/naumu-ai/mcp
- Обновлён: 2026-08-12
- HTML: https://affpapa.org/nevibecode/mcp/naumu

## Что делает

Сервер отдаёт агенту доступ к пространствам Naumu. Через него можно искать по узлам гибридным поиском, фильтровать их по типу и атрибутам, читать один узел вместе с его связями, заметками и обсуждениями, а также задавать вопросы @Naumu и получать ответ со ссылками на узлы. Запись тоже есть: создание узлов и рёбер пачками, перепривязка родителя, удаление связей одной операцией.

Основной путь подключения — удалённый, по OAuth на `https://naumu.ai/api/mcp`. Браузер открывается при первом вызове инструмента, ключ создавать не нужно. Локальный вариант через `npx` нужен там, где браузерного входа нет: CI, боты, внешние агент-идентичности. Для него понадобится ключ вида `nmu_`, он показывается один раз при создании. Советую заводить отдельный ключ под каждый инструмент — тогда утечка стоит одной строки, а не всего доступа.

Часть инструментов регистрируется только для ключей бот-идентичностей `nmu_bot_*`, и их набор урезан правами этой идентичности. Удаление узла забирает с собой все его связи, так что перед вызовом `naumu_remove_node` стоит убедиться, что узел не нужен. Переменная `NAUMU_API_URL` необязательна, её значение по умолчанию — `https://naumu.ai`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://naumu.ai/api/mcp`
- Переменные окружения: `NAUMU_API_KEY`, `NAUMU_API_URL`, `NAUMU_IDENTITY_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://naumu.ai/api/mcp
```

2. **Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add naumu --url https://naumu.ai/api/mcp
```

2. **Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "naumu": {
            "url": "https://naumu.ai/api/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "naumu": {
            "type": "http",
            "url": "https://naumu.ai/api/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http naumu https://naumu.ai/api/mcp
```

2. **Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- найти нужный узел в графе команды по смыслу, а не по точному слову
- выгрузить узлы одного типа с их атрибутами
- прочитать узел вместе со связями и обсуждениями
- завести пачку узлов и рёбер одной операцией
- перевесить узел на нового родителя без ручной правки связей

## Примеры запросов агенту
- Найди в Naumu всё, что относится к онбордингу новых клиентов
- Покажи схему пространства и перечисли типы узлов
- Создай узел «Разбор инцидента» и свяжи его с узлом «Платежи»

## Похожие
- [Aiqbee Brain](https://affpapa.org/nevibecode/mcp/aiqbee-brain.md) — MCP-сервер · ★ 7
- [cross-linker](https://affpapa.org/nevibecode/skills/cross-linker.md) — скилл · 3300 установок
- [wiki-export](https://affpapa.org/nevibecode/skills/wiki-export.md) — скилл · 3200 установок
- [para-memory-files](https://affpapa.org/nevibecode/skills/para-memory-files.md) — скилл · 1800 установок
- [mempalace-recall](https://affpapa.org/nevibecode/skills/mempalace-recall.md) — скилл · 1400 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md