Configuração

Matthias Rohmer

José Luis Zapata

É possível configurar o Chrome DevTools para agentes para personalizar como ele interage com o navegador, quais ferramentas estão ativadas e como ele processa os dados.

Configure o servidor transmitindo flags de linha de comando na matriz args do arquivo de configuração do cliente do Protocolo de Contexto de Modelo (MCP). Normalmente, é o arquivo config.json.

Por exemplo, para executar o Chrome no modo headless e usar o canal Canary, use a seguinte configuração:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless",
        "--channel=canary"
      ]
    }
  }
}

Cenários comuns de configuração

Os cenários a seguir descrevem maneiras comuns de configurar o Chrome DevTools para agentes.

Executar no modo headless

Para realizar tarefas em segundo plano sem uma janela visível do navegador, execute o Chrome no modo headless (sem interface). Adicione a flag --headless aos argumentos do servidor.

Conectar-se a uma sessão do navegador atual

Por padrão, o DevTools para agentes inicia uma nova instância do Chrome. No entanto, é possível conectar o agente a uma sessão de navegador atual. Isso é útil se o agente precisar investigar um problema em uma sessão que você já iniciou (por exemplo, se você já tiver feito login).

É possível se conectar a uma sessão de duas maneiras:

Conexão automática (Chrome 144 ou mais recente)

Se você usar a flag --autoConnect, o servidor MCP vai se conectar automaticamente a uma instância ativa do Chrome.

1. No navegador Chrome em execução, acesse chrome://inspect/#remote-debugging e ative a Depuração remota.
2. Adicione --autoConnect à configuração do MCP: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Quando o agente tenta se conectar, o Chrome mostra uma caixa de diálogo pedindo permissão. Clique em Permitir.

Conexão manual

Se não for possível usar --autoConnect (por exemplo, em um ambiente isolado), inicie o Chrome manualmente com uma porta de depuração e conecte usando --browser-url.

1. Inicie o Chrome no terminal com a depuração remota ativada e um diretório de dados do usuário personalizado.
   • macOS: shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
   • Windows: shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable
   • Linux: shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
2. Configure o agente para se conectar a esta porta: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Permitir acesso a arquivos fora do diretório temporário

As ferramentas que leem ou gravam arquivos (por exemplo, salvando capturas de tela, traces ou carregando extensões) só podem acessar caminhos dentro das raízes do espaço de trabalho configurado. O servidor usa as raízes fornecidas pelo cliente MCP com a capacidade de raízes do MCP, além de todos os diretórios transmitidos com --filesystemRoot (alias --workspace). Se o cliente não fornecer raízes e você não definir --filesystemRoot, o acesso a arquivos será limitado ao diretório temporário do SO. As solicitações para outros caminhos falham com um erro Access denied: ... is not within any of the configured workspace roots.

Para permitir o acesso a um diretório de projeto, adicione --filesystemRoot aos argumentos do servidor. É possível repetir a flag para permitir vários diretórios:

"args": ["chrome-devtools-mcp@latest", "--filesystemRoot=/path/to/project"]

Referência de opções de configuração

As seções a seguir listam as flags de configuração disponíveis. Para ver as opções e atualizações mais recentes, consulte o repositório do GitHub do MCP do Chrome DevTools.

Opções de conexão

Use essas opções para configurar como o servidor se conecta ao Chrome.

Opções de inicialização do navegador

Essas opções se aplicam quando o servidor MCP inicia o Chrome.

Opções de segurança e privacidade

Use essas opções para gerenciar as configurações de segurança e a privacidade dos dados.

Categorias de recursos

É possível ativar ou desativar grupos de ferramentas usando essas flags.

Opções de captura de tela

Use essas opções para personalizar como o agente faz capturas de tela.

Opções experimentais

Use essas opções para ativar recursos experimentais que estão em desenvolvimento.

Outras opções

Use essas opções para configurar o registro, o roteamento de páginas e os mapas de origem ou para ativar um conjunto simplificado de ferramentas.

Variáveis de ambiente

Você também pode usar as seguintes variáveis de ambiente para configurar o servidor:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: se definido, desativa a coleta de estatísticas de uso (equivalente a --no-usage-statistics).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: se definido, desativa as verificações periódicas de atualizações.
• CI: se definido, desativa a coleta de estatísticas de uso.
• NODE_DEBUG: defina como * para ativar o registro detalhado de depuração (funciona em conjunto com --logFile).