設定パラメータ: 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_