Zabbix MCP: три сервера для мониторинга из Claude Code, Codex и Cursor

mpeirone/zabbix-mcp-server· Проверено 12.11.2026· 263на GitHub

Подключает агента к Zabbix API: посмотреть текущие проблемы и недоступные хосты, поднять историю метрик, подтвердить событие, поставить хост на обслуживание или выгрузить шаблон.

3 реализации:

Весь Zabbix API через 3 инструмента: вызвать любой метод, прочитать его справку и список методов; мало места в контексте, запуск одной командой uvx.

Как подключить

Что сделать до подключения

uv и Python 3.10 или новее

Zabbix 6.0 или новее с включённым API

ZABBIX_TOKEN

Zabbix → Users → API tokens → Create API token; токен показывается один раз. Вместо него можно задать ZABBIX_USER и ZABBIX_PASSWORD

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'ZABBIX_URL=<адрес вашего Zabbix>' --env 'ZABBIX_TOKEN=<API-токен Zabbix>' --env READ_ONLY=true --transport stdio zabbix \
  -- uvx --from git+https://github.com/mpeirone/zabbix-mcp-server@main zabbix-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.zabbix]
command = "uvx"
args = ["--from", "git+https://github.com/mpeirone/zabbix-mcp-server@main", "zabbix-mcp"]

[mcp_servers.zabbix.env]
ZABBIX_URL = "<адрес вашего Zabbix>"
ZABBIX_TOKEN = "<API-токен Zabbix>"
READ_ONLY = "true"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "zabbix": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "env": {
        "ZABBIX_URL": "<адрес вашего Zabbix>",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY": "true"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "zabbix": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "env": {
        "ZABBIX_URL": "<адрес вашего Zabbix>",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY": "true"
      }
    }
  }
}

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

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "zabbix": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "env": {
        "ZABBIX_URL": "<адрес вашего Zabbix>",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY": "true"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "zabbix": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "env": {
        "ZABBIX_URL": "<адрес вашего Zabbix>",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY": "true"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "zabbix": {
        "type": "local",
        "command": [
          "uvx",
          "--from",
          "git+https://github.com/mpeirone/zabbix-mcp-server@main",
          "zabbix-mcp"
        ],
        "environment": {
          "ZABBIX_URL": "<адрес вашего Zabbix>",
          "ZABBIX_TOKEN": "<API-токен Zabbix>",
          "READ_ONLY": "true"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "zabbix": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "env": {
        "ZABBIX_URL": "<адрес вашего Zabbix>",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY": "true"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "zabbix": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "env": {
        "ZABBIX_URL": "<адрес вашего Zabbix>",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY": "true"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

zabbix_apiвызывает любой метод Zabbix API

zabbix_api_docsпоказывает справку по методу

zabbix_api_listперечисляет объекты и методы API

Отдельный HTTP-сервис для команды: 241 инструмент по всем группам API и 14 своих (сводки, графики, прогноз, PDF-отчёты), веб-админка, несколько Zabbix сразу, токены и OAuth 2.1.

Как подключить

Что сделать до подключения

Linux-сервер с Python 3.10 или новее и доступом к Zabbix; для разработки есть установка без root на Linux и macOS

git clone https://github.com/initMAX/zabbix-mcp-server.git, затем sudo ./deploy/install.sh

Указать url и api_token в /etc/zabbix-mcp/config.toml и запустить sudo systemctl start zabbix-mcp-server

api_token

Zabbix → Users → API tokens → Create API token; токен наследует права пользователя Zabbix

MCP-токен

по желанию: sudo ./deploy/install.sh generate-token <имя> или админка → MCP Tokens; клиент передаёт его в заголовке Authorization: Bearer

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http zabbix-mcp-server http://127.0.0.1:8080/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.zabbix-mcp-server]
url = "http://127.0.0.1:8080/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "zabbix-mcp-server": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "zabbix-mcp-server": {
      "type": "http",
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "zabbix-mcp-server": {
      "httpUrl": "http://127.0.0.1:8080/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "zabbix-mcp-server": {
      "httpUrl": "http://127.0.0.1:8080/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "zabbix-mcp-server": {
        "type": "remote",
        "url": "http://127.0.0.1:8080/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://127.0.0.1:8080/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "zabbix-mcp-server": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

Инструменты сервера

problem_getпоказывает активные проблемы

problem_active_getсводит проблемы в один ответ

event_getчитает события

event_acknowledgeподтверждает и комментирует событие

host_getищет хосты

host_status_getпоказывает состояние хоста

hostgroup_getчитает группы хостов

item_getчитает элементы данных

history_getподнимает историю метрик

trigger_getчитает триггеры

template_getчитает шаблоны

maintenance_createставит хост на обслуживание

configuration_exportвыгружает шаблоны и хосты

script_executeзапускает глобальный скрипт на хосте

infrastructure_summary_getдаёт сводку по инфраструктуре

graph_renderрисует график в PNG

anomaly_detectищет аномалии в метриках

capacity_forecastпрогнозирует рост нагрузки

report_generateсобирает PDF-отчёт

zabbix_raw_api_callвызывает любой метод API

Показано 20 из 255.

53 отдельных инструмента для Zabbix 6.0–7.4, пакет zabbix-mcp в PyPI; отключение групп инструментов по тегам, поиск инструментов вместо полного списка, лимит запросов.

Как подключить

Что сделать до подключения

Python с 3.11 по 3.15 и uv

Zabbix с 6.0 по 7.4

ZABBIX_TOKEN

API-токен пользователя Zabbix с нужными правами; для старых версий вместо него ZABBIX_USER и ZABBIX_PASSWORD

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'ZABBIX_URL=<адрес Zabbix>/api_jsonrpc.php' --env 'ZABBIX_TOKEN=<API-токен Zabbix>' --env READ_ONLY_MODE=true --transport stdio zabbix-mcp \
  -- uvx zabbix-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.zabbix-mcp]
command = "uvx"
args = ["zabbix-mcp"]

[mcp_servers.zabbix-mcp.env]
ZABBIX_URL = "<адрес Zabbix>/api_jsonrpc.php"
ZABBIX_TOKEN = "<API-токен Zabbix>"
READ_ONLY_MODE = "true"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "zabbix-mcp": {
      "command": "uvx",
      "args": ["zabbix-mcp"],
      "env": {
        "ZABBIX_URL": "<адрес Zabbix>/api_jsonrpc.php",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "zabbix-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["zabbix-mcp"],
      "env": {
        "ZABBIX_URL": "<адрес Zabbix>/api_jsonrpc.php",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "zabbix-mcp": {
      "command": "uvx",
      "args": ["zabbix-mcp"],
      "env": {
        "ZABBIX_URL": "<адрес Zabbix>/api_jsonrpc.php",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "zabbix-mcp": {
      "command": "uvx",
      "args": ["zabbix-mcp"],
      "env": {
        "ZABBIX_URL": "<адрес Zabbix>/api_jsonrpc.php",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "zabbix-mcp": {
        "type": "local",
        "command": ["uvx", "zabbix-mcp"],
        "environment": {
          "ZABBIX_URL": "<адрес Zabbix>/api_jsonrpc.php",
          "ZABBIX_TOKEN": "<API-токен Zabbix>",
          "READ_ONLY_MODE": "true"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "zabbix-mcp": {
      "command": "uvx",
      "args": ["zabbix-mcp"],
      "env": {
        "ZABBIX_URL": "<адрес Zabbix>/api_jsonrpc.php",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "zabbix-mcp": {
      "command": "uvx",
      "args": ["zabbix-mcp"],
      "env": {
        "ZABBIX_URL": "<адрес Zabbix>/api_jsonrpc.php",
        "ZABBIX_TOKEN": "<API-токен Zabbix>",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

Инструменты сервера

api_versionпоказывает версию API

host_getищет хосты

host_createсоздаёт хост

hostgroup_getчитает группы хостов

template_getчитает шаблоны

item_getчитает элементы данных

trigger_getчитает триггеры

problem_getпоказывает текущие проблемы

event_getчитает события

event_acknowledgeподтверждает событие

history_getподнимает историю метрик

trend_getподнимает тренды

maintenance_createсоздаёт период обслуживания

sla_getчитает SLA

script_executeзапускает скрипт на хосте

usermacro_getчитает макросы

configuration_exportвыгружает конфигурацию

configuration_importзагружает конфигурацию

Показано 18 из 53.

Что попросить агента

«Покажи все текущие проблемы»initMAX вызовет problem_get, сервер mpeirone — zabbix_api с методом problem.get

«Какие хосты сейчас недоступны?»Агент вызовет host_get с фильтром по статусу

«Подтверди событие 12345 с комментарием «investigating»»Агент вызовет event_acknowledge

«Покажи историю загрузки CPU для хоста web-01»Агент вызовет host_get, item_get, затем history_get

«Поставь хост db-01 на обслуживание на 2 часа»Агент вызовет maintenance_create; в режиме только чтения запрос будет отклонён

Для каких задач

Показать текущие проблемы и хосты, которые не отвечают

Поднять историю загрузки CPU или другой метрики по хосту

Подтвердить событие с комментарием или закрыть проблему

Поставить хост на обслуживание на заданное время

Выгрузить шаблон или перенести хост с одного Zabbix на другой

Собрать PDF-отчёт и спрогнозировать рост нагрузки

Ограничения

Сервер mpeirone не обновлялся с мая 2026 года; у mhajder всего 10 звёзд

У mpeirone и mhajder запись по умолчанию открыта: READ_ONLY и READ_ONLY_MODE равны false, а агент получает все права пользователя, чей токен вы дали

initMAX ставится отдельным сервисом на Linux; со всеми 255 инструментами один их каталог стоит около 100 тыс. токенов, урезайте его списком tools в config.toml

mhajder работает только с Zabbix 6.0–7.4, на других версиях отказывается подключаться без ZABBIX_SKIP_VERSION_CHECK=true

Если не работает

Сервер не подключается к Zabbix

Проверьте, что адрес из ZABBIX_URL открывается, токен или логин верны и API в Zabbix включён.

Ошибки прав при вызове методов

Проверьте права пользователя Zabbix, чей токен у сервера, и не включён ли READ_ONLY.

Ответ «Method is not in whitelist» или «Method is blacklisted»

Проверьте шаблоны ZABBIX_API_WHITELIST и ZABBIX_API_BLACKLIST: регулярное выражение должно совпадать с полным именем метода, например host.get.

mhajder не подключается к Zabbix версии вне 6.0–7.4

Клиент zabbix-utils принимает только версии с 6.0 по 7.4. Чтобы пропустить проверку, задайте ZABBIX_SKIP_VERSION_CHECK=true.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Zabbix MCP Server (mpeirone)	mpeirone	263	локально	токен	3	10 мая 2026
Zabbix MCP Server (initMAX)	initMAX	249	HTTP	не нужен	255	6 ноября 2026
Zabbix MCP Server (mhajder)	mhajder	10	локально	токен	53	9 ноября 2026

Частые вопросы

Какой из трёх серверов выбрать?

Для себя в Claude Code или Cursor хватит mpeirone: три инструмента и запуск через uvx. Для команды и нескольких Zabbix подойдёт initMAX: один HTTP-сервис с админкой, токенами и правами. mhajder — середина: 53 готовых инструмента и пакет в PyPI.

Как не дать агенту ничего сломать?

Включите режим только чтения: READ_ONLY=true у mpeirone, READ_ONLY_MODE=true у mhajder, read_only = true на сервер или токен у initMAX. Дополнительно выдайте токен пользователя Zabbix с одними правами на чтение. У mpeirone есть ещё ZABBIX_API_WHITELIST и ZABBIX_API_BLACKLIST со списками разрешённых и запрещённых методов.

Чем это отличается от MCP-сервера, который идёт с Zabbix 8.0?

Сервер из пакета Zabbix 8.0 — отдельная программа: 12 инструментов чтения, 7 для проблем и работа с обслуживанием. initMAX закрывает весь API и версии с 5.0 по 8.0. На одном хосте они спорят за имя службы zabbix-mcp-server, а в одном клиенте за имена инструментов вроде host_get.

Какие версии Zabbix поддерживаются?

mpeirone — Zabbix 6.0 и новее, initMAX — с 5.0 по 8.0, mhajder — с 6.0 по 7.4. Для 5.0 и 5.2 у initMAX есть вход по паролю, API-токенов в этих версиях нет.

Можно подключить несколько Zabbix сразу?

Да, у initMAX: опишите каждый в config.toml разделом [zabbix.production], [zabbix.staging] и так далее. Агент сам выберет сервер по словам запроса, например «на staging».

Как подключить Zabbix MCP server к Claude Code?

Для mpeirone: claude mcp add zabbix --env ZABBIX_URL=<адрес> --env ZABBIX_TOKEN=<токен> -- uvx --from git+https://github.com/mpeirone/zabbix-mcp-server@main zabbix-mcp. Для initMAX: claude mcp add --transport http zabbix http://<сервер>:8080/mcp, с MCP-токеном добавьте --header "Authorization: Bearer <токен>".

Как подключить Zabbix MCP server к Codex?

Для initMAX: codex mcp add zabbix --url http://<сервер>:8080/mcp; с токеном сначала export ZABBIX_MCP_TOKEN=<токен> и добавьте --bearer-token-env-var ZABBIX_MCP_TOKEN. Для mpeirone и mhajder откройте вкладку Codex в блоке «Как подключить».

Работает ли сервер из России?

Серверы работают на вашей машине или в вашей сети и обращаются только к вашему Zabbix, зарубежные аккаунты не нужны.

Zabbix MCP: три сервера для мониторинга из Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы