Antes de começar
- Claude Code ou cliente MCP compatível
- Node.js 20 ou mais recente, conforme a documentação do Playwright MCP
- Site local ou ambiente de teste com formulário
- Dados fictícios e destino de teste para os envios
Escreva o que o formulário deve fazer
Anote os campos obrigatórios, a mensagem de sucesso e o destino do cadastro. Defina também o que deve acontecer quando o e-mail está vazio ou inválido.
Exemplo de critérios: e-mail obrigatório, telefone opcional, botão acessível por teclado e nenhuma mensagem de sucesso antes da confirmação do servidor. Esses critérios serão a base da revisão.
Conecte o Playwright MCP
No terminal, adicione o servidor ao Claude Code com o comando abaixo. Em outros clientes, use a configuração equivalente da documentação oficial. Abra uma sessão e confira se as ferramentas do navegador estão disponíveis.
Inicie seu site pelo comando próprio do projeto e copie a URL local. Não presuma que todos os projetos usam a mesma porta.
claude mcp add playwright npx @playwright/mcp@latestPeça uma inspeção sem envio
Envie a URL e os critérios ao agente. Peça para abrir a página, identificar o formulário e verificar rótulos, campos obrigatórios, foco e botão de fechar, caso exista um modal.
Instrua o agente a registrar o estado observado antes de agir. Se houver login ou dados reais, use uma conta de teste. A conexão com um navegador não torna toda ação apropriada para produção.
Confira o caminho de erro
Peça tentativas com e-mail vazio e inválido. O resultado esperado é uma mensagem clara, sem cadastro e sem perder os campos que o usuário já preencheu.
Depois simule a indisponibilidade do envio apenas no ambiente de teste, com apoio de quem mantém o formulário. Confira se a página oferece uma tentativa posterior em vez de anunciar sucesso. Se não houver como simular, marque esse caso como não verificado.
Confira uma tela pequena e um envio de teste
Peça uma janela estreita, como 390 pixels de largura, e repita a navegação. Verifique rolagem horizontal, campos escondidos e controles cobertos pelo modal. O Playwright permite emulação; isso ajuda, mas não reproduz todos os comportamentos de um aparelho real.
Autorize um único envio com dados fictícios no destino de teste e confira se o registro chegou. Uma tela de obrigado sozinha não prova a captura.
Transforme achados em correções verificáveis
Peça um relatório com situação, passos para reproduzir, esperado, observado e captura de tela. Priorize o que impede o cadastro ou mostra um resultado incorreto.
Depois da correção, repita o cenário que falhou e um envio válido. Para fluxos recorrentes, peça um teste automatizado persistente no projeto; a exploração pelo MCP não salva automaticamente uma suíte de testes.
O que você terá ao final
Uma revisão do formulário com evidências, casos não verificados explícitos e critérios para confirmar as correções.
Vale conferir
- Evite envios de teste para listas reais ou automações de marketing.
- Emulação de tela não substitui totalmente o teste em um celular.
- Tutorial baseado na documentação; os comandos e cenários não foram executados pela Agentspedia neste exemplo.