Instalação a partir do Agora da Deque

Se a rede da sua organização restringe o acesso a registros públicos como npmjs.org e Docker Hub, você pode obter o servidor axe MCP no Agora. Ambas as distribuições estão disponíveis lá: os pacotes npm e a imagem Docker.

O Agora é o próprio repositório de artefatos da Deque, hospedado em agora.dequecloud.com, onde a Deque publica os pacotes e imagens que seus clientes instalam. Ele é executado no Artifactory, portanto, comporta-se como qualquer outro registro npm ou fonte de artefato que seu sistema já entende, e sua organização pode fazer proxy dele em seu próprio gerenciador de repositórios.

Este guia cobre especificamente o servidor axe MCP. Para outros pacotes Axe DevTools, veja Instalando Axe DevTools para Web para Node.js a partir do Agora da Deque.

Pré-requisitos

• Credenciais de login do Agora. Se você não as tiver, entre em contato com seu representante da Deque ou com o balcão de suporte.
• Uma distribuição escolhida — veja Escolhendo uma Distribuição.
• Para a distribuição npm, Node.js 22.19.0 ou posterior.
• Para a distribuição Docker, Docker instalado e em execução.

Criando um Token de Identidade

O Agora não autentica downloads de pacotes com a senha da sua conta. Em vez disso, você gera um Token de Identidade — uma credencial de longa duração vinculada à sua conta — e o usa como senha sempre que estas instruções pedirem uma, incluindo no seu .npmrc e em comandos curl. Você só precisa criá-lo uma vez.

A maneira mais simples de criar um Token de Identidade é através do webapp do Agora. Após fazer login, crie um clicando no botão rotulado como Bem-vindo seu-email na barra superior, ao lado do botão de ajuda.

Os Tokens de Identidade expiram anualmente e só podem ser visualizados uma vez, na criação. Armazene o seu em um local seguro.

O que o Agora Hospeda

O Agora contém os mesmos artefatos publicados nos registros públicos, para lançamentos estáveis:

Somente lançamentos estáveis são publicados no Agora. Builds Canary (next) e lançamentos candidatos (rc) permanecem apenas no npmjs.org.

Distribuição npm

Adicionando Autenticação

Para acessar pacotes Deque pelo npm ou Yarn, adicione suas informações de autenticação do Agora ao seu arquivo ~/.npmrc. A ferramenta Configurando Acesso aos pacotes Agora pode gerar esse conteúdo para você a partir do seu email e Token de Identidade do Agora. Caso contrário, gere-o com um comando curl:

curl -u "<your-email>" "https://agora.dequecloud.com/artifactory/api/npm/auth"

Substitua <your-email> pelo seu email de login no Agora. O curl solicitará uma senha — cole o Token de Identidade que você criou acima. O comando retornará:

_auth = <generated-auth-string>
always-auth = true
email = <your-email>

Abra seu ~/.npmrc para edição e adicione o mapeamento de registro seguido pela saída do comando curl:

@deque:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth=<generated-auth-string>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Se você não conseguir executar comandos curl, gere a string de autenticação você mesmo, codificando <your-email>:<your-identity-token> em base-64.

Verificando Seu Acesso

Antes de instalar qualquer coisa, confirme que suas credenciais funcionam e que sua conta do Agora pode ver ambos os pacotes:

npm view @deque/axe-auth versions
npm view axe-mcp-server versions --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

Cada comando deve exibir uma lista de versões publicadas. Se algum falhar, veja Solução de Problemas abaixo — resolvê-lo agora é mais fácil do que diagnosticá-lo no meio de uma instalação.

Instalando o @deque/axe-auth

@deque/axe-auth — o CLI usado para autenticação OAuth 2.0 — é um pacote com escopo, assim a linha @deque:registry acima é tudo que ele precisa. Todos os comandos documentados axe-auth funcionam sem alteração, resolvendo a partir do Agora em vez do npmjs.org:

npx @deque/axe-auth login

Isso também significa que as configurações do cliente MCP que envolvem o servidor em npx -y @deque/axe-auth run não precisam de modificação.

Instalando o axe-mcp-server

axe-mcp-server é um pacote sem escopo, e o npm só pode mapear registros por escopo. Não há uma linha .npmrc que direcione um único pacote sem escopo para o Agora, então instale-o a partir do seu tarball.

Baixe o tarball para a versão desejada, substituindo <version> por uma versão lançada, como 1.4.0 — veja Notas de Lançamento. npm pack autentica com as credenciais já presentes no seu .npmrc, então não é necessário uma ferramenta de download ou manipulação de token separada:

npm pack axe-mcp-server@<version> --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

Em seguida, instale-o globalmente, o que coloca um comando axe-mcp-server no seu PATH:

npm install -g ./axe-mcp-server-<version>.tgz

A dependência playwright é buscada do seu registro padrão durante este segundo passo. Separar o download da instalação é o que mantém essa resolução funcionando.

A distribuição npm é executada no Node.js. Use uma versão LTS ativa do Node.js — versões mais antigas podem não ser suportadas.

Lembre-se de que a distribuição npm também precisa de um navegador Chromium. Veja Instalar Chromium e note que o comando lá deve a versão do Playwright do npmjs.org. Para lê-la do Agora, adicione a sobrecarga de registro — npm view busca um único pacote, então a sobrecarga é segura aqui pela mesma razão que é em npm pack:

npm view axe-mcp-server@<version> dependencies.playwright --registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/

Configurando Seu Cliente MCP

Como o servidor é instalado globalmente em vez de buscado sob demanda, chame o comando instalado diretamente em vez de passar por npx. Usando VS Code com Copilot e uma chave de API como exemplo:

{
  "servers": {
    "axe-mcp-server": {
      "command": "axe-mcp-server",
      "args": [],
      "env": {
        "AXE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Para OAuth 2.0, inicie o servidor através de @deque/axe-auth run da mesma forma que os outros guias fazem, substituindo a invocação de npx -y axe-mcp-server pelo comando instalado:

{
  "servers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": ["-y", "@deque/axe-auth", "run", "--", "axe-mcp-server"],
      "env": {
        "AXE_TOKEN_REFRESH_PORT": "9223"
      }
    }
  }
}

Todo o resto no guias de configuração do cliente se aplica como escrito — apenas command e args diferem. A mesma substituição funciona para Cursor e Claude Code.

Atualizando

Repita o download e a instalação global com o novo número de versão. Verifique Notas de Lançamento para ver o que está disponível.

Distribuição Docker

A Agora hospeda a imagem Docker como tars salvos, um por arquitetura, em devtools-bin/axe-mcp-server/v<version>/.

Substitua <version> por uma versão lançada, como 1.4.0, e <arch> pela arquitetura correspondente à sua máquina — amd64 para Intel e AMD, arm64 para Apple silicon e ARM:

curl -u "<your-email>" \
  -O "https://agora.dequecloud.com/artifactory/devtools-bin/axe-mcp-server/v<version>/axe-mcp-server-<version>-<arch>.tar"

curl solicita uma senha — cole seu Token de Identidade. Fornecendo-o inline em vez disso, como -u "<your-email>:<your-identity-token>", também funciona, mas deixa o token no histórico do seu shell.

Carregue-o no Docker:

docker load -i axe-mcp-server-<version>-<arch>.tar

docker tag dequesystems/axe-mcp-server:v<version> dequesystems/axe-mcp-server:latest

Com a imagem carregada, as configurações do Docker no guias de configuração do cliente funcionam sem alterações. docker run usa a imagem local e não contata o Docker Hub.

Para atualizar, baixe e carregue o tar para a versão mais recente.

Instalando Através do Seu Próprio Repositório de Artefatos

Se sua organização já possui um repositório de artefatos como Artifactory ou Nexus, usar o Agora através dele geralmente é a melhor opção. Os desenvolvedores então não precisam de credenciais do Agora, ambos os pacotes se resolvem normalmente e — ao contrário do método do tarball acima — npx -y axe-mcp-server funciona como documentado em todos os outros lugares.

Esta é a mesma conexão do Agora usada para os outros pacotes do Axe DevTools, então os guias de configuração existentes se aplicam — siga aquele para seu gerenciador de repositórios, escolhendo o tipo de pacote npm e a URL do registro npm https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/:

• Configure seu Artifactory
• Configure seu Nexus

Uma adição específica ao servidor axe MCP: como axe-mcp-server depende de playwright, agregue o repositório remoto do Agora e seu npmjs.org remoto existente em um único repositório virtual, então aponte registry= dos desenvolvedores para isso. Os pacotes Deque então se resolvem do Agora e suas dependências públicas do npmjs.org através de uma única URL, e npx -y axe-mcp-server funciona exatamente como faz no guias de configuração do cliente.

Disponibilidade de Versão

O Agora possui lançamentos estáveis de ambos os pacotes npm, e o tag latest resolve para o lançamento estável mais recente, assim como no npmjs.org. As tags next e rc não são mantidas; compilações de pré-lançamento permanecem disponíveis apenas no npmjs.org.

Se você precisar de um lançamento específico, instale-o pela versão exata.

Solução de Problemas

Para problemas ao executar o servidor após sua instalação, consulte o guia axe MCP Server Solução de Problemas.

Próximos Passos

1. Configurar autenticação — uma chave de API ou OAuth 2.0
2. Configure seu cliente — VS Code com Copilot, Cursor, ou Claude Code

Se você tiver problemas para instalar do Agora, entre em contato diretamente com seu representante Deque, pergunte-nos através do nosso balcão de suporte, ou envie-nos um e-mail.