Netdata — MCP-сервер для Claude Code: метрики и алерты
Отдаёт ИИ-агенту данные мониторинга: метрики, логи, алерты и поиск аномалий. Пригодится, когда нужно разобраться, что происходит на сервере, не открывая дашборд.
claude mcp add --transport http mcp https://app.netdata.cloud/api/v1/mcpЧто делает Netdata
Каждый Netdata Agent и Parent версии 2.6.0+ сам является MCP-сервером и слушает тот же порт, что и дашборд, по умолчанию 19999. Через него агент видит железо и ОС узла, ищет метрики по контекстам, инстансам, измерениям и меткам, читает активные алерты и историю их переходов. Запросы метрик поддерживают агрегации и группировки, скоринг ищет первопричину через корреляции и обнаружение аномалий.
Транспортов три: WebSocket на ws://YOUR_IP:19999/mcp, HTTP Streamable на http://YOUR_IP:19999/mcp и SSE на http://YOUR_IP:19999/sse. HTTP и SSE появились в версии 2.7.2, и клиенты, которые их понимают, подключаются напрямую. Клиентам только со stdio нужен мост: nd-mcp для WebSocket или mcp-remote для HTTP и SSE. Для mcp-remote по не-HTTPS обязателен флаг --allow-http, и трафик при этом не шифруется — это стоит держать в голове на недоверенной сети.
Часть данных закрыта: чувствительные функции вроде systemd-journal, windows-events и processes открываются временным MCP API-ключом, который генерируется на каждом инстансе Netdata и передаётся заголовком Authorization: Bearer. Что видно агенту, зависит от точки подключения: Parent показывает дочерние узлы, отдельный узел — только себя. Выполнение функций и чтение логов с других узлов требуют Netdata Parent.
Какие задачи решает
- посмотреть, что происходило на сервере в момент падения
- найти узел с аномальным потреблением памяти
- разобрать историю переходов алерта
- вытащить метрики по контексту и меткам без ручных графиков
- прочитать системный журнал узла прямо из чата с агентом
Примеры запросов агенту
- Покажи активные алерты на всех узлах и скажи, какие горят дольше всего
- Найди аномалии в потреблении CPU за последний час и назови вероятную причину
- Прочитай
systemd-journalна узле web-01 и найди ошибки за ночь
Как установить Netdata
Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://app.netdata.cloud/api/v1/mcpКомандой платформы: удалённый сервер
codex mcp add mcp --url https://app.netdata.cloud/api/v1/mcpФайл настроек
{
"mcpServers": {
"mcp": {
"url": "https://app.netdata.cloud/api/v1/mcp"
}
}
}Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://app.netdata.cloud/api/v1/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://app.netdata.cloud/api/v1/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Netdata
Как установить Netdata MCP в Claude Code?
Одной командой: claude mcp add --transport http mcp https://app.netdata.cloud/api/v1/mcp.
Что даёт Netdata MCP-сервер?
Доступ к данным мониторинга: обнаружение узлов и метрик, запросы с агрегациями, алерты и их история, скоринг первопричины через обнаружение аномалий. С Netdata Parent добавляются выполнение функций и чтение логов с подключённых узлов.
Нужен ли мост nd-mcp?
Только клиентам, которые умеют исключительно stdio. Если клиент поддерживает HTTP или SSE, он подключается к Netdata напрямую.
