WebAbility

Encontre e corrija problemas de acessibilidade web (WCAG 2.2, ADA, Section 508, EAA, AODA) diretamente do seu agente de codificação — escaneie qualquer URL/HTML com 3 mecanismos, correções com reconhecimento de framework, verificação, auditoria visual e relatórios prontos para auditores.

Documentação

@webability/mcp

Servidor MCP de testes de acessibilidade para Cursor, VS Code Copilot, Claude Code e qualquer outro IDE compatível com MCP.

O que é WebAbility?

WebAbility.io é uma plataforma de acessibilidade web com inteligência artificial — widget de acessibilidade, scanner automatizado e agentes de IA para conformidade com WCAG 2.1 / 2.2 AA, ADA, Seção 508, EAA (Lei Europeia de Acessibilidade) e AODA. Este MCP expõe o mesmo mecanismo de testes de acessibilidade que alimenta o widget WebAbility e o painel, para que você possa escanear, auditar e corrigir problemas de acessibilidade web (contraste de cores, ARIA, texto alternativo, navegação por teclado, visibilidade de foco, tamanho de alvo e muito mais) diretamente do seu IDE enquanto desenvolve.

Novo em conformidade de acessibilidade? Comece com o verificador gratuito de acessibilidade WCAG e ADA ou leia a documentação do MCP WebAbility e o guia de introdução.

O servidor registra um bloco instructions na inicialização, para que qualquer cliente compatível com MCP capture automaticamente o contexto de negócios (qual ferramenta chamar e quando, a convenção de saída em três níveis, etc.) — sem configuração adicional além da instalação abaixo.

Por que este em vez de outros MCPs de acessibilidade

A maioria dos servidores MCP de acessibilidade para em encontrar e sugerir. O WebAbility fecha todo o ciclo no seu editor e começa gratuito:

  • Escaneamento local gratuito — sem conta, sem Docker. scan_page roda inteiramente na sua máquina. (O axe MCP da Deque exige assinatura paga, chave de API e instalação do Docker apenas para analisar uma página.)
  • Correções que se encaixam na sua stack. generate_ai_fix retorna código pronto para colar no framework que você realmente usa — Tailwind, MUI, Bootstrap, WordPress, Next.js — não orientações genéricas.
  • Uma passada visual que scanners de DOM não conseguem fazer. visual_audit detecta visibilidade de foco, contraste de ícones e "parece um botão, mas não é" — problemas que o axe-core estruturalmente não consegue ver.
  • Verificação, não apenas detecção. verify_fix revalida se a sua correção realmente foi aplicada e retorna verified: true/false. Toda comparação de MCPs de acessibilidade de 2026 aponta esta como a maior lacuna da categoria — a maioria das ferramentas nunca a fecha.
  • Evidência para conformidade. start_audit gera um relatório persistente com registro de data e hora e uma pasta de trabalho Excel que você pode entregar a um auditor — não um resultado que desaparece com a sua sessão.

O ciclo completo, sem sair do editor: scan_page → generate_ai_fix → verify_fix, e depois start_audit quando você precisar do registro documental.

Instalação

npm install -g @webability/mcp

Configuração

Adicione ao arquivo de configuração MCP do seu IDE:

{
  "mcpServers": {
    "webability": {
      "command": "webability-mcp"
    }
  }
}

Variável de ambiente opcional: WEBABILITY_API_URL (padrão https://api.webability.io) para backends auto-hospedados.

Mecanismos de escaneamento

scan_page executa três mecanismos em paralelo e remove duplicatas dos resultados:

MecanismoRegrasO que cobre
Detectores WebAbility60+Contraste com consciência de gradiente, nomes fracos, ícones decorativos, hierarquia de landmarks, correção de ARIA, consistência de links, tamanho de alvo, armadilhas de teclado
axe-core104Base padrão da indústria WCAG 2.2
HTML_CodeSniffer200+Referência cruzada de técnicas da Seção 508 + WCAG

Saída em três níveis (desde v1.2.1)

Cada escaneamento retorna:

  • issues — violações de alta confiança, seguras para reportar como bugs
  • incomplete — descobertas que precisam de revisão humana (contraste em gradientes, imagens de marketing, estados pré-animação do framer-motion, axe-incomplete). Nunca corrija estas automaticamente.
  • summary — contagens por severidade + uma contagem de incomplete

Isso espelha a divisão violations / incomplete / passes do axe-core e impede que agentes "corrijam" falsos positivos de maneiras destrutivas.

Ferramentas

FerramentaO que faz
scan_pageEscaneia uma URL em busca de problemas de acessibilidade WCAG (3 mecanismos)
flow_scanEscaneamento de jornada em várias páginas com problemas deduplicados entre páginas
scan_htmlEscaneia um trecho de HTML bruto (sem necessidade de URL)
detect_frameworkDetecta Tailwind / MUI / Bootstrap / Next.js / WP / CSS puro
generate_ai_fixAlternativas de correção com consciência de framework. Extrai automaticamente a paleta da marca da URL ativa em problemas de contraste.
verify_fixReescaneia um elemento corrigido e confirma que a violação desapareceu — verified: true/false. Fecha o ciclo encontrar → corrigir → verificar.
visual_auditAuditoria em nível de pixel via visão (contraste de ícones, visibilidade de foco, parece-um-botão-mas-não-é)
start_auditInicia a entrega completa da auditoria no servidor (relatório + pasta de trabalho Excel). Retorna um id para consulta. Requer uma conta.
get_auditVerifica o progresso de uma auditoria e, quando concluída, obtém o resumo de severidade + URLs de download do relatório/pasta de trabalho.
check_color_contrastVerificação de contraste WCAG em um par de cores; passe url para obter sugestões alinhadas à marca da página ativa
check_ariaValida atributos ARIA em um trecho de HTML
get_rulesLista regras do axe-core com filtro opcional por tag WCAG
find_sourceMapeia um seletor CSS de volta para arquivos de código-fonte locais

Quando usar este MCP

  • Ao construir um novo componente e querer que ele seja acessível desde o primeiro dia
  • Ao auditar uma build localhost / staging antes de publicar
  • Ao fazer triagem de um relatório Lighthouse / axe — scan_page consolida os três mecanismos
  • Ao gerar sugestões de correção que correspondem ao framework que você já usa
  • Ao verificar contraste de cores com a paleta real da marca do usuário (não sugestões genéricas)

Exemplos

No Cursor / Claude Code:

"Escaneie localhost:3000 em busca de problemas de acessibilidade"

"Percorra login → painel → checkout e relate problemas únicos em todo o fluxo"

"Sugira uma correção para o problema de contraste em .btn-primary em https://example.com — use as cores da marca deles"

"O que a WCAG 1.4.11 verifica?"

Privacidade, registros de escaneamento e telemetria

Cada escaneamento é registrado localmente em ~/.webability/scans/ — um registro index.jsonl de uma linha por escaneamento, além do resultado completo dos seus últimos 500 escaneamentos. Navegue por eles com a ferramenta scan_history ("o que escaneamos antes?") ou com jq simples. Defina WEBABILITY_SCAN_LOG=off para desativar, WEBABILITY_SCAN_LOG_DIR para realocar.

O servidor também envia um pequeno evento de telemetria por chamada de ferramenta (todas as ferramentas, não apenas escaneamentos) para a API WebAbility: nome da ferramenta, um rótulo curto de alvo (URL, seletor, tipo de problema — nunca conteúdo da página), aprovação/reprovação, duração, contagens de problemas e um ID de instalação anônimo persistente. Resultados completos de escaneamento, HTML e código de correção gerado nunca saem da sua máquina via telemetria. Defina WEBABILITY_SCAN_TELEMETRY=off para optar por não participar.

Duas ferramentas — generate_ai_fix e visual_audit — também enviam conteúdo da página (um trecho de HTML ou uma captura de tela) para a API WebAbility para que ela possa chamar um LLM de terceiros em seu nome; a WebAbility não armazena esse conteúdo, mas o provedor de LLM o vê em trânsito. Consulte PRIVACY.md para a análise completa por ferramenta e a política de privacidade da WebAbility.

Saiba mais

Plataforma e documentação WebAbility

Guias de conformidade de acessibilidade

Acessibilidade por setor

Instale o widget na sua stack

Pacote

Palavras-chave: acessibilidade web, testes de acessibilidade, WCAG 2.2 AA, conformidade ADA, Seção 508, EAA, AODA, a11y, scanner de acessibilidade, verificador de contraste de cores, validação ARIA, texto alternativo, navegação por teclado, leitor de tela, servidor MCP, acessibilidade para agentes de codificação com IA.

Licença

MIT © WebAbility.io