Paramètres de configuration : serveur MCP Zabbix

Présentation générale

Le serveur MCP Zabbix est un processus qui permet aux agents d’IA d’utiliser Zabbix avec le protocole Model Context Protocol (MCP).

Les paramètres pris en charge par le fichier de configuration du serveur MCP Zabbix (zabbix_mcp_server.conf) sont répertoriés dans cette section.

Les paramètres sont répertoriés sans informations supplémentaires. Cliquez sur un paramètre pour afficher tous les détails.

Tous les paramètres sont facultatifs, sauf indication explicite du contraire.

Notez que :

• Les valeurs par défaut correspondent aux valeurs par défaut du processus, et non aux valeurs des fichiers de configuration fournis ;
• Les valeurs prennent en charge les variables d’environnement au format ${NAME} ;
• Zabbix prend uniquement en charge les fichiers de configuration encodés en UTF-8 sans BOM ;
• Les commentaires commençant par # sont pris en charge uniquement au début de la ligne.

Détails des paramètres

AllowedIP

Liste d’adresses IP séparées par des virgules, éventuellement au format CIDR, ou de noms DNS des clients MCP. Les connexions entrantes seront acceptées uniquement depuis les hôtes répertoriés ici.

Exemple :

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

Obligatoire : oui

AllowTool

Une règle générique qui autorise un outil. Le paramètre peut être spécifié plusieurs fois.
Les modèles génériques utilisent la syntaxe des clés d'élément, où * correspond à n'importe quels caractères. La règle correspond au nom simple de l'outil et ignore ToolPrefix.
Toutes les règles AllowTool, DenyTool, AllowToolRegexp et DenyToolRegexp forment une seule liste, dans l'ordre dans lequel elles sont spécifiées ; la première règle correspondante est déterminante. Un outil qui ne correspond à aucune règle est autorisé.

Exemple :

AllowTool=host_get

AllowToolRegexp

Une règle d'expression régulière qui autorise les outils. Le paramètre peut être spécifié plusieurs fois.
Les expressions régulières utilisent la syntaxe RE2 et correspondent à toute partie du nom d'outil simple, sauf si elles sont ancrées.

Exemple :

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

DebugLevel

Spécifiez le niveau de débogage :

• 0 - informations de base sur le démarrage et l'arrêt des processus Zabbix ;
• 1 - informations critiques ;
• 2 - informations sur les erreurs ;
• 3 - avertissements ;
• 4 - pour le débogage (génère beaucoup d'informations) ;
• 5 - débogage étendu (génère encore plus d'informations).

Valeur par défaut : 3
Plage : 0-5

DenyTool

Une règle avec caractère générique qui interdit un outil. Le paramètre peut être spécifié plusieurs fois.
Un outil interdit n'est pas inclus dans la liste des outils et ne peut pas être appelé. Voir AllowTool pour plus de détails.

Exemple :

DenyTool=maintenance_delete

DenyToolRegexp

Une règle d'expression régulière qui interdit des outils. Le paramètre peut être spécifié plusieurs fois.
Voir AllowToolRegexp pour plus de détails.

Exemple :

DenyToolRegexp=^problem_(close|suppress)$

FrontendURL

Le point de terminaison de l’API Zabbix : l’URL de l’interface Zabbix se terminant par api_jsonrpc.php.

Exemple :

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

Obligatoire : oui

IgnoreURLCertErrors

Spécifie la gestion des erreurs de validation des certificats TLS lors de l'accès à l'API Zabbix :
false - ne pas ignorer les erreurs de certificat ;
true - ignorer les erreurs de certificat (à utiliser uniquement dans un environnement de développement).

Valeur par défaut : false

ListenIP

L’adresse IP sur laquelle écouter.

Par défaut : 0.0.0.0

ListenPort

Le port d'écoute. Le chemin du point de terminaison MCP est /mcp.

Valeur par défaut : 8443
Plage : 1024-32767

LogFile

Nom du fichier journal.

Par défaut : /tmp/zabbix_mcp_server.log

Obligatoire : Non

LogFileSize

La taille maximale d’un fichier journal en Mo.
0 - désactive la rotation automatique des journaux.

Valeur par défaut : 1
Plage : 0-1024

LogType

Le type de sortie du journal :

• file - écrit le journal dans le fichier spécifié par le paramètre LogFile ;
• system - écrit le journal dans syslog ;
• console - écrit le journal dans la sortie standard.

Par défaut : file

MaxResponseSize

La taille maximale d'une réponse renvoyée par un outil de lecture. La première limite atteinte entre cette limite et l'argument limit de l'outil arrête la réponse.
Prend en charge les suffixes d'unités.

Valeur par défaut : 64K
Plage : 16K-256K

PidFile

Nom du fichier PID.

Par défaut : /tmp/zabbix_mcp_server.pid

Délai d’attente

Le délai maximal (en secondes) à attendre pour obtenir une réponse de l’API Zabbix.

Valeur par défaut : 10
Plage : 3-30

TLSAccept

Connexions entrantes à accepter :

• non chiffrées - accepter les connexions sans chiffrement (par défaut) ;
• certificat - accepter les connexions avec TLS et un certificat.

Par défaut : unencrypted

TLSCertFile

Le chemin complet du fichier contenant le certificat du serveur ou la chaîne de certificats.

Obligatoire : Oui, si TLSAccept est défini sur cert ; sinon, non

TLSKeyFile

Le chemin complet du fichier contenant la clé privée du serveur.

Obligatoire : Oui, si TLSAccept est défini sur cert ; sinon, non

ToolPrefix

Préfixe ajouté aux noms de tous les outils, par exemple pour éviter les conflits de noms avec les outils d'autres serveurs MCP. Par exemple, avec ToolPrefix=zbx_, l'outil host_get est exposé sous le nom zbx_host_get.
Caractères autorisés : lettres, chiffres, trait de soulignement (_), trait d'union (-) et point (.).
Les règles d'accès aux outils correspondent aux noms des outils sans le préfixe.

Exemple :

ToolPrefix=zbx_