Zabbix AI CLI — AIエージェント向けZabbix MCPサーバーおよびCLI

zabbix-ai-cli は、1つのGoバイナリにZabbix MCPサーバーとコマンドラインクライアントを兼ね備えたツールです。 Claude Code、Claude Desktop、Codex、Cursor、その他のModel Context Protocolクライアントに、Zabbixへのタスク指向のアクセスを提供します。現在何が壊れているか、ホストがなぜ沈黙しているか、アラートがなぜ届かなかったかなど、出力を制限し、安定したJSON契約を備え、人の承認なしにZabbixを変更することはありません。

これは、ページングされる人々のためのものです。Zabbixを運用するSREおよびDevOpsチームが、API全体を渡すことなくエージェントにインシデントのトリアージをさせたい場合に役立ちます。

Zabbix 6.4以降が必要です。 Bearerトークン認証は6.4で導入され、実装されている唯一の方式です。それ以前のバージョンでは、トークンをリクエストボディで渡すことを想定しています。

言語モデルに接続することはありません。AIが決定し、このプログラムが実行し、Zabbixが監視します。

zabbix-ai-cli login
zabbix-ai-cli problems list
zabbix-ai-cli host investigate server01
zabbix-ai-cli alert why 757474
zabbix-ai-cli mcp

なぜ別のZabbix APIラッパーではないのか

host.get、problem.get、history.getをラップすると、エージェントにAPIの強力さとともに鋭いエッジ（危険な部分）を渡すことになります。現在のZabbix 7.4サーバーでは：

• problem.getにはselectHostsがないため、問題リストはホスト情報なしで届きます。

• history.getはデフォルトで数値符号なしテーブルを使用し、floatアイテムに対しては何も返しません。エラーもなく静かに。

• item.lastvalueとitem.lastclockはまだ存在し、いくつかのメジャーリリースで定数"0"を返し続けています。

• host.availableは5.4で削除されました。可用性はインターフェースにあります。

• event.acknowledgeは、ドキュメント自体が矛盾しているビットマスクを受け取ります。

• searchWildcardsEnabled: trueは暗黙の部分文字列マッチングを無効にし、名前の断片を完全一致に変えて、静かに何も見つけません。

これらのすべては、エラーではなく自信に満ちた誤った回答を生成します。このツールは、エンドポイントではなくタスクを説明するコマンドの背後にそれらを吸収します。

Related MCP server: Zabbix MCP Server

機能

安全性

読み取り操作は即座に実行されます。それ以外は何も実行されません。

変更を適用するMCPパラメータは存在せず、追加しても役に立ちません。エージェントが送信できる確認は、プロンプトインジェクションが送信できる確認と同じです。承認はモデルのコンテキスト外のターミナルにあります。

$ zabbix-ai-cli maintenance create "ms*" --for 2h

PLAN pl_cc89d2e87d15

Create maintenance "ms* (2h0m)" for 2h0m, 2026-08-21T05:39:00Z to 2026-08-21T07:39:00Z

Affects:
  host ms1.8qw.ru
  host ms10.8qw.ru
  ...

Risk: write
Expires: 2026-08-21T05:54:22Z

Nothing has changed yet.
To apply it: zabbix-ai-cli approve pl_cc89d2e87d15

プランが実行される前に、そのパラメータは再ハッシュされ、期限がチェックされ、前提条件がZabbixから再読み取りされます。プラン作成後に置き換えられたウィンドウは削除されず拒否されます。適用されたすべての変更は監査ログに追加されます。

これは拒否よりも重要です。このツールが置き換えるツールが書き込みをブロックしたとき、作業はコンテナからコピーされたトークンでとにかく実行されました。監査証跡を失い、何も防げませんでした。記録された許可パスは、迂回される拒否に勝ります。

インストール

ビルド済みアーカイブとghcr.ioイメージは、各タグ付きリリースで公開されます。最初のタグが付くまでは、以下のいずれかの方法でソースからビルドしてください。

ホストネイティブバイナリには、Go 1.25以降を使用してください：

go install github.com/stufently/zabbix-ai-cli/cmd/zabbix-ai-cli@latest

# Or build the current checkout.
mkdir -p bin
go build -trimpath -o bin/zabbix-ai-cli ./cmd/zabbix-ai-cli

Makeターゲットはコンテナ優先で、ホストにGoは不要です：

make build      # Linux binary in ./bin, built inside Docker
make docker     # Linux container image for the MCP server

設定

zabbix-ai-cli login --profile prod

URLとAPIトークンを尋ね、サーバーに対してトークンを検証し、保存します。トークンはフラグとして受け付けられません。フラグの値はシェル履歴やプロセスリストに表示されるためです。代わりにパイプで渡してください：

printf %s "$TOKEN" | zabbix-ai-cli login --profile prod --url https://zabbix.example.com --token-stdin

プロファイルに書き込みスコープが付与されるまで、書き込みはオフです：

zabbix-ai-cli profile scopes prod --add maintenance

解決順序、ヘッドレスおよびコンテナのケースについては、docs/authentication.mdを参照してください。

AIクライアントにZabbix MCPサーバーを追加する

MCPクライアントがZabbixトークンを見ることはありません。トークンは設定したプロファイルからサーバープロセス内で解決されるため、資格情報がモデルのコンテキストやクライアントの設定ファイルに入ることはありません。

Claude Code

claude mcp add zabbix -- zabbix-ai-cli mcp --profile prod
zabbix-ai-cli skills install claude

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "zabbix": {
      "command": "zabbix-ai-cli",
      "args": ["mcp", "--profile", "prod"]
    }
  }
}

Codex

# ~/.codex/config.toml
[mcp_servers.zabbix]
command = "zabbix-ai-cli"
args = ["mcp", "--profile", "prod"]

zabbix-ai-cli skills install codex

Cursor、Windsurf、VS Code、およびその他のMCPクライアント

stdioを話すクライアントは、同じ2つのフィールド（コマンドzabbix-ai-cli、引数["mcp", "--profile", "prod"]）を受け取ります。代わりにHTTPを希望するクライアントの場合：

zabbix-ai-cli mcp --http 127.0.0.1:8000

--allow-remoteをベアラートークンと一緒に渡さない限り、ルーティング可能なアドレスを拒否します。認証されていないMCPエンドポイントは、Zabbixへの認証されていないルートになるためです。docs/mcp.mdを参照してください。

Docker

docker run --rm -i \
  -e ZABBIX_AI_CLI_URL=https://zabbix.example.com \
  -e ZABBIX_AI_CLI_TOKEN_FILE=/run/secrets/zabbix \
  -v /path/to/token:/run/secrets/zabbix:ro \
  ghcr.io/stufently/zabbix-ai-cli:latest mcp

MCPツール

14のツールであり、200ではありません。ツールサーフェスが大きいと、エージェントが何もする前にコンテキストを消費し、そのほとんどは呼び出されることはありません。

zabbix_problems           zabbix_metrics_latest      zabbix_unreachable
zabbix_problem            zabbix_metrics_history     zabbix_maintenance_list
zabbix_hosts              zabbix_alert_why           zabbix_api_call
zabbix_host_status        zabbix_resolve             zabbix_plan_create
zabbix_host_investigate                              zabbix_plan_status

書き込み操作にはそれぞれツールが1つずつあるわけではありません。zabbix_plan_createは、CLIが構築されるのと同じレジストリから生成されたoperation列挙型を受け取るため、操作が追加されてもツールサーフェスは増えません。

JSON契約

{
  "ok": true,
  "data": {},
  "warnings": [],
  "meta": {
    "returned": 50,
    "total": 381,
    "truncated": true,
    "truncated_reason": "row_limit",
    "partial": false,
    "zabbix_version": "7.4.10"
  }
}

エラーには安定したコード、再試行が価値があるかどうか、次に何をすべきかが含まれます：

{
  "ok": false,
  "error": {
    "code": "AUTHENTICATION_FAILED",
    "message": "Zabbix rejected the configured API token",
    "retryable": false,
    "suggestion": "run 'zabbix-ai-cli login' to configure a new token"
  }
}

zabbix-ai-cli schemaは、すべての操作、そのパラメータ、JSON Schemaを出力するため、エージェントはフラグを推測する代わりにプログラムでツールを学習できます。

詳細はdocs/json-output.mdにあります。

ドキュメント

• 認証とプロファイル

• コマンドライン

• MCPサーバー

• スキル

• JSON出力と終了コード

• セキュリティモデル

• アーキテクチャと設計上の決定

FAQ

Zabbix MCPサーバーとは何ですか？

MCPサーバーは、Model Context Protocolを介してAIクライアントにシステムを公開する小さなプログラムです。Zabbix MCPサーバーを使用すると、Claude、Codex、Cursorなどのクライアントが、JSON-RPC APIに対するcurl呼び出しを推測する代わりに、Zabbix（問題、ホスト、アイテム、イベント、メンテナンス）をツールとしてクエリできます。

AIエージェントはこれを通じて私のZabbixを変更できますか？

単独ではできません。読み取り操作は即座に実行されます。すべての書き込みはプランを生成して停止します。そのプランを適用するのは、人が自分のターミナルで実行するコマンドです：zabbix-ai-cli approve <plan-id>。何かを適用するMCPパラメータは存在せず、もし追加された場合はテストがビルドを失敗させます。

監視データをAIプロバイダーに送信しますか？

いいえ。このプログラムは言語モデルに接続することはありません。Zabbixと通信し、JSONを出力します。MCPクライアントがその出力をどう扱うかは、あなたとクライアントの間の問題です。

サポートされているZabbixバージョンは？

Zabbix 6.4以降です。ベアラートークン認証が6.4で導入されたためです。Zabbix 7.4に対して開発およびテストされています。

Goをインストールする必要がありますか？

いいえ。make buildはDocker内でコンパイルされ、ホストにはDocker自体以外何も必要ありません。go installはホストネイティブバイナリ用にあり、各タグ付きリリースでは、Linux、macOS、Windows用のアーカイブとチェックサム、およびghcr.io上のコンテナイメージが公開されます。

Zabbix APIをラップするMCPサーバーとどう違うのですか？

薄いラッパーはエージェントにAPIの鋭いエッジを渡します：ホストなしのproblem.get、floatアイテムに対して静かに何も返さないhistory.get、"0"で凍結されたlastvalue。これらはエラーではなく自信に満ちた誤った回答を生成します。このツールは「何が壊れているか」「なぜこのアラートが届かなかったのか」といった質問に答え、その背後にある罠を吸収します。また、200ではなく14のツールを提供します。大きなツールサーフェスは、エージェントが何かをする前にコンテキストを消費するからです。

生のZabbix APIを呼び出すことはできますか？

はい、api callを通じて、同じ承認ルールの下で可能です。資格情報を渡したりコードを実行したりするメソッドは完全に拒否されます。スクリプトを作成してアクションに実行させるような遠回しな方法も含みます。

AIクライアントなしでも動作しますか？

はい。人間が読めるテーブル、JSON出力、文書化された終了コードを備えた通常のCLIであり、シェルやCIジョブから同様に使用できます。

互換性

Zabbix 6.4以降。ベアラートークン認証は6.4で導入され、実装されている唯一の方式です。バージョン依存の動作は明示的に検証されるため、非互換性は空の結果を返すのではなく報告されます。

Zabbix 7.4に対して開発およびテストされています。

ライセンス

Apache-2.0。LICENSEを参照してください。

ZabbixはZabbix LLCの商標です。このプロジェクトは独立したオープンソースプロジェクトであり、Zabbix LLCとは提携しておらず、その承認も受けていません。