Parâmetros de configuração: Zabbix MCP server

Visão geral

O Zabbix MCP server é um processo que permite que agentes de IA trabalhem com o Zabbix usando o Model Context Protocol (MCP).

Os parâmetros compatíveis com o arquivo de configuração do Zabbix MCP server (zabbix_mcp_server.conf) estão listados nesta seção.

Os parâmetros são listados sem informações adicionais. Clique no parâmetro para ver os detalhes completos.

Todos os parâmetros são opcionais, a menos que seja explicitamente indicado que o parâmetro é obrigatório.

Observe que:

• Os valores padrão refletem os padrões do processo, não os valores dos arquivos de configuração fornecidos;
• Os valores são compatíveis com variáveis de ambiente no formato ${NAME};
• O Zabbix oferece suporte apenas a arquivos de configuração codificados em UTF-8 sem BOM;
• Comentários iniciados com # são compatíveis apenas no início da linha.

Detalhes dos parâmetros

AllowedIP

Uma lista de endereços IP delimitados por vírgulas, opcionalmente na notação CIDR, ou nomes DNS de clientes MCP. As conexões de entrada serão aceitas somente dos hosts listados aqui.

Exemplo:

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

Obrigatório: sim

AllowTool

Uma regra curinga que permite uma ferramenta. O parâmetro pode ser especificado várias vezes.
Os padrões curinga usam a sintaxe de chave de item, na qual * corresponde a quaisquer caracteres. A regra corresponde ao nome simples da ferramenta e ignora ToolPrefix.
Todas as regras AllowTool, DenyTool, AllowToolRegexp e DenyToolRegexp formam uma única lista na ordem em que são especificadas; a primeira regra correspondente determina o resultado. Uma ferramenta que não corresponde a nenhuma regra é permitida.

Exemplo:

AllowTool=host_get

AllowToolRegexp

Uma regra de expressão regular que permite ferramentas. O parâmetro pode ser especificado várias vezes.
As expressões regulares usam a sintaxe RE2 e correspondem a qualquer parte do nome simples da ferramenta, a menos que estejam ancoradas.

Exemplo:

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

DebugLevel

Especifique o nível de depuração:

• 0 - informações básicas sobre a inicialização e a interrupção dos processos do Zabbix;
• 1 - informações críticas;
• 2 - informações de erro;
• 3 - avisos;
• 4 - para depuração (gera muitas informações);
• 5 - depuração estendida (gera ainda mais informações).

Padrão: 3
Intervalo: 0-5

DenyTool

Uma regra curinga que nega uma ferramenta. O parâmetro pode ser especificado várias vezes.
Uma ferramenta negada não é incluída na lista de ferramentas e não pode ser chamada. Consulte AllowTool para obter detalhes.

Exemplo:

DenyTool=maintenance_delete

DenyToolRegexp

Uma regra de expressão regular que nega ferramentas. O parâmetro pode ser especificado várias vezes.
Consulte AllowToolRegexp para obter detalhes.

Exemplo:

DenyToolRegexp=^problem_(close|suppress)$

FrontendURL

O endpoint da API do Zabbix: a URL do frontend do Zabbix terminando com api_jsonrpc.php.

Exemplo:

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

Obrigatório: sim

IgnoreURLCertErrors

Especifica o tratamento de erros de validação de certificados TLS ao acessar a API do Zabbix:
false - não ignorar erros de certificado;
true - ignorar erros de certificado (usar somente em um ambiente de desenvolvimento).

Padrão: false

ListenIP

O endereço IP no qual escutar.

Padrão: 0.0.0.0

ListenPort

A porta na qual escutar. O caminho do endpoint MCP é /mcp.

Padrão: 8443
Intervalo: 1024-32767

LogFile

O nome do arquivo de log.

Padrão: /tmp/zabbix_mcp_server.log

Obrigatório: Não

LogFileSize

O tamanho máximo de um arquivo de log em MB.
0 - desabilita a rotação automática de logs.

Padrão: 1
Intervalo: 0-1024

LogType

O tipo da saída do log:

• file - grava o log no arquivo especificado pelo parâmetro LogFile;
• system - grava o log no syslog;
• console - grava o log na saída padrão.

Padrão: file

MaxResponseSize

O tamanho máximo de uma resposta retornada por uma ferramenta de leitura. O limite que for atingido primeiro, entre este limite e o argumento limit da ferramenta, interrompe a resposta.
Suporta sufixos de unidade.

Padrão: 64K
Intervalo: 16K-256K

PidFile

O nome do arquivo PID.

Padrão: /tmp/zabbix_mcp_server.pid

Tempo limite

O tempo máximo (em segundos) de espera por uma resposta da API do Zabbix.

Padrão: 10
Intervalo: 3-30

TLSAccept

Quais conexões de entrada aceitar:

• unencrypted - aceitar conexões sem criptografia (padrão);
• cert - aceitar conexões com TLS e um certificado.

Padrão: unencrypted

TLSCertFile

O caminho completo do arquivo que contém o certificado do server ou a cadeia de certificados.

Obrigatório: Sim, se TLSAccept estiver definido como cert; caso contrário, não

TLSKeyFile

O caminho completo do arquivo que contém a chave privada do server.

Obrigatório: Sim, se TLSAccept estiver definido como cert; caso contrário, não

ToolPrefix

Um prefixo adicionado aos nomes de todas as ferramentas, por exemplo, para evitar conflitos de nomes com ferramentas de outros servidores MCP. Por exemplo, com ToolPrefix=zbx_, a ferramenta host_get é exposta como zbx_host_get.
Caracteres permitidos: letras, dígitos, sublinhado (_), hífen (-) e ponto (.).
As regras de acesso às ferramentas correspondem aos nomes das ferramentas sem o prefixo.

Exemplo:

ToolPrefix=zbx_