Parámetros de configuración: Zabbix MCP server

Descripción general

El server MCP de Zabbix es un proceso que permite a los agentes de IA trabajar con Zabbix mediante el Model Context Protocol (MCP).

En esta sección se enumeran los parámetros compatibles con el archivo de configuración del server MCP de Zabbix (zabbix_mcp_server.conf).

Los parámetros se enumeran sin información adicional. Haga clic en un parámetro para consultar todos los detalles.

Todos los parámetros son opcionales, a menos que se indique explícitamente que el parámetro es obligatorio.

Tenga en cuenta lo siguiente:

• Los valores predeterminados reflejan los valores predeterminados del proceso, no los valores de los archivos de configuración incluidos;
• Los valores admiten variables de entorno en el formato ${NAME};
• Zabbix admite archivos de configuración únicamente con codificación UTF-8 y sin BOM;
• Los comentarios que comienzan con # solo se admiten al principio de la línea.

Detalles de los parámetros

AllowedIP

Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de clientes MCP. Las conexiones entrantes solo se aceptarán desde los hosts incluidos aquí.

Ejemplo:

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

Obligatorio: sí

AllowTool

Una regla de comodín que permite una herramienta. El parámetro se puede especificar varias veces.
Los patrones de comodín utilizan la sintaxis de clave de item, donde * coincide con cualquier carácter. La regla coincide con el nombre simple de la herramienta e ignora ToolPrefix.
Todas las reglas AllowTool, DenyTool, AllowToolRegexp y DenyToolRegexp forman una única lista en el orden en que se especifican; la primera regla coincidente determina el resultado. Una herramienta que no coincide con ninguna regla está permitida.

Ejemplo:

AllowTool=host_get

AllowToolRegexp

Una regla de expresión regular que permite herramientas. El parámetro se puede especificar varias veces.
Las expresiones regulares utilizan la sintaxis RE2 y coinciden con cualquier parte del nombre de la herramienta sin formato, a menos que se anclen.

Ejemplo:

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

DebugLevel

Especifique el nivel de depuración:

• 0 - información básica sobre el inicio y la detención de los procesos de Zabbix;
• 1 - información crítica;
• 2 - información sobre errores;
• 3 - advertencias;
• 4 - para la depuración (genera mucha información);
• 5 - depuración ampliada (genera aún más información).

Valor predeterminado: 3
Rango: 0-5

DenyTool

Una regla de comodín que deniega una herramienta. El parámetro se puede especificar varias veces.
Una herramienta denegada no se incluye en la lista de herramientas y no se puede llamar. Consulte AllowTool para obtener más información.

Ejemplo:

DenyTool=maintenance_delete

DenyToolRegexp

Una regla de expresión regular que deniega herramientas. El parámetro se puede especificar varias veces.
Consulte AllowToolRegexp para obtener más información.

Ejemplo:

DenyToolRegexp=^problem_(close|suppress)$

FrontendURL

El endpoint de la API de Zabbix: la URL del frontend de Zabbix que termina en api_jsonrpc.php.

Ejemplo:

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

Obligatorio: sí

IgnoreURLCertErrors

Especifica el manejo de los errores de validación de certificados TLS al acceder a la API de Zabbix:
false - no ignorar los errores de certificado;
true - ignorar los errores de certificado (usar únicamente en un entorno de desarrollo).

Valor predeterminado: false

ListenIP

La dirección IP en la que se escuchará.

Valor predeterminado: 0.0.0.0

ListenPort

El puerto en el que se escuchará. La ruta del endpoint MCP es /mcp.

Valor predeterminado: 8443
Rango: 1024-32767

LogFile

El nombre del archivo de registro.

Valor predeterminado: /tmp/zabbix_mcp_server.log

Obligatorio: No

LogFileSize

El tamaño máximo de un archivo de registro en MB.
0 - desactiva la rotación automática de registros.

Valor predeterminado: 1
Rango: 0-1024

LogType

El tipo de salida del registro:

• file - escribe el registro en el archivo especificado por el parámetro LogFile;
• system - escribe el registro en syslog;
• console - escribe el registro en la salida estándar.

Valor predeterminado: file

MaxResponseSize

El tamaño máximo de una respuesta devuelta por una herramienta de lectura. La respuesta se detiene cuando se alcanza primero este límite o el argumento limit de la herramienta.
Admite sufijos de unidades.

Valor predeterminado: 64K
Rango: 16K-256K

PidFile

El nombre del archivo PID.

Valor predeterminado: /tmp/zabbix_mcp_server.pid

Tiempo de espera

El tiempo máximo (en segundos) que se debe esperar para recibir una respuesta de la API de Zabbix.

Valor predeterminado: 10
Rango: 3-30

TLSAccept

Qué conexiones entrantes aceptar:

• sin cifrar: aceptar conexiones sin cifrado (predeterminado);
• cert: aceptar conexiones con TLS y un certificado.

Predeterminado: unencrypted

TLSCertFile

La ruta completa del archivo que contiene el certificado del server o la cadena de certificados.

Obligatorio: Sí, si TLSAccept está establecido en cert; de lo contrario, no

TLSKeyFile

La ruta completa del archivo que contiene la clave privada del server.

Obligatorio: Sí, si TLSAccept está establecido en cert; de lo contrario, no

ToolPrefix

Un prefijo añadido a los nombres de todas las herramientas, por ejemplo, para evitar conflictos de nombres con las herramientas de otros servidores MCP. Por ejemplo, con ToolPrefix=zbx_, la herramienta host_get se expone como zbx_host_get.
Caracteres permitidos: letras, dígitos, guion bajo (_), guion (-) y punto (.).
Las reglas de acceso a las herramientas coinciden con los nombres de las herramientas sin el prefijo.

Ejemplo:

ToolPrefix=zbx_