Konfigurationsparameter: Zabbix MCP-Server

Übersicht

Der Zabbix MCP-Server ist ein Prozess, der es KI-Agenten ermöglicht, mithilfe des Model Context Protocol (MCP) mit Zabbix zu arbeiten.

Die vom Zabbix MCP-Server in der Konfigurationsdatei (zabbix_mcp_server.conf) unterstützten Parameter sind in diesem Abschnitt aufgeführt.

Die Parameter werden ohne zusätzliche Informationen aufgeführt. Klicken Sie auf den Parameter, um die vollständigen Details anzuzeigen.

Alle Parameter sind optional, sofern nicht ausdrücklich angegeben ist, dass der Parameter obligatorisch ist.

Beachten Sie Folgendes:

• Die Standardwerte entsprechen den Prozessstandards und nicht den Werten in den mitgelieferten Konfigurationsdateien.
• Werte unterstützen Umgebungsvariablen im Format ${NAME}.
• Zabbix unterstützt Konfigurationsdateien nur in der UTF-8-Kodierung ohne BOM.
• Kommentare, die mit # beginnen, werden nur am Anfang der Zeile unterstützt.

Parameterdetails

AllowedIP

Eine Liste durch Kommas getrennter IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von MCP-Clients. Eingehende Verbindungen werden nur von den hier aufgeführten Hosts akzeptiert.

Beispiel:

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

Obligatorisch: ja

AllowTool

Eine Wildcard-Regel, die ein Tool zulässt. Der Parameter kann mehrfach angegeben werden.
Wildcard-Muster verwenden die Syntax des Datenpunktschlüssels, wobei * für beliebige Zeichen steht. Die Regel stimmt mit dem einfachen Toolnamen überein und ignoriert ToolPrefix.
Alle Regeln AllowTool, DenyTool, AllowToolRegexp und DenyToolRegexp bilden eine einzige Liste in der Reihenfolge, in der sie angegeben werden; die erste übereinstimmende Regel entscheidet. Ein Tool, auf das keine Regel zutrifft, ist zulässig.

Beispiel:

AllowTool=host_get

AllowToolRegexp

Eine Regel mit regulären Ausdrücken, die Tools zulässt. Der Parameter kann mehrfach angegeben werden.
Reguläre Ausdrücke verwenden die RE2-Syntax und stimmen mit jedem Teil des einfachen Toolnamens überein, sofern sie nicht verankert sind.

Beispiel:

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

DebugLevel

Geben Sie die Debug-Stufe an:

• 0 – grundlegende Informationen zum Starten und Beenden von Zabbix-Prozessen;
• 1 – kritische Informationen;
• 2 – Fehlerinformationen;
• 3 – Warnungen;
• 4 – zum Debuggen (erzeugt viele Informationen);
• 5 – erweitertes Debugging (erzeugt noch mehr Informationen).

Standard: 3
Bereich: 0-5

DenyTool

Eine Wildcard-Regel, die ein Tool verweigert. Der Parameter kann mehrfach angegeben werden.
Ein verweigertes Tool wird nicht in die Liste der Tools aufgenommen und kann nicht aufgerufen werden. Weitere Informationen finden Sie unter AllowTool.

Beispiel:

DenyTool=maintenance_delete

DenyToolRegexp

Eine Regel mit regulärem Ausdruck, die Tools ablehnt. Der Parameter kann mehrfach angegeben werden.
Weitere Informationen finden Sie unter AllowToolRegexp.

Beispiel:

DenyToolRegexp=^problem_(close|suppress)$

FrontendURL

Der Endpunkt der Zabbix-API: die URL des Zabbix-Frontends, die mit api_jsonrpc.php endet.

Beispiel:

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

Obligatorisch: ja

IgnoreURLCertErrors

Gibt an, wie TLS-Zertifikatsvalidierungsfehler beim Zugriff auf die Zabbix-API behandelt werden:
false – Zertifikatsfehler nicht ignorieren;
true – Zertifikatsfehler ignorieren (nur in einer Entwicklungsumgebung verwenden).

Standard: false

ListenIP

Die IP-Adresse, auf der Verbindungen entgegengenommen werden.

Standard: 0.0.0.0

ListenPort

Der Port, an dem auf Verbindungen gelauscht wird. Der MCP-Endpunktpfad ist /mcp.

Standard: 8443
Bereich: 1024-32767

LogFile

Der Name der Protokolldatei.

Standardwert: /tmp/zabbix_mcp_server.log

Obligatorisch: Nein

LogFileSize

Die maximale Größe einer Protokolldatei in MB.
0 – automatische Protokollrotation deaktivieren.

Standard: 1
Bereich: 0-1024

LogType

Der Typ der Protokollausgabe:

• file – schreibt das Protokoll in die durch den Parameter LogFile angegebene Datei;
• system – schreibt das Protokoll in syslog;
• console – schreibt das Protokoll in die Standardausgabe.

Standard: file

MaxResponseSize

Die maximale Größe einer von einem Lesetool zurückgegebenen Antwort. Sobald dieses Limit oder das limit-Argument des Tools zuerst erreicht wird, wird die Antwort beendet.
Unterstützt Einheitensuffixe.

Standard: 64K
Bereich: 16K-256K

PidFile

Der Name der PID-Datei.

Standard: /tmp/zabbix_mcp_server.pid

Zeitüberschreitung

Die maximale Zeit (in Sekunden), die auf eine Antwort von der Zabbix API gewartet wird.

Standard: 10
Bereich: 3-30

TLSAccept

Welche eingehenden Verbindungen akzeptiert werden:

• unverschlüsselt – Verbindungen ohne Verschlüsselung akzeptieren (Standard);
• Zertifikat – Verbindungen mit TLS und einem Zertifikat akzeptieren.

Standard: unencrypted

TLSCertFile

Der vollständige Pfadname der Datei, die das Serverzertifikat oder die Zertifikatskette enthält.

Obligatorisch: Ja, wenn TLSAccept auf cert gesetzt ist; andernfalls nein

TLSKeyFile

Der vollständige Pfadname der Datei, die den privaten Schlüssel des Servers enthält.

Obligatorisch: Ja, wenn TLSAccept auf cert gesetzt ist; andernfalls nein

ToolPrefix

Ein Präfix, das den Namen aller Tools vorangestellt wird, beispielsweise um Namenskonflikte mit Tools anderer MCP-Server zu vermeiden. Mit ToolPrefix=zbx_ wird das Tool host_get beispielsweise als zbx_host_get bereitgestellt.
Zulässige Zeichen: Buchstaben, Ziffern, Unterstrich (_), Bindestrich (-) und Punkt (.).
Zugriffsregeln für Tools entsprechen den Tool-Namen ohne Präfix.

Beispiel:

ToolPrefix=zbx_