O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Conectar seu agente de IA ao navegador pessoal com conexão automática

Matthias Rohmer

José Luis Zapata

Conecte seu agente de IA diretamente à instância ativa do navegador com o recurso de conexão automática. Isso permite que o agente ignore as limitações do sandbox herdando suas guias, extensões do navegador e estado do aplicativo ativos.

Ao herdar o contexto do fluxo de trabalho, o agente pode passar da programação de código para a depuração do estado do navegador ativo sem perder os dados da sessão. Isso é útil quando você já atingiu um estado específico do aplicativo (como um processo de finalização da compra complexo ou um erro reproduzido manualmente) e quer que o agente assuma a investigação técnica sem executar essas etapas manualmente de novo.

Considere o seguinte antes de ativar a conexão automática:

Segurança e privacidade:quando a conexão automática está ativa, o agente tem acesso a todos os dados no seu perfil do navegador, incluindo guias abertas, armazenamento de sessão, armazenamento local, cookies e outros dados disponibilizados pelas APIs JavaScript.
Garantia de privacidade de dados:o servidor do Chrome DevTools para agentes é um processo local e não envia seus dados de navegador, tokens de sessão ou telemetria ao Google.
Confiança e comandos:use esse modo apenas com agentes em que você confia e tenha cuidado com as informações incluídas nos comandos.

Pré-requisitos

Antes de usar o recurso de conexão automática, verifique se você tem o seguinte:

Chrome 144 ou mais recente: a conexão automática exige protocolos de depuração modernos encontrados nas versões atuais do Chrome.
Canal correto do Chrome: por padrão, seu agente se conecta ao Chrome Stable. Para usar o Canary ou o Beta, especifique o canal na sua configuração.
Depuração remota ativada: ative manualmente a ponte entre seu navegador e o agente.
Configuração correta: atualize a configuração do MCP para incluir a flag --autoConnect. Consulte Configuração para mais detalhes.

Configurar a conexão automática

Para configurar o recurso de conexão automática no servidor MCP, faça o seguinte:

No navegador Chrome em execução, acesse chrome://inspect/#remote-debugging e ative a depuração remota.

Atualize a configuração do MCP para incluir a flag --autoConnect:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
    }
  }
}

Peça ao agente para interagir com o app Chrome aberto. Quando o Chrome pedir permissão para permitir a sessão, clique em Permitir.

Agora, o agente usa o servidor MCP para interagir com o aplicativo Chrome em execução. Para mais informações sobre as opções de configuração, consulte o guia de configuração.

Casos de uso da conexão automática

Com a conexão automática, você pode usar ferramentas ou estados que não podem ser usados em sessões isoladas do Chrome. Por exemplo, em vez de pedir que o agente faça login, o que muitas vezes falha, você pode navegar até a página e fazer login. Em seguida, peça para o agente assumir.

As seções a seguir incluem alguns exemplos de casos de uso do recurso de conexão automática.

Depurar painéis autenticados

As ferramentas internas e os painéis particulares geralmente ficam atrás de camadas complexas de rede privada virtual (VPN) ou de logon único (SSO). Um navegador em sandbox geralmente exige um login que seu agente não pode ignorar. Com a conexão automática, seu agente herda sua sessão ativa.

Exemplo de comando:

I have my company's staging dashboard open in the next tab. Can you look at the
User Analytics chart, find the SVG element for the Friday data point, and tell
me why the tooltip isn't appearing on hover?

Exemplo de execução do agente:o agente identifica seu processo do Chrome atual, encontra a guia ativa e inspeciona a árvore de acessibilidade para localizar os elementos. Também é possível usar APIs JavaScript para avaliar conflitos específicos.

Corrigir a guia atual em tempo real

Evite reproduzir erros manualmente. Em vez de traduzir etapas de reprodução em um novo comando para um agente em sandbox, peça ao agente para corrigir o bug na página ativa em que você já o encontrou.