Sempre tive uma base teórica sobre conceitos de qualidade de software, mas nunca tive uma vivência prática de QA no dia a dia. Testes automatizados sempre pareceram um mundo à parte, com sintaxe própria e uma curva de aprendizado que eu nunca priorizei o suficiente para encarar. Foi aí que esbarrei no Playwright MCP integrado ao Claude Code: em vez de dominar a escrita de scripts de automação, passei a simplesmente descrever o teste em linguagem natural.

O que é um MCP

MCP significa "Model Context Protocol". É uma forma padronizada de dar à IA "mãos e olhos" para executar tarefas no mundo real. Sozinha, a IA só gera respostas em texto. Com um MCP, ela se conecta a ferramentas reais — pode abrir programas, acessar sites, manipular arquivos ou controlar um navegador. E é possível habilitar apenas as capacidades que fizerem sentido para cada contexto.

O que é o Playwright

Playwright é uma ferramenta open source mantida pela Microsoft, criada para automatizar tarefas de teste web: abrir navegadores, clicar em botões, preencher formulários, navegar entre páginas e verificar funcionalidades. Foi lançado publicamente em janeiro de 2020, evoluindo do trabalho que engenheiros já haviam feito anteriormente no Puppeteer, do Google. Ele se comunica via WebSockets em vez do HTTP tradicional, suporta testes em paralelo nos três principais motores de navegador (Chromium, Firefox e WebKit) e está entre os frameworks de teste mais usados do mercado, ao lado de Cypress e Selenium.

Tradicionalmente, usar o Playwright exige escrever scripts de código. Integrado ao Claude via MCP, o fluxo muda: você descreve o teste desejado em linguagem natural, e a IA traduz isso em ações reais no navegador.

A conexão com o TDD

TDD (Test-Driven Development) propõe, em teoria, escrever os testes antes do código de implementação. Na prática, sempre senti que a barreira de entrada — escrever a automação do teste — era o que me impedia de praticar TDD de verdade. O Playwright MCP reduz bastante esse atrito, já que descrever o teste em linguagem natural é muito mais rápido. Mas ele não substitui a disciplina e o levantamento estruturado de requisitos que o TDD exige.

Vale um alerta importante: sem uma análise de requisitos adequada, sem critérios de aceite bem definidos e sem mapear os cenários, os testes até rodam, mas não validam de fato o que importa. Um teste mal estruturado apenas transfere o esforço para etapas posteriores e aumenta o consumo de tokens com correções sucessivas.

Instalação

1. Node.js

Verifique se já está instalado:

node --version

É necessária a versão 18 ou superior. Se não tiver, baixe em nodejs.org.

2. Instalar o Playwright MCP

Com o Claude Code já instalado, execute:

claude mcp add playwright npx @playwright/mcp@latest

Isso registra o Playwright para que o Claude Code passe a reconhecê-lo.

3. Instalar dependências (apenas Linux)

npx playwright install-deps

Instala componentes adicionais de navegador. Em Windows e Mac, esse passo normalmente é dispensável.

4. Verificar a instalação

Dentro do Claude Code, digite:

/mcp

Se "playwright" aparecer com status conectado, a configuração está completa.

Exemplos de uso

Depois de configurado, basta descrever o objetivo do teste em linguagem natural, sem escrever código:

• Verificação de funcionalidade: "Abra localhost:3000, faça login com test@empresa.com / 123456, confirme que o dashboard aparece após o login."
• Teste de fluxo de compra: "Acesse a página de checkout, adicione um produto ao carrinho, preencha os dados de entrega, verifique se o botão de finalizar compra está habilitado."
• Reprodução de bug: "Vá em /configurações, clique no toggle de notificações para desativar o e-mail, recarregue a página, confirme que a preferência persistiu."

O navegador abre visivelmente, executa cada ação descrita e, ao final, reporta sucesso ou falha. Os testes ainda podem ser salvos para reuso futuro, sem precisar descrevê-los de novo.

Impacto na prática

Não vejo o Playwright MCP como substituto de quem domina testes e automação de verdade — esse conhecimento especializado continua essencial. Mas para quem tem a base teórica e quer colocar a mão na massa sem virar especialista em Playwright da noite para o dia, essa integração encurtou bastante a distância entre entender "o que deveria ser testado" e efetivamente executar uma validação completa.

Consegui validar fluxos inteiros da aplicação usando apenas descrições de comportamento, sem esbarrar na sintaxe do framework. E pedir para o agente gerar o código de teste correspondente virou um aprendizado prático complementando o que eu já sabia na teoria.

Recomendação

Para quem tem afinidade com qualidade de software mas ainda não teve a vivência prática de automação, vale a experimentação. A instalação leva minutos, e o benefício prático aparece já nos primeiros testes.