Configuração no Cursor

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

Antes de configurar, escolha uma distribuição (Docker ou npm) e configure a autenticação (chave API ou OAuth 2.0). Em seguida, adicione a configuração correspondente abaixo.

O servidor Axe MCP pode ser adicionado no nível do projeto ou global:

  • Nível de projeto: Crie um arquivo em .cursor/mcp.json no diretório raiz do seu projeto
  • Nível global: Abra as configurações do Cursor, vá para Recursos > MCP, e clique em Adicionar Novo Servidor MCP. Isso abrirá seu arquivo de configuração global.
info

Se você já tiver outros servidores definidos, adicione o bloco axe-mcp-server dentro do objeto mcpServers existente.

Docker

Chave API

Instalação com um clique

Clique no link abaixo para instalar o servidor axe MCP diretamente no Cursor:

Instalar servidor axe MCP no Cursor

O Cursor solicitará que você confirme a instalação. Alternativamente, siga a configuração manual abaixo.

Configuração manual

{
  "mcpServers": {
    "axe-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--add-host=host.docker.internal:host-gateway",
        "-i",
        "--rm",
        "-e",
        "AXE_SERVER_URL",
        "-e",
        "AXE_API_KEY",
        "dequesystems/axe-mcp-server:latest"
      ],
      "env": {
        "AXE_API_KEY": "${env:AXE_API_KEY}"
      }
    }
  }
}

A configuração usa "AXE_API_KEY": "${env:AXE_API_KEY}" para manuseio seguro de entrada. A sintaxe ${env:AXE_API_KEY} instrui o Cursor a obter o valor das variáveis do seu sistema. Para mais informações, consulte o documentação do Cursor MCP.

note

Usando uma instância regional, nuvem privada ou on-premises do axe? Adicione AXE_SERVER_URL ao bloco env com a URL base da sua instância:

"env": {
  "AXE_API_KEY": "${env:AXE_API_KEY}",
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

Se omitido, o servidor assumirá https://axe.deque.com (instância SaaS compartilhada dos EUA da Deque) por padrão. Veja Referência de Configuração para detalhes.

OAuth 2.0

Antes de configurar, complete Etapa 1: Autenticar no guia de Autenticação.

Inicie o servidor através de @deque/axe-auth run, que mantém o token de acesso do servidor em execução fresco enquanto a sessão durar.

{
  "mcpServers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@deque/axe-auth",
        "run",
        "--",
        "docker",
        "run",
        "--add-host=host.docker.internal:host-gateway",
        "-i",
        "--rm",
        "-p",
        "127.0.0.1:9223:9223",
        "-e",
        "AXE_ACCESS_TOKEN",
        "-e",
        "AXE_TOKEN_REFRESH_PORT",
        "-e",
        "AXE_TOKEN_REFRESH_SECRET",
        "-e",
        "AXE_TOKEN_REFRESH_HOST=0.0.0.0",
        "dequesystems/axe-mcp-server:latest"
      ],
      "env": {
        "AXE_TOKEN_REFRESH_PORT": "9223"
      }
    }
  }
}
note

A atualização do token chegou ao servidor axe MCP em v1.5.0. npx -y @deque/axe-auth sempre busca o CLI atual, mas uma imagem Docker puxada antes dessa versão não tem um ouvinte de atualização para run enviar — obtenha-a novamente com docker pull dequesystems/axe-mcp-server:latest.

npx -y @deque/axe-auth run inicia o contêiner e o supervisiona durante a sessão, enviando um token de acesso recém-gerado para o servidor em execução antes que o atual expire. Seu token de atualização nunca sai da sua máquina — apenas tokens de acesso de curta duração chegam ao servidor. A flag -y pula o prompt "Ok para prosseguir?" que npx normalmente perguntaria em um shell não interativo.

As flags restantes existem para tornar essa transmissão acessível dentro do contêiner:

  • -p 127.0.0.1:9223:9223 publica o ouvinte de atualização do servidor apenas no host loopback, mantendo-o fora das interfaces externas da sua máquina.
  • -e AXE_ACCESS_TOKEN, -e AXE_TOKEN_REFRESH_PORT e -e AXE_TOKEN_REFRESH_SECRET encaminham os valores que run gera para dentro do contêiner. Passe apenas os nomes, sem =value — run os fornece.
  • -e AXE_TOKEN_REFRESH_HOST=0.0.0.0 vincula o ouvinte à interface de rede do contêiner. Uma porta publicada reencaminha para lá em vez de para o loopback do contêiner, então o vínculo padrão ao loopback ficaria inacessível. O segredo compartilhado, e não o isolamento do contêiner, é o que protege o endpoint.

9223 é um exemplo — qualquer porta livre na sua máquina funciona, desde que AXE_TOKEN_REFRESH_PORT e o -p publicado nomeiem a mesma. Veja Variáveis de atualização de token para a referência completa.

note

Usando uma instância regional, privada, em nuvem ou local do axe? Adicione AXE_SERVER_URL ao comando Docker e ao bloco env, junto com a porta de atualização:

"args": [
  "-y",
  "@deque/axe-auth",
  "run",
  "--",
  "docker",
  "run",
  "--add-host=host.docker.internal:host-gateway",
  "-i",
  "--rm",
  "-p",
  "127.0.0.1:9223:9223",
  "-e",
  "AXE_SERVER_URL",
  "-e",
  "AXE_ACCESS_TOKEN",
  "-e",
  "AXE_TOKEN_REFRESH_PORT",
  "-e",
  "AXE_TOKEN_REFRESH_SECRET",
  "-e",
  "AXE_TOKEN_REFRESH_HOST=0.0.0.0",
  "dequesystems/axe-mcp-server:latest"
],
"env": {
  "AXE_TOKEN_REFRESH_PORT": "9223",
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

Use o mesmo URL que você passou para --server ao fazer login, assim os tokens que axe-auth emite vêm da instância que o servidor chama. Se omitido, o servidor usa por padrão https://axe.deque.com (a instância SaaS compartilhada dos EUA da Deque). Veja Referência de Configuração para mais detalhes.

npm

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.

A distribuição npm necessita de um navegador Chromium — instale um via Playwright ou aponte para um binário existente. Consulte Escolher uma Distribuição.

Chave API

Crie um arquivo .cursor/mcp.json no diretório raiz do seu projeto (nível de projeto) ou adicione o servidor através das configurações globais MCP do Cursor:

{
  "mcpServers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": ["-y", "axe-mcp-server"],
      "env": {
        "AXE_API_KEY": "your-api-key-here"
      }
    }
  }
}
caution

Sua configuração contém uma credencial no bloco env. Arquivos de nível de projeto como .cursor/mcp.json vivem no seu repositório — adicione-os a .gitignore, ou mantenha credenciais na sua configuração global.

OAuth 2.0

O OAuth 2.0 é suportado com a distribuição npm também. Envolva o servidor em @deque/axe-auth run exatamente como acima — não há contêiner para publicar uma porta, então o comando é mais curto:

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

npx -y @deque/axe-auth run inicia o servidor e o supervisiona durante toda a sessão, enviando um token de acesso recém-gerado para o processo em execução antes que o atual expire. Não é necessário publicar a porta aqui: o processo encapsulado herda AXE_TOKEN_REFRESH_PORT diretamente e o ouvinte permanece no loopback. 9223 é um exemplo — qualquer porta livre em sua máquina funciona, e a variável é opcional aqui: omita-a e run escolhe uma porta livre para a sessão.

caution

Diferente de um contêiner, a distribuição npm herda todo o ambiente do seu shell. Se AXE_API_KEY for exportado lá, ele chega ao servidor junto com o token OAuth e o servidor se recusa a iniciar. Desfaça essa configuração no shell do qual você inicia seu editor, ou use a configuração Docker acima, que apenas recebe as variáveis passadas com flags explícitas -e.

Veja Autenticação para o fluxo completo.

note

Defina ou AXE_API_KEY ou AXE_ACCESS_TOKEN — não ambos. O servidor falhará ao iniciar se ambas as variáveis estiverem definidas.

Uso e verificação

Uma vez adicionado, o indicador de status nas Configurações do Cursor deve mostrar que o servidor está em execução:

  1. Abra as Configurações do Cursor
  2. Vá para Recursos > MCP
  3. Você deve ver axe-mcp-server listado sob Servidores MCP Instalados com as ferramentas analyze, remediate e igt disponíveis.

Para instruções personalizadas recomendadas que guiam o Cursor através do fluxo de trabalho de análise e remediação, consulte Configurando Seu Agente de IA.

Is this page helpful?

Help us improve this page

Still need help?