Chrome DevTools MCP

Quickstart

npm i chrome-devtools-mcp . { "mcpServers" : { "chrome-devtools" : { "command" : "npx" , "args" : [ "-y" , "chrome-devtools-mcp@latest" ] } } } Instalar em outros agentes Para configurar um agente que não está listado, consulte o repositório do GitHub do Chrome DevTools MCP . Testar sua configuração Insira o seguinte prompt no agente para verificar se tudo está funcionando: Check the performance of https://developers.chrome.com O agente vai abrir uma janela do navegador e gravar um rastro de desempenho. Resolver problemas de configuração Se o agente não conseguir executar ferramentas e tiver acesso às habilidades do Chrome DevTools, ele poderá tentar corrigir o problema automaticamente. Se isso não acontecer, você poderá solicitar explicitamente o agente: Use the Chrome DevTools troubleshooting skill to fix my setup. Ou você pode ser mais específico: I'm having trouble with Chrome DevTools for agents. I tried to run [Tool Name] but got the error: [Error Message]. I am on [OS Name]. Use the Chrome DevTools troubleshooting skill to fix my setup. Configuração avançada Estas são outras maneiras de o agente acessar o navegador. Configurar o modo headless Se você quiser realizar tarefas em segundo plano sem uma janela de navegador visível, execute o Chrome no modo headless (sem interface). Adicione a flag --headless aos argumentos do servidor: { "mcpServers" : { "chrome-devtools" : { "command" : "npx" , "args" : [ "-y" , "chrome-devtools-mcp@latest" , "--headless" ] } } } Conectar-se a uma sessão de navegador existente 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 existente usando a flag --autoConnect . Isso é particularmente útil se o agente precisar investigar um problema que está bloqueado por um login ou uma sessão que você já iniciou. Aviso: ao usar a conexão automática, o agente herda sua sessão ativa, incluindo contas conectadas, cookies e outros dados exibidos pelas APIs JavaScript. Isso pode expor informações de identificação pessoal (PII) ao agente. Use esse modo apenas com agentes confiáveis e tenha cuidado com os prompts. Há duas maneiras de se conectar a uma sessão existente: Usar a conexão automática (Chrome 144 ou mais recente) Quando o servidor MCP do Chrome DevTools é configurado com a opção --autoConnect , o servidor MCP se conecta a uma instância ativa do Chrome e solicita uma sessão de depuração remota. No navegador Chrome em execução, acesse chrome://inspect/#remote-debugging para ativar 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" ] } } } Emita um prompt para o agente. O Chrome vai mostrar uma caixa de diálogo pedindo permissão do usuário para permitir a sessão de depuração remota. Clique em Permitir . Conectar manualmente usando a porta de depuração remota Se você não puder usar --autoConnect (por exemplo, se executar o agente em um ambiente de sandbox), poderá iniciar o Chrome manualmente com uma porta de depuração. Confira um exemplo (no macOS): Inicie o navegador Chrome com a porta de depuração remota ativada. Por motivos de segurança, você também precisa especificar um diretório de dados do usuário personalizado. /Applications/Google \ Chrome.app/Contents/MacOS/Google \ Chrome --remote-debugging-port = 9222 --user-data-dir = /tmp/chrome-profile-stable Configure o agente para se conectar usando o parâmetro --browser-url : { "mcpServers" : { "chrome-devtools" : { "command" : "npx" , "args" : [ "chrome-devtools-mcp@latest" , "--browser-url=http://127.0.0.1:9222" ] } } } Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons , e as amostras de código são licenciadas de acordo com a Licença Apache 2.0 . Para mais detalhes, consulte as políticas do site do Google Developers . Java é uma marca registrada da Oracle e/ou afiliadas. Última atualização 2026-05-13 UTC. [[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2026-05-13 UTC."],[],[]] Contribuir Registre um bug Veja as questões em aberto Conteúdo relacionado Atualizações do Chromium Estudos de caso Arquivar Podcasts e programas Seguir @ChromiumDev no X YouTube Chrome for Developers no LinkedIn RSS Termos de Serviço Privacidade Manage cookies English Deutsch Español – América Latina Français Indonesia Italiano Nederlands Polski Português – Brasil Tiếng Việt Türkçe Русский עברית العربيّة فارسی हिंदी বাংলা ภาษาไทย 中文 – 简体 中文 – 繁體 日本語 한국어

Compare alternatives