Zabbix je skvělý monitorovací nástroj – ale co kdyby s ním mohl pracovat přímo váš AI asistent? Přesně to umožňuje náš Zabbix MCP Server. Díky otevřenému standardu MCP (Model Context Protocol) můžete propojit Zabbix s libovolným AI asistentem – ať už je to Claude, ChatGPT, GitHub Copilot, Cursor nebo jakýkoli jiný MCP-kompatibilní klient.
Co je MCP a proč na tom záleží
Model Context Protocol (MCP) je otevřený standard, který AI asistentům umožňuje používat externí nástroje. Místo toho, abyste ručně kopírovali data ze Zabbixu a vkládali je do chatu s AI, MCP server zpřístupní celé Zabbix API přímo AI asistentovi. Ten pak může sám dotazovat hosty, kontrolovat problémy, prohlížet triggery, vytvářet grafy nebo generovat reporty.
Jednoduše řečeno: AI asistent se stane plnohodnotným operátorem vašeho Zabbixu.
Co Zabbix MCP Server umí
Server pokrývá kompletní Zabbix API – 231 nástrojů ve všech 58 API skupinách. To znamená, že AI asistent může dělat vše, co byste dělali ručně ve webovém rozhraní Zabbixu:
- Monitoring – dotazování hostů, problémů, triggerů, eventů, historie a trendů
- Konfigurace – správa šablon, hostů, host groups, items, discovery rules
- Vizualizace – export grafů jako PNG, generování PDF reportů
- Analytika – detekce anomálií (z-score analýza), predikce kapacity (lineární regrese)
- Správa – uživatelé, role, skripty, maintenance, SLA, dashboardy
Příklady použití – na co se můžete AI zeptat
Jakmile je Zabbix MCP Server připojený k vašemu AI asistentovi, můžete se jednoduše ptát:
Ukaž mi všechny aktuální problémy se severity High nebo vyššíVygeneruj graf CPU utilizace serveru db-prod-01 za posledních 24 hodinVytvoř PDF report dostupnosti pro skupinu Web Servers za březenKteré triggery se spustily nejvíckrát za posledních 7 dní?Vytvoř hosta switch1 s IP 10.10.1.10, SNMP komunita public - vygeneruj pro něj SNMP šablonuJaká je predikce zaplnění disku na serveru storage-01?AI asistent si sám zavolá příslušné Zabbix API endpointy, zpracuje data a vrátí srozumitelnou odpověď – včetně grafů nebo reportů, pokud o ně požádáte.
Admin portál – webové rozhraní pro správu
Zabbix MCP Server obsahuje plnohodnotný administrační portál běžící na samostatném portu (výchozí 9090). Přes něj můžete spravovat vše potřebné bez editace konfiguračních souborů. Administraci lze také kompletně vypnout a řídit vše pouze přes konfigurační soubor config.toml.
Správa MCP tokenů
Každý AI klient se autentizuje vlastním tokenem. Tokeny můžete omezit na konkrétní:
- Scopes – které nástroje (API skupiny) token smí použít
- Zabbix servery – ke kterým instancím má token přístup
- IP restrikce – z jakých IP adres je přístup povolen
- Read-only režim – ochrana proti nechtěným změnám
- Expirace – automatické vypršení platnosti tokenu
Multi-server podpora
Připojte více Zabbix instancí současně – produkci, staging, testovací prostředí. Každý server má vlastní stav připojení s volitelným ověřením SSL.
PDF reporty a šablony
AI asistent může na požádání generovat PDF reporty přímo z dat Zabbixu. Generování PDF probíhá na straně serveru – samotné LLM totiž PDF vytvořit neumí. Díky tomu se zároveň šetří tokeny, protože server sestaví celý report bez nutnosti přenášet surová data přes AI. K dispozici jsou předdefinované šablony (Availability, Capacity, Backup a další) a můžete také vytvářet vlastní šablony.
Kompletní nastavení
Veškerá konfigurace – TLS, CORS, rate limiting, tool exposure, branding reportů – je dostupná přímo z webového rozhraní. Můžete nahrát vlastní logo, nastavit název firmy a další parametry brandingu. Po změně konfigurace stačí server restartovat jedním tlačítkem přímo z administrace.
K dispozici je také Compact output mode, který šetří tokeny. Namísto vrácení všech desítek polí z Zabbix API vrací server pouze klíčové údaje. AI asistent si může kdykoli vyžádat plný detail pomocí parametru extend. Příklad pro host_get:
hostid, host, name, status
hostid, host, name, status,
description, proxy_hostid,
maintenanceid, maintenance_status,
maintenance_type, maintenance_from,
ipmi_authtype, ipmi_privilege,
ipmi_username, ipmi_password,
tls_connect, tls_accept, tls_issuer,
tls_subject, tls_psk_identity, ...
Rozšířené nástroje (Extension tools)
Kromě kompletního pokrytí standardního Zabbix API server přidává 6 vlastních rozšiřujících nástrojů:
Bezpečnost
Bezpečnost je klíčová, když dáváte AI přístup k monitorovacímu systému. Zabbix MCP Server obsahuje řadu ochranných mechanismů:
- Read-only režim – per-server i per-token ochrana proti zápisům
- Dvoukrokové schvalování – akce
action_prepare+action_confirmpro bezpečné zápisy - Rate limiting – ochrana Zabbixu před zahlcením (výchozí 300 req/min)
- Token scopes – granulární kontrola, které API skupiny jsou přístupné
- IP restrikce – whitelist povolených IP adres
- TLS – podpora HTTPS s vlastními certifikáty (doporučujeme důvěryhodné – někteří AI klienti mají problém se self-signed certifikáty)
- Audit log – kompletní záznam všech akcí
Kompatibilní AI klienti
Zabbix MCP Server funguje s jakýmkoli MCP-kompatibilním klientem. Testováno s:
- Claude (Anthropic) – Claude Desktop, Claude Code
- ChatGPT (OpenAI) – přes MCP plugin
- GitHub Copilot – VS Code extension
- Cursor – AI-first editor
- OpenAI Codex – CLI agent
- n8n – workflow automation
- JetBrains AI – IntelliJ, PyCharm a další
Příklady konfigurace pro nejčastější klienty:
Claude Code (CLI):
# HTTP transport, s tokenem
claude mcp add zabbix -t http -e http://your-server:8080/mcp -h "Authorization: Bearer zmcp_your-token-here"
# HTTP transport, bez tokenu
claude mcp add zabbix -t http -e http://your-server:8080/mcpClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"zabbix": {
"type": "http",
"url": "http://your-server:8080/mcp",
"headers": {
"Authorization": "Bearer zmcp_your-token-here"
}
}
}
}VS Code + GitHub Copilot (.vscode/mcp.json):
{
"servers": {
"zabbix": {
"type": "http",
"url": "http://your-server:8080/mcp",
"headers": {
"Authorization": "Bearer zmcp_your-token-here"
}
}
}
}Podrobné návody pro všechny podporované klienty (včetně Cursor, Codex, n8n, JetBrains a dalších) najdete v dokumentaci na GitHubu:
Rychlý start
Instalace na Linux server
git clone https://github.com/initMAX/zabbix-mcp-server.git
cd zabbix-mcp-server
sudo ./deploy/install.shInstalátor automaticky nainstaluje vše potřebné a na konci vypíše přístupové údaje:
✓ === Installation complete ===
Next steps:
1. Edit config: sudo nano /etc/zabbix-mcp/config.toml
2. Start service: sudo systemctl start zabbix-mcp-server
3. Enable on boot: sudo systemctl enable zabbix-mcp-server
Endpoints (listening on 0.0.0.0:8080):
MCP endpoint: http://192.168.1.50:8080/mcp
Admin portal: http://192.168.1.50:9090
╔══════════════════════════════════════════════════════╗
║ Admin Portal Credentials ║
╠══════════════════════════════════════════════════════╣
║ URL: http://192.168.1.50:9090 ║
║ Username: admin ║
║ Password: Xk9mP2vL4wQn7R8s ║
║ ║
║ Save this password - it will not be shown again ║
╚══════════════════════════════════════════════════════╝Poté stačí spustit službu a přihlásit se do admin portálu, kde přes webové rozhraní přidáte Zabbix server, vytvoříte MCP tokeny a nakonfigurujete vše ostatní – bez nutnosti editovat konfigurační soubory.
sudo systemctl start zabbix-mcp-server
sudo systemctl enable zabbix-mcp-serverAktualizace na novou verzi:
cd zabbix-mcp-server
git pull
sudo ./deploy/install.sh updateInstalace přes Docker
git clone https://github.com/initMAX/zabbix-mcp-server.git
cd zabbix-mcp-server
cp config.example.toml config.toml
nano config.toml # vyplňte URL a API token Zabbixu
docker compose up -dVýchozí konfigurace naslouchá pouze na localhost. Pokud chcete změnit port nebo zpřístupnit server na všech rozhraních, vytvořte soubor .env:
cp .env.example .env
nano .envV .env můžete nastavit:
MCP_HOST=0.0.0.0– naslouchání na všech rozhraních (výchozí: 127.0.0.1)MCP_PORT=8080– port MCP endpointuADMIN_PORT=9090– port admin portálu
Po startu kontejneru můžete ověřit stav:
docker compose ps
docker compose logs -fUpgrade na novou verzi:
git pull
docker compose up -d --buildDalší příkazy instalačního skriptu
sudo ./deploy/install.sh generate-token claude # vygeneruje nový MCP token
sudo ./deploy/install.sh set-admin-password # reset hesla admin portálu
sudo ./deploy/install.sh test-config # validace config.toml
sudo ./deploy/install.sh uninstall # kompletní odinstalace
sudo ./deploy/install.sh install --with-reporting # instalace s PDF reporty
sudo ./deploy/install.sh install --without-reporting # instalace bez PDF reportůDokumentace a komunita
Veškerá dokumentace projektu je na GitHubu – najdete tam podrobný instalační návod, konfigurační referenci, příklady pro všechny AI klienty i bezpečnostní doporučení. GitHub repo je zároveň hlavní místo pro komunikaci s komunitou:
- README – kompletní dokumentace, konfigurace, seznam všech nástrojů
- INSTALL.md – podrobný instalační návod pro Linux i Docker
- CHANGELOG – přehled změn v každé verzi
- Issues – hlášení chyb a požadavky na nové funkce
- Discussions – nápady, otázky a sdílení zkušeností s komunitou
Server je open-source (AGPL-3.0), podporuje Zabbix 5.0 až 8.0 a je připravený pro produkční nasazení s TLS, rate limitingem a kompletním audit logem. Budeme rádi za jakýkoli feedback – ať už formou ticketu, nápadu v diskuzích, nebo hvězdičky na GitHubu.
