Configuração no Claude Code

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

O servidor Axe MCP pode ser adicionado no nível de projeto ou de usuário.

Escolher o escopo

  • Nível de projeto: Crie um arquivo em .mcp.json no diretório raiz do seu projeto (melhor para compartilhar configurações com uma equipe)
  • Nível de usuário: Crie ou edite o arquivo de configuração em:
    • macOS/Linux: ~/.config/claude-code/mcp.json
    • Windows: %APPDATA%\claude-code\mcp.json

Adicionando o JSON de configuração

Adicione o seguinte JSON de configuração.

info

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

{
  "mcpServers": {
    "axe-mcp-server": {
      "type": "stdio",
      "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_SERVER_URL": "https://axe.deque.com",
        "AXE_API_KEY": "${AXE_API_KEY}"
      }
    }
  }
}
note

A configuração utiliza "AXE_API_KEY": "${AXE_API_KEY}" para manejo seguro de entrada. A sintaxe de ${AXE_API_KEY} instrui o Claude Code a obter o valor do seu ambiente de shell. Para mais informações, consulte a documentação do Claude Code MCP.

note

Usando uma instância regional, nuvem privada ou axe local? Atualize o valor AXE_SERVER_URL no bloco env com a URL base da sua instância:

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

Se omitido, o servidor padrão é https://axe.deque.com (a instância SaaS compartilhada dos EUA da Deque). Veja Opções de Configuração para detalhes.

Defina sua chave de API

Defina sua chave de API como uma variável de ambiente no seu shell:

export AXE_API_KEY="your-api-key-here"

Para configuração permanente, adicione esta linha ao seu perfil de shell (~/.bashrc, ~/.zshrc, etc.).

Uso e verificação

Uma vez configurado, reinicie o Claude Code para carregar o servidor MCP.

  1. Inicie o Claude Code a partir do seu terminal: claude
  2. Digite /mcp para gerenciar conexões do servidor MCP
  3. Você deve ver axe-mcp-server listado com as ferramentas analyze e remediate disponíveis

Configurando o Claude Code (recomendado)

Para garantir que o Claude Code use corretamente as ferramentas do servidor Axe MCP, adicione as seguintes instruções a um arquivo CLAUDE.md no raiz do seu projeto. Isso instrui o Claude a seguir o fluxo de trabalho de analisar e depois remediar corretamente.

# Accessibility Testing and Remediation Workflow

## MANDATORY WORKFLOW - DO NOT DEVIATE

When working with accessibility issues, you MUST follow this exact workflow:

### 1. Analysis Phase

When asked to analyze pages for accessibility issues, you MUST:

- Use the `analyze` tool to scan the page
- Do NOT manually identify accessibility issues
- Always provide the complete URL being analyzed

### 2. Remediation Phase

When asked to remediate or fix accessibility issues, you MUST:

- First use `remediate` tool for EACH violation found
- Provide the exact HTML element, rule ID, and issue description
- Review the remediation guidance before making any code changes
- Apply fixes based on the remediate tool's recommendations
- Do NOT manually fix accessibility issues without first using the remediate tool

### 3. Verification Phase

After applying fixes, you MUST:

- Re-run `analyze` to verify all issues are resolved
- Confirm zero violations before considering the task complete

Para mais detalhes sobre as instruções do agente, consulte Configurando Seu Agente de IA.

Is this page helpful?

Help us improve this page

Still need help?