Notas de Lançamento do Axe MCP Server Versão 1.7.0

Data de Lançamento

12 de outubro de 2026

Visão Geral

Esta versão v1.7.0 adiciona suporte para redes corporativas restritas. Se a sua organização exige que o tráfego de saída passe por um proxy ou assina seus sites com sua própria autoridade certificadora (CA), agora você pode configurar o Axe MCP Server para trabalhar com eles. Se você não usar nenhum dos dois, nada muda para você. Esta versão também explica problemas de inicialização e de navegador em linguagem simples.

Novas Funcionalidades

Suporte a Proxy

Se a sua rede só permite tráfego de saída através de um proxy, como o Zscaler, agora pode configurar HTTPS_PROXY (ou HTTP_PROXY para um servidor http:// axe) e o servidor enviará todo seu tráfego para o servidor axe através desse proxy, incluindo inicialização, verificações de chave API e remediação. Os hosts listados em NO_PROXY conectam-se diretamente. Se você não configura um proxy, o servidor se conecta diretamente, como antes.

{
  "env": {
    "HTTPS_PROXY": "http://proxy.example.com:3128",
    "NO_PROXY": "intranet.example.com"
  }
}

• Quando um proxy é configurado, o navegador que escaneia suas páginas também o usa. Liste os sites da intranet que você escaneia em NO_PROXY. Com a distribuição npm, localhost e outros endereços locais sempre se conectam diretamente, então escaneamentos de servidores de desenvolvimento local não são afetados. Com o Docker, adicione também o endereço do host Docker em NO_PROXY. Veja Variáveis de proxy.
• O navegador de escaneamento não pode usar um proxy que exija um nome de usuário e senha. O servidor registra um aviso se você configurar um.
• Se a URL do proxy que o servidor usa não for um endereço válido de http:// ou https://, o servidor para na inicialização com uma mensagem que nomeia a variável.

Se você usa OAuth 2.0, configure também NODE_USE_ENV_PROXY=1 para que o CLI @deque/axe-auth faça login e atualize os tokens através do proxy. Isso requer Node.js 22.21 ou posterior. Veja Variáveis de proxy.

Veja Variáveis de proxy para mais detalhes.

Orientação Mais Clara para Certificados Não Confiáveis

Quando um escaneamento falha porque o navegador não confia no certificado da página, seu agente agora diz como corrigi-lo:

• Linux e Docker — configure NODE_EXTRA_CA_CERTS para a CA que assinou o certificado, depois reinicie o servidor.
• macOS — adicione a CA ao seu chaveiro de login, confiando apenas para SSL.
• Windows — adicione a CA ao seu armazenamento de Raiz de Usuário Atual Confiável, confiando apenas para SSL.

Veja Certificados não confiáveis para os passos completos.

Timeouts do IGT Indicam Onde a Execução Parou

Quando um Teste Guiado Inteligente atinge o tempo limite, o erro agora indica o último passo alcançado e quanto tempo atrás, o que torna um teste interrompido muito mais fácil de diagnosticar:

IGT timed out after 200000ms (last checkpoint: keyboard:tabstops:start 83s ago; last step: analyze-tabstops-ai 61s ago; last tick 2s ago)

Correção de Bugs

• Certificados CA personalizados agora funcionam no navegador de escaneamento no Linux e Docker. Antes, NODE_EXTRA_CA_CERTS nunca chegava ao navegador, portanto páginas assinadas por uma CA interna falhavam na verificação.
• Configurar NODE_EXTRA_CA_CERTS não impede mais a inicialização no macOS e Windows. O servidor agora inicia normalmente e informa qual armazenamento de certificados do sistema usar em vez disso.
• A inicialização explica por que um Chrome personalizado não pode ser iniciado. Se AXE_CHROME_PATH aponta para um navegador que não pode iniciar, o servidor agora diz o porquê. Antes, ele relatava o navegador como faltando.
• Bibliotecas do sistema ausentes são relatadas quando você usa um Chrome personalizado. Quando AXE_CHROME_PATH está configurado, erros de inicialização mantêm seus diagnósticos completos, incluindo a correção para bibliotecas Linux ausentes.
• Erros de configuração são legíveis. Uma configuração inválida agora produz uma mensagem que nomeia a configuração, em vez de um rastreamento de pilha AssertionError bruto.
• Links quebrados na documentação foram corrigidos em mensagens do servidor.