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.

Isso usa @deque/axe-auth token para obter um novo token de acesso cada vez que o servidor inicia.

{
  "mcpServers": {
    "axe-mcp-server": {
      "command": "sh",
      "args": [
        "-c",
        "docker run --add-host=host.docker.internal:host-gateway -i --rm -e \"AXE_ACCESS_TOKEN=$(npx -y @deque/axe-auth token)\" dequesystems/axe-mcp-server:latest"
      ]
    }
  }
}
note

Usando uma instância regional, privada, em nuvem ou local do axe? Adicione AXE_SERVER_URL ao comando Docker e um bloco de env com a URL base da sua instância:

"args": [
  "-c",
  "docker run --add-host=host.docker.internal:host-gateway -i --rm -e AXE_SERVER_URL -e \"AXE_ACCESS_TOKEN=$(npx -y @deque/axe-auth token)\" dequesystems/axe-mcp-server:latest"
],
"env": {
  "AXE_SERVER_URL": "https://your-axe-instance.example.com"
}

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

note

Esta configuração usa sh -c para permitir a substituição de shell. $(npx -y @deque/axe-auth token) é executado na inicialização do servidor e injeta um token de acesso válido no contêiner Docker. A flag -y pula a mensagem "Ok para continuar?" que npx pediria de outra forma em um shell não interativo. Não configure AXE_API_KEY junto com AXE_ACCESS_TOKEN.

caution

Usuários de Windows: Esta configuração utiliza um shell POSIX (sh) e substituição de comandos ($(...)), que não estão disponíveis no cmd.exe ou no PowerShell por padrão. Execute seu editor a partir de um shell Git Bash ou WSL para que sh esteja no seu PATH.

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

OAuth 2.0 também é suportado com a distribuição npm — defina AXE_ACCESS_TOKEN em vez de AXE_API_KEY, injetando um novo token a partir de @deque/axe-auth token na inicialização. 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?