Playwright MCP: conclua a primeira navegação do navegador no cliente

Para quem é

Este guia é para quem já usa um cliente MCP e está pronto para abrir um navegador nesta máquina e automatizar páginas. O que você precisa decidir é se deve conectar o Playwright MCP ao cliente atual agora, não se deve ler primeiro uma introdução longa. O pré-requisito mais rígido é Node.js 18 ou mais recente nesta máquina; se a versão for insuficiente, não continue escrevendo a configuração. O repositório descreve-o como um servidor MCP que oferece automação de navegador e entende as páginas por instantâneos de acessibilidade, não por capturas de tela. Você precisa aceitar duas coisas: nesta máquina aparecerão processos relacionados ao navegador, e haverá visitas reais aos endereços que você indicar. Se você só quer explorar o repositório e não pretende que o cliente execute nenhuma ação de navegador, este caminho não serve. As evidências não indicam setor, cargo nem tamanho de equipe, e aqui também não se inventam perfis de usuário.

Primeira tentativa em 3 minutos

Use apenas o caminho oficial de configuração MCP padrão. Abra o local de configuração de servidores do cliente MCP que você já está usando — as evidências não dão um nome de arquivo específico, então use a entrada de configurações MCP desse cliente — e adicione um serviço chamado playwright, com comando npx e argumento @playwright/mcp@latest. Não coloque ao lado um segundo método principal de instalação.

Confirme primeiro que a máquina atende a Node.js 18 ou mais recente e, em seguida, grave o JSON abaixo na configuração exatamente como está, idêntico byte a byte, sem alterar nomes de chaves nem espaços:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

Salve e depois reinicie ou recarregue esse cliente. O sinal de sucesso é os nomes browser_navigate e browser_navigate_back aparecerem na lista de ferramentas. A conexão só conta quando esses nomes ficam expostos; não trate a janela do navegador abrindo ou uma página carregando como instalação concluída.

Depois de conectado, faça só uma chamada exploratória: use browser_navigate. As evidências registram apenas o nome da ferramenta — sem tabela de parâmetros, sem URL de exemplo e sem caminho de desfazer — então o que você preencher deve seguir a descrição da ferramenta que o cliente mostrar naquele momento. Não invente parâmetros nem endpoints. Esta chamada fará o navegador local visitar o endereço que você indicar, produzir requisições de rede e carregamento de página, e deixar processos relacionados ao navegador na máquina. Não é uma operação somente leitura e não é risco zero. Antes da chamada, você deve confirmar que o endereço foi indicado por você e que esse endereço pode aceitar ser visitado. Depois da chamada, o ponto de confirmação é se esta chamada retorna. Se em seguida você usar browser_navigate_back, isso também mudará a página atual do navegador e poderá gerar outra requisição de rede. Antes dessa chamada, confirme que a sessão atual já tem histórico de navegação para o qual voltar.

Casos de uso

Caso 1: use browser_navigate para abrir uma página que você indicou explicitamente. O momento é quando os dois nomes de ferramenta já apareceram e você tem um endereço que pode aceitar ser visitado. O único mapeamento possível nas evidências é este nome de ferramenta; não há URL de demonstração nem campos de parâmetros escritos. O efeito colateral é navegação real e acesso de rede. Confira o endereço de novo antes da chamada e, depois, veja se esta chamada terminou. Não interprete isso como uma prévia local offline e não assuma que o conteúdo da página não será lido.

Caso 2: use browser_navigate_back para voltar à página anterior. O momento é quando uma navegação acabou de ser concluída na mesma sessão de navegação. As evidências de novo dão só este nome de ferramenta — sem API de lista de histórico e sem caminho de reverter ou undo. Se ainda não houve navegação para frente bem-sucedida, o retorno pode falhar ou cair numa página que você não esperava; as evidências não descrevem o estado após a falha. Esta chamada também mudará a página atual e pode pedir rede de novo. Antes da chamada, confirme que você de fato navegou; o ponto de confirmação continua sendo se esta chamada retorna.

Limites de uso

O piso de execução é Node.js 18 ou mais recente; não force uma versão inferior. A capacidade para na automação de navegador, e a descrição usa instantâneos de acessibilidade em vez de capturas. Nas evidências não aparecem ferramentas do tipo captura, nem comandos para fechar o navegador, limpar a sessão, desinstalar ou undo. Não assuma que não há rede, que não há leitura local ou que não há fronteira de privacidade: ao navegar, o site de destino será visitado, o conteúdo da página pode entrar no contexto do cliente e processos de navegador aparecerão na máquina. Se a primeira tentativa falhar, confira primeiro a versão do Node e se o JSON coincide byte a byte com o fragmento oficial, depois veja se os dois nomes de ferramenta apareceram. Não mude para um método de instalação que não aparece nas evidências. Não trate como já suportadas capacidades que as evidências não nomeiam.