IA by DNACX

#4 no GitHub · Navegador e apps

Como instalar e usar o Playwright MCP

Um servidor MCP que deixa a IA controlar um navegador: abrir páginas, clicar e preencher campos. Ele faz isso lendo a estrutura da página (a árvore de acessibilidade), sem depender de capturas de tela.

Para quem
Quem quer que o Claude Code navegue em sites e execute tarefas no navegador, como explorar uma página ou automatizar um fluxo.
Estrelas (07/11/2026)
39.302, #4 no ranking
Licença
Apache 2.0
Repositório
microsoft/playwright-mcp

Passo a passo

Antes de começar: Node.js 18 ou mais novo; Um cliente MCP compatível. O README cita VS Code, Cursor, Windsurf, Claude Desktop, Goose, Grok, Junie ou qualquer outro cliente MCP, e traz uma seção própria para o Claude Code.

  1. Confira a versão do Node

    O comando de instalação usa o npx, que vem com o Node. O README pede Node.js 18 ou mais novo.

  2. Adicione o servidor ao Claude Code

    Abra o terminal, cole o comando e aperte Enter. Ele registra o servidor com o nome playwright.

    Comando
    claude mcp add playwright npx @playwright/mcp@latest

  3. Entenda onde ficam os logins

    Por padrão o navegador usa um perfil persistente, como um navegador comum. Tudo em que você entrar fica guardado nesse perfil, e o README diz que dá para apagá-lo entre sessões para limpar o estado.

  4. Se preferir, use o modo isolado

    No modo isolado o perfil do navegador fica só na memória e nada é salvo no disco. A opção se chama --isolated e entra na lista de argumentos do servidor.

  5. Para usar o seu navegador já aberto, use a extensão

    O README descreve uma extensão do Chrome que conecta o servidor a abas existentes e aos seus logins. A instalação da extensão é explicada em outra página do repositório da Playwright.

  6. Leia o aviso de segurança antes de usar

    O README avisa que o servidor não é uma barreira de segurança e manda ler as boas práticas de segurança de MCP. Use com isso em mente, principalmente em sites onde você está logado.

Primeiro teste

O README não traz um pedido de teste. Peça uma tarefa simples e confira se o servidor entra em ação.

Cuidados

  • O README diz que o Playwright MCP não é uma barreira de segurança e remete às boas práticas de segurança do MCP.
  • O perfil padrão é persistente: logins e dados de navegação ficam guardados no computador, em uma pasta de cache que o README lista para Windows, macOS e Linux.
  • As opções de origens permitidas e bloqueadas (--allowed-origins e --blocked-origins) trazem o aviso de que não servem como barreira de segurança e não afetam redirecionamentos.
  • Por padrão o acesso a arquivos é restrito à pasta de trabalho, e a opção --allow-unrestricted-file-access libera arquivos fora dela e URLs file://.
  • O README sugere que, para agentes de código, o Playwright CLI com SKILLS pode ser melhor, porque as chamadas gastam menos tokens do que o MCP, que carrega esquemas de ferramentas grandes e árvores de acessibilidade extensas no contexto. O MCP segue indicado para tarefas exploratórias e de longa duração em que manter o contexto do navegador pesa mais que o custo em tokens.
  • O README diz que a implementação em Docker só suporta o Chromium sem janela (headless) por enquanto.

Como desfazer

O README não traz um passo de remoção do servidor no Claude Code. Ele só diz que o perfil persistente pode ser apagado entre sessões para limpar o estado salvo.

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README não traz um pedido de teste pronto para colar no Claude Code.
  • O README não explica, no trecho lido, como baixar o navegador que o Playwright usa caso ele não esteja instalado.
  • Não está confirmado se o comando funciona igual em Windows, macOS e Linux.
  • O README não informa custo: o servidor aparece como pacote para rodar com o npx.

Dúvidas

Preciso de captura de tela ou de um modelo de visão?

Não. O README diz que o servidor usa a árvore de acessibilidade da página, sem entrada baseada em pixels, e que não precisa de modelos de visão.

O navegador aparece na tela?

Por padrão sim. O README diz que o navegador roda com janela, e que a opção --headless executa sem janela.

Posso usar em vários projetos ao mesmo tempo?

O perfil persistente só pode ser usado por uma instância por vez. O README manda iniciar cada cliente extra com --isolated ou apontar para outra pasta com --user-data-dir.

Qual a diferença para o Playwright CLI?

O README diz que o CLI com SKILLS é mais econômico em tokens e melhor para agentes de código, enquanto o MCP serve a tarefas que precisam de estado persistente e contexto contínuo do navegador.

A DNACX usa o Playwright MCP?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próximo da lista

← #3 Codebase Memory · #5 GitHub MCP Server →

Ver os 15 MCPs

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de microsoft/playwright-mcp, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.