Axe MCP Server
Visão Geral
O Axe MCP Server é um servidor Model Context Protocol (MCP) que integra testes de acessibilidade de nível empresarial diretamente no seu fluxo de trabalho de desenvolvimento. Construído na plataforma confiável Axe, ele permite que os desenvolvedores realizem verificações abrangentes de acessibilidade e recebam orientações de remediação especializadas sem sair de seu IDE.
O servidor fornece três ferramentas:
analyzeanalisa uma página da web e pode executar Testes Guiados Inteligentes contra ela na mesma chamada.analyze_mobileanalisa a tela exibida em um dispositivo iOS ou Android, simulador ou emulador, usando o Axe DevTools Mobile.remediatetransforma os problemasanalyzeencontrados em correções de código. Cobre apenas problemas na web.
Uma quarta ferramenta, igt, está obsoleta.
Essas ferramentas se integram perfeitamente com clientes compatíveis com MCP (como Claude Desktop, VS Code com Copilot ou Cursor) e respeitam as configurações do Axe Configuration da sua organização na web. analyze_mobile executa as regras padrão do Axe DevTools Mobile.
Obtendo Acesso
O Axe MCP Server está disponível em dois planos:
- Gratuito — verificações ilimitadas
analyzecom o conjunto de regras padrão do axe-core. Cadastre-se apenas com um endereço de e-mail. - Premium — incluído com Axe DevTools para Web. Adiciona Regras Avançadas, Testes Guiados Inteligentes e a ferramenta
remediate. Solicite uma demonstração para começar.
Veja Planos Gratuito e Premium para uma comparação completa.
Varredura móvel
A varredura móvel com analyze_mobile não faz parte dos planos Free ou Premium. Ela requer uma assinatura Axe DevTools Mobile, que possui sua própria chave de API no Portal da Conta Axe. A varredura móvel está disponível a partir da versão 1.8.0.
Você pode usar cada produto individualmente ou ambos juntos:
- Apenas web: definir
AXE_API_KEY, ou entre com OAuth 2.0. - Apenas móvel: definir
AXE_MOBILE_API_KEY, ou entre com OAuth 2.0 usando uma conta com direito ao Axe DevTools Mobile. As ferramentas da web ainda são listadas, mas não serão executadas. Com a chave, chamar uma delas diz que é necessária uma credencial web. Com OAuth, ela diz que a conta não possui uma assinatura web. - Web e móvel: define tanto
AXE_API_KEYquantoAXE_MOBILE_API_KEY, ou entre uma vez com OAuth 2.0 usando uma conta com direito a ambos.
Veja Combinações de credenciais.
Ferramentas e Capacidades
A Ferramenta analyze
Verifica uma página da web em busca de problemas de acessibilidade em um navegador real, com a Extensão de Navegador Axe DevTools, e retorna os resultados para o seu agente. Funciona com URLs de desenvolvimento local, como localhost:3000, e com URLs remotos, e respeita a Configuração do Axe da sua organização.
As opções permitem que você verifique um tamanho do viewport específico, delimitar a verificação para parte da página, fazer login ou dispensar banners antes de verificar, injetar cookies, capturar uma captura de tela, e, no Premium, execute Regras Avançadas.
Veja Ferramenta de Análise.
A Ferramenta analyze_mobile
Axe DevTools Mobile. Analisa a tela que está atualmente exibida em um dispositivo móvel com as regras do Axe DevTools Mobile e retorna as violações, cada uma colocada na hierarquia de visualizações do aplicativo para que seu agente possa encontrar a visualização na origem. Funciona com um dispositivo ou emulador Android e com um simulador iOS ou iPhone conectado via USB. Precisa da distribuição npm, dois pacotes de scanner instalados junto ao servidor e adb para Android ou macOS com Xcode para iOS.
Veja Analisar Ferramenta Móvel.
Testes Guiados Inteligentes
Premium. A ferramenta analyze também pode executar o Deque's Testes Guiados Inteligentes Automatizados (IGTs) contra a mesma página, na mesma chamada: os IGTs Teclado, Elementos Interativos e Caixa de Diálogo Modal. Os IGTs são potentes em IA e consomem Créditos de IA. Os IGTs são exclusivos para a web; analyze_mobile não os executa.
Veja Testes Guiados Inteligentes.
A Ferramenta remediate
Premium. Leva os problemas analyze encontrados e retorna orientações para correção com recursos de AI, incluindo uma correção de código concreta que seu agente de codificação pode aplicar. Submeta cada problema de uma execução em uma única chamada em lote. Cada problema consome Créditos de IA.
remediate aceita apenas problemas na web. Não suporta descobertas de analyze_mobile.
Veja Ferramenta de Remediação.
A Ferramenta igt
Obsoleto. Use analyze com o parâmetro igtTools em vez disso. Veja A Ferramenta igt.
Primeiros Passos
Antes de começar, você precisa de uma conta Axe: cadastre-se para o plano Gratuito, ou use sua conta Axe DevTools para Web ou Axe DevTools Mobile. Configurar o Axe MCP Server envolve então três escolhas independentes:
- Escolher uma distribuição — Docker ou npm
- Configurar autenticação — uma chave de API ou OAuth 2.0
- Configurar seu cliente — VS Code com Copilot, Cursor ou **Claude Code**
Para analisar aplicativos móveis, adicione uma quarta etapa:
- Configurar análise móvel — adicione os pacotes de scanner ao seu comando de servidor, instale
adbou Xcode, e conecte um dispositivo ou inicie um simulador ou emulador
A análise móvel altera duas das escolhas acima. Precisa da distribuição npm; o Docker não a suporta. E precisa de uma credencial Axe DevTools Mobile: AXE_MOBILE_API_KEY, ou um login OAuth 2.0 para uma conta com direito ao Axe DevTools Mobile.
Usuários do Claude Code podem pular essas etapas com o Plugin de Acessibilidade Axe, que registra o servidor e adiciona comandos de barra para configuração, instruções do agente e execução do ciclo completo de remediação.
Para variáveis de ambiente e instruções recomendadas para o agente de IA, consulte o Referência de Configuração. Se algo der errado, veja o Solução de Problemas.
Exemplos de Comandos
Solicitações que remedeiam problemas ou executam testes guiados precisam do plano Premium. Solicitações móveis precisam do Axe DevTools Mobile.
Garantindo que ferramentas esperadas sejam chamadas
Em muitos IDEs, usar a seguinte sintaxe (prefixo "#") garantirá que as ferramentas do Axe MCP Server sejam chamadas conforme esperado:
#analyze the http://localhost:3033/ web page for accessibility issues and #remediate any violations foundAnalisar uma URL localhost em busca de problemas de acessibilidade:
Analyze http://localhost:3000 for accessibility issuesAnálise com remediação:
Analyze https://example.com for accessibility issues and fix any issues foundAnalise uma página após o login:
Analyze http://localhost:3000 for accessibility issues. Before running the
analysis, fill in the #username and #password fields with USERNAME and
PASSWORD from ./.env.local, click the button[type=submit] button, and
wait for #main-content to appear.Feche um banner de cookies antes de escanear:
Analyze https://example.com for accessibility issues, but first click the
#cookie-dismiss button to dismiss the cookie consent banner.Capture uma captura de tela da página:
Analyze http://localhost:3000 for accessibility issues and capture a screenshot of the pageDigitalize uma página com um cookie de sessão injetado:
Analyze https://app.example.com for accessibility issues. Set the session
cookie for app.example.com from ./.env.local so the scan starts already
logged in.Execute cada teste guiado em uma única chamada:
Analyze http://localhost:3000 for accessibility issues with thorough
advanced rules. Also run the keyboard, interactive elements, and modal
guided tests (test the modal triggered by button#open-dialog).Escolha quais elementos interativos testar:
Analyze http://localhost:3000 and run the interactive elements guided test.
Show me the interactive elements it finds first and let me choose which
ones to test.Teste uma caixa de diálogo modal:
Analyze http://localhost:3000 and run the modal guided test on the dialog
opened by #open-dialogMóvel
analyze_mobile analisa a tela que está aberta no dispositivo quando é chamada.
Analise a tela em um emulador Android:
Scan the screen on my Android emulator for accessibility issuesAnalise um aplicativo em um simulador iOS:
Scan the app on my iPhone simulator for accessibility issues. The bundle ID
is in ios/MyApp.xcodeproj.Analise um simulador ou iPhone específico:
Scan com.example.myapp on the iOS device with UDID 00008110-001A2B3C4D5E6F70Analise várias telas:
I'll open each screen of the checkout flow on my Android device. Scan each
one when I say "next", then summarize the issues across all screens.Analise, depois corrija na origem:
Scan the screen on my Android emulator. For each violation, find the view
in this project using its identifier or view path and suggest a fix.Garantindo que a ferramenta móvel seja chamada:
#analyze_mobile the screen on my Android emulatorSuporte
Para perguntas, problemas ou feedback sobre o Axe MCP Server:
- Suporte Técnico (Premium): helpdesk@deque.com
- Dúvidas Gerais: helpdesk@deque.com
- Perguntas de Vendas: sales@deque.com
Segurança e Privacidade
Para saber o que o servidor envia para a Deque, o que ele armazena e que acesso seu agente de IA precisa, veja a FAQ de Segurança e Privacidade.
