Como configurar e testar Playwright MCP no Claude Code

Decida onde o servidor deve aparecer antes de usar claude mcp add. Escolha local para um teste privado em um projeto, project para uma configuração que sua equipe possa revisar e user para reutilizar o servidor nos seus projetos. Depois confirme a conexão e peça um resultado que possa ser conferido no navegador.

Uma pessoa no Reddit passou --isolated como opção do Claude e recebeu um erro de argumento desconhecido. A opção pertence ao Playwright e vai depois do separador. Mais adiante, o Tabbit Browser ilustra o caso de uma aba já autenticada. Discussão original

O que lembrar

• Comece na raiz do projeto. Os escopos local e project dependem do projeto, mas usam arquivos diferentes.

• Passe --scope e --transport antes de --. Passe --headless e --isolated ao comando do servidor.

• Uma entrada pode existir mesmo quando o executável não abre. Confira claude mcp list e depois as ferramentas na sessão.

• Valide com uma página pública e confirme o resultado na chamada da ferramenta.

• No primeiro teste, use o menor escopo necessário e um navegador com estado temporário.

Escolha o escopo

O padrão do Claude Code é local, limitado ao projeto atual. Em caso de nomes iguais, o cliente prefere local, depois project, depois user. Se o comando exibido não for o que você acabou de editar, procure uma entrada com prioridade maior. Escopos do Claude Code

O mesmo servidor Playwright MCP funciona em clientes diferentes, cada um com seu formato. A configuração do Codex usa TOML. O arquivo de projeto do Claude Code usa JSON.

Cadastre um servidor privado

Confirme que Claude Code e npx rodam no mesmo terminal. O guia do Playwright pede Node.js 20 ou mais recente. O exemplo fixa a versão testada e abre o navegador sem janela e com estado temporário. Instalação do Playwright MCP

claude --version
node --version
claude mcp add --scope local --transport stdio playwright -- npx -y @playwright/mcp@0.0.84 --headless --isolated
claude mcp list

O Claude lê as opções à esquerda de --. À direita, passa o comando e os argumentos ao servidor. Se vir unknown option '--headless', confira onde colocou a opção. Headless controla a janela, e isolated usa estado temporário. Sintaxe stdio da Anthropic

Compartilhe o mesmo comando com a equipe

Coloque uma entrada equivalente em .mcp.json na raiz ou use --scope project no cadastro. A equipe pode conferir qual programa será executado, revisar os argumentos e aprovar o servidor no Claude Code. Deixe segredos e caminhos privados fora do arquivo compartilhado. Início rápido do Claude Code

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@0.0.84", "--headless", "--isolated"]
    }
  }
}

Esse arquivo define o comando. A conta e as permissões dependem da sessão do navegador e das políticas da organização. Para um ambiente que exige login, prepare um perfil de teste autorizado. O guia de perfis, espaços de trabalho e abas explica o que cada camada mantém.

Verifique a conexão em uma página pública

Abra uma sessão nova no projeto. Encontre Playwright em /mcp. Dê uma tarefa de leitura e cite o servidor pelo nome para que o assistente use a conexão que você quer testar, em vez do terminal ou da busca na web.

Use Playwright MCP para abrir
https://www.selenium.dev/selenium/web/web-form.html.
Informe a URL final e o primeiro cabeçalho visível na saída da ferramenta.
Não preencha nem envie nada. Pare após ler.

O cabeçalho esperado é Web form. Se a navegação retornar apenas o caminho da captura, peça browser_snapshot. Confira ferramenta, endereço e cabeçalho antes de pedir um clique. O guia de navegadores com agentes explica como essa observação orienta a ação seguinte.

O teste usou Claude Code 2.1.318, Node.js 22 e Playwright MCP 0.0.84. Em um projeto temporário, Claude Code registrou os escopos e conferiu a conexão. Uma sonda de protocolo executou o comando exato do arquivo de projeto, descobriu browser_navigate e browser_snapshot e leu Web form. Nenhum formulário foi enviado e nenhum turno do modelo Claude foi iniciado.

A entrada local conectou no projeto. A entrada project aguardou aprovação e, em outro diretório, apareceu apenas a entrada user.

Investigue a primeira verificação que falhou

O teste cadastrou um nome com um executável inexistente. A entrada apareceu na configuração e a conexão falhou. Em outro teste, colocar --headless do lado das opções do Claude fez o comando falhar antes de abrir o navegador. Um caso pede revisar o executável. O outro pede corrigir a sintaxe.

Outra pessoa relatou que claude mcp list às vezes mostrava uma conexão que não aparecia no /mcp da sessão ativa. Confira os dois resultados antes de editar a configuração outra vez. Discussão original

A busca de ferramentas do Claude Code pode adiar definições de MCP até que sejam necessárias. Peça uma leitura específica na sessão nova e confira o nome da ferramenta no registro. Se houver uma negativa, identifique a permissão antes de alterar o servidor. Compare outras ferramentas de automação se a necessidade for diferente. Busca de ferramentas da Anthropic

Quando conectar uma aba existente

Uma sessão isolada é boa para repetir uma ação em página pública. Se o trabalho começa em um painel autenticado, defina a aba, a conta e o espaço que precisam ser compartilhados. Confira título e conta com uma leitura antes de mudar dados. O guia para conectar um navegador existente reúne essas verificações.

O Tabbit Browser tem outra forma de conexão para agentes compatíveis, entre eles Claude Code. Ela pode fazer sentido quando a aba necessária já está no Tabbit. O vídeo de um formulário de vendedor mostra o preenchimento e a confirmação na lista real, com outro agente de programação. Guia de início do Tabbit

Comece com local e uma página pública. Passe para project depois da revisão ou escolha user se precisar do servidor em vários projetos. Se o encargo exigir um login existente, use uma conexão autorizada à sessão. Mantenha uma evidência verificável a cada etapa da automação do navegador.

Secholar.L

Crescimento e conteúdo na Tabbit

Secholar.L escreve guias práticos sobre navegadores com IA e fluxos de trabalho com agentes, comparando ferramentas com pesquisa real e fontes verificáveis.