Netra — MCP-сервер для Claude Code: сети Linux и установка
Netra помогает исследовать сетевые сбои в Linux и Kubernetes: показывает причины сброса соединений и позволяет запускать ограниченные по времени блокировки.
claude mcp add --env NETRA_URL=<NETRA_URL> --env NETRA_API_KEY=<NETRA_API_KEY> --env NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> --env NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> --transport stdio netra -- docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0Что делает Netra
Netra связывает ИИ-агента с наблюдением за сетью на базе eBPF. Сервер предоставляет 190 инструментов: с их помощью агент может разбирать причины сбросов соединений, исследовать сетевой путь и перегрузки, а также работать с захватом пакетов. Сбор содержимого пакетов не ведётся.
Для экстренного контроля Netra поддерживает блокировки с ограниченным сроком действия: по окончании срока они возвращаются в режим наблюдения. Изменяющие действия закрыты за переменной NETRA_MCP_ALLOW_MUTATIONS. Это важно учитывать при настройке: без разрешения переменной агент не сможет выполнять такие действия. Netra работает без смены CNI; интеграции с Cilium и Hubble необязательны.
Для подключения в Claude Code команда запускает Docker-образ MCP-сервера и передаёт адрес Netra, API-ключ и параметры доступа через переменные окружения. Нужны NETRA_URL, NETRA_API_KEY, NETRA_MCP_ALLOW_MUTATIONS и NETRA_MCP_ACTOR.
Какие задачи решает
- найти причину сброса сетевого соединения
- разобрать перегрузку на сетевом пути Linux
- запустить захват пакетов на выбранном узле
- временно ограничить нежелательный сетевой трафик
Примеры запросов агенту
- Разбери причины сбросов соединений в этом кластере.
- Исследуй сетевой путь и найди, где возникает перегрузка.
- Покажи, какие соединения затронет временная блокировка, прежде чем применять её.
Как установить Netra
Командой платформы
claude mcp add --env NETRA_URL=<NETRA_URL> --env NETRA_API_KEY=<NETRA_API_KEY> --env NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> --env NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> --transport stdio netra -- docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0Вместо <…> подставьте свои значения
Командой платформы
codex mcp add netra --env NETRA_URL=<NETRA_URL> --env NETRA_API_KEY=<NETRA_API_KEY> --env NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> --env NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> -- docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"netra": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NETRA_URL",
"-e",
"NETRA_API_KEY",
"-e",
"NETRA_MCP_ALLOW_MUTATIONS",
"-e",
"NETRA_MCP_ACTOR",
"ghcr.io/zyvorai/netra-mcp:0.32.0"
],
"env": {
"NETRA_URL": "<NETRA_URL>",
"NETRA_API_KEY": "<NETRA_API_KEY>",
"NETRA_MCP_ALLOW_MUTATIONS": "<NETRA_MCP_ALLOW_MUTATIONS>",
"NETRA_MCP_ACTOR": "<NETRA_MCP_ACTOR>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"netra": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NETRA_URL",
"-e",
"NETRA_API_KEY",
"-e",
"NETRA_MCP_ALLOW_MUTATIONS",
"-e",
"NETRA_MCP_ACTOR",
"ghcr.io/zyvorai/netra-mcp:0.32.0"
],
"env": {
"NETRA_URL": "<NETRA_URL>",
"NETRA_API_KEY": "<NETRA_API_KEY>",
"NETRA_MCP_ALLOW_MUTATIONS": "<NETRA_MCP_ALLOW_MUTATIONS>",
"NETRA_MCP_ACTOR": "<NETRA_MCP_ACTOR>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NETRA_URL=<NETRA_URL> -e NETRA_API_KEY=<NETRA_API_KEY> -e NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> -e NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> netra docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Netra
Как установить Netra в Claude Code?
Добавьте сервер командой `claude mcp add --env NETRA_URL=<NETRA_URL> --env NETRA_API_KEY=<NETRA_API_KEY> --env NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> --env NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> --transport stdio netra -- docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0`. Укажите значения адреса Netra, API-ключа и остальных переменных окружения.
Что делает Netra?
Netra подключает ИИ-агента к инструментам наблюдения за сетью Linux и Kubernetes. Агент может исследовать причины сбросов, сетевые пути и захват пакетов; отдельные действия позволяют включать ограниченные по времени блокировки.
Нужен ли для Netra Cilium?
Нет. Netra работает без смены CNI, а интеграции с Cilium и Hubble подключаются по желанию.
