Axe MCP Server

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

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 duas ferramentas: analyze, que verifica uma página e pode executar Testes Guiados Inteligentes nela na mesma chamada, e remediate, que transforma os problemas encontrados em correções de código. Uma terceira 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 da sua organização.

Obtendo Acesso

O Axe MCP Server está incluído no pacote Axe DevTools para Web. Uma assinatura que habilita o acesso ao Axe MCP Server é configurada conversando com um representante de vendas da Deque.

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 em um tamanho do viewport específico, delimitar a verificação para parte da página, fazer login ou dispensar banners antes da verificação, injetar cookies, capturar uma captura de tela, e execute Regras Avançadas.

Veja Ferramenta de Análise.

Testes Guiados Inteligentes

A ferramenta analyze também pode executar os Testes Guiados Inteligentes Automatizados (IGTs) da Deque na mesma página, na mesma chamada: os IGTs Teclado, Elementos Interativos e Caixa de Diálogo Modal. Os IGTs são alimentados por IA e consomem Créditos de IA.

Veja Testes Guiados Inteligentes.

A Ferramenta remediate

Leva os problemas analyze encontrados e retorna orientações de correção baseadas em IA, incluindo uma correção de código concreta, que seu agente de codificação pode aplicar. Envie cada problema de uma execução em uma única chamada em lote. Cada problema consome Créditos de IA.

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

Configurar o Axe MCP Server envolve três escolhas independentes:

  1. Escolher uma distribuição — Docker ou npm
  2. Configurar autenticação — uma chave de API ou OAuth 2.0
  3. Configurar seu cliente — VS Code com Copilot, Cursor ou **Claude Code**

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

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 found

Analisar uma URL localhost em busca de problemas de acessibilidade:

Analyze http://localhost:3000 for accessibility issues

Análise com remediação:

Analyze https://example.com for accessibility issues and fix any issues found

Analise 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.
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 page

Digitalize 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-dialog

Suporte

Para perguntas, problemas ou feedback sobre o Axe MCP Server:

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.

Is this page helpful?

Help us improve this page

Still need help?