設定パラメータ: Zabbix MCP サーバー

概要

Zabbix MCPサーバーは、AIエージェントがModel Context Protocol(MCP)を使用してZabbixを操作できるようにするプロセスです。

このセクションでは、Zabbix MCPサーバーの設定ファイル(zabbix_mcp_server.conf)でサポートされるパラメータを一覧表示します。

パラメータは追加情報なしで一覧表示されています。パラメータをクリックすると、詳細を確認できます。

パラメータ 説明
AllowedIP MCPクライアントの、カンマ区切りのIPアドレス(CIDR表記も使用可能)またはDNS名のリスト。
AllowTool ツールを許可するワイルドカードルール。
AllowToolRegexp ツールを許可する正規表現ルール。
DebugLevel デバッグレベル。
DenyTool ツールを拒否するワイルドカードルール。
DenyToolRegexp ツールを拒否する正規表現ルール。
FrontendURL Zabbix APIエンドポイント。
IgnoreURLCertErrors Zabbix APIへのアクセス時におけるTLS証明書の検証エラーの処理方法を指定します。
ListenIP 待ち受けるIPアドレス。
ListenPort 待ち受けるポート。
LogFile ログファイルの名前。
LogFileSize ログファイルの最大サイズ。
LogType ログ出力のタイプ。
MaxResponseSize 読み取りツールが返すレスポンスの最大サイズ。
PidFile PIDファイルの名前。
Timeout Zabbix APIからのレスポンスを待機する最大時間(秒)。
TLSAccept 受け入れる受信接続。
TLSCertFile サーバー証明書または証明書チェーンを含むファイルの完全なパス名。
TLSKeyFile サーバーの秘密鍵を含むファイルの完全なパス名。
ToolPrefix すべてのツール名に追加されるプレフィックス。

パラメータが必須であることが明示されていない限り、すべてのパラメータは任意です。

次の点に注意してください。

  • デフォルト値は、提供されている設定ファイルの値ではなく、プロセスのデフォルト値を示します。
  • 値では、${NAME}形式の環境変数を使用できます。
  • Zabbixは、BOMなしのUTF-8エンコーディングの設定ファイルのみをサポートします。
  • #で始まるコメントは、行の先頭でのみサポートされます。

パラメータの詳細

AllowedIP

MCPクライアントのIPアドレス(CIDR表記も使用可能)またはDNS名をカンマ区切りで指定したリストです。受信接続は、ここに記載されたホストからのみ受け入れられます。

例:

AllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,mcp-client.example.com

必須: はい

AllowTool

ツールを許可するワイルドカードルールです。このパラメータは複数回指定できます。
ワイルドカードパターンにはアイテムキーの構文を使用し、* は任意の文字列に一致します。このルールはプレーンなツール名に一致し、ToolPrefix は無視します。
すべての AllowTool、DenyTool、AllowToolRegexp、DenyToolRegexp ルールは、指定された順序で単一のリストを形成します。最初に一致したルールによって判定されます。どのルールにも一致しないツールは許可されます。

例:

AllowTool=host_get
AllowToolRegexp

ツールを許可する正規表現ルールです。このパラメータは複数回指定できます。
正規表現にはRE2構文を使用し、アンカーがない場合はプレーンなツール名の任意の部分に一致します。

例:

AllowToolRegexp=^(host|hostgroup|trigger|problem)_get$
DebugLevel

デバッグレベルを指定します。

  • 0 - Zabbixプロセスの開始および停止に関する基本情報
  • 1 - 重大な情報
  • 2 - エラー情報
  • 3 - 警告
  • 4 - デバッグ用(大量の情報を出力)
  • 5 - 拡張デバッグ用(さらに大量の情報を出力)

デフォルト: 3
範囲: 0-5

DenyTool

ツールを拒否するワイルドカードルールです。このパラメータは複数回指定できます。
拒否されたツールはツールの一覧に含まれず、呼び出すこともできません。 詳細については、AllowToolを参照してください。

例:

DenyTool=maintenance_delete
DenyToolRegexp

ツールを拒否する正規表現ルールです。このパラメータは複数回指定できます。
詳細については、AllowToolRegexpを参照してください。

例:

DenyToolRegexp=^problem_(close|suppress)$
FrontendURL

Zabbix APIエンドポイント: api_jsonrpc.php で終わるZabbix WebインターフェースのURL。

例:

FrontendURL=https://zabbix.example.com/api_jsonrpc.php

必須: はい

IgnoreURLCertErrors

Zabbix APIへのアクセス時におけるTLS証明書の検証エラー処理を指定します。
false - 証明書エラーを無視しない;
true - 証明書エラーを無視する(開発環境でのみ使用してください)。

デフォルト: false

ListenIP

リッスンするIPアドレス。

デフォルト: 0.0.0.0

ListenPort

リッスンするポート。MCPエンドポイントのパスは /mcp です。

デフォルト: 8443
範囲: 1024-32767

LogFile

ログファイルの名前。

デフォルト: /tmp/zabbix_mcp_server.log

必須: いいえ

LogFileSize

ログファイルの最大サイズ(MB)。
0 - 自動ログローテーションを無効にします。

デフォルト: 1
範囲: 0-1024

LogType

ログ出力のタイプ:

  • file - LogFileパラメータで指定したファイルにログを書き込む;
  • system - syslogにログを書き込む;
  • console - 標準出力にログを書き込む。

デフォルト: file

MaxResponseSize

readツールによって返されるレスポンスの最大サイズ。この制限とツールのlimit引数のいずれか早く到達した方によって、レスポンスが停止します。
単位のサフィックスをサポートします。

デフォルト: 64K
範囲: 16K-256K

PidFile

PIDファイルの名前。

デフォルト: /tmp/zabbix_mcp_server.pid

タイムアウト

Zabbix APIからの応答を待機する最大時間(秒)。

デフォルト: 10
範囲: 3-30

TLSAccept

受信接続で許可する接続方式:

  • 暗号化なし - 暗号化されていない接続を許可します(デフォルト)。
  • 証明書 - TLSおよび証明書を使用した接続を許可します。

デフォルト: unencrypted

TLSCertFile

サーバー証明書または証明書チェーンを含むファイルの完全なパス名。

必須: TLSAccept が cert に設定されている場合は「はい」、それ以外の場合は「いいえ」

TLSKeyFile

サーバーの秘密鍵を含むファイルの完全なパス名。

必須: TLSAccept が cert に設定されている場合は「はい」、それ以外の場合は「いいえ」

ToolPrefix

すべてのツール名に追加されるプレフィックスです。たとえば、他の MCP サーバーのツールとの名前の競合を避けるために使用できます。ToolPrefix=zbx_ の場合、host_get ツールは zbx_host_get として公開されます。
使用できる文字: 英字、数字、アンダースコア(_)、ハイフン(-)、ドット(.)。
ツールアクセスルールでは、プレフィックスなしのツール名が使用されます。

例:

ToolPrefix=zbx_