# Testa la tua web app in un browser vero

> Ricliccare gli stessi percorsi dopo ogni modifica è lento, e qualche bug sfugge comunque.

Questa configurazione è pensata per sviluppatori e QA engineer che ritestano gli stessi percorsi utente dopo ogni modifica. L'agente pilota un browser vero tramite il server Playwright MCP di Microsoft, segue il percorso che descrivi in linguaggio normale e segnala cosa non funziona. Ottieni un esito riuscito o fallito per ogni percorso, e issue GitHub con i passi per riprodurre tutto ciò che è rotto.

## Passaggi

1. **Aggiungi Playwright MCP**: Registra il server Playwright MCP in Claude Code o Cursor con il comando npx @playwright/mcp@latest. Al primo avvio potrebbe chiederti di installare un browser; segui il messaggio o esegui npx playwright install. Chiedi all'agente di aprire il tuo URL di staging e descrivere la pagina per verificare che tutto funzioni.
   Consiglio: Aggiungi l'opzione --headless se non ti serve vedere il browser.
2. **Descrivi il percorso**: Descrivi il percorso passo per passo in linguaggio normale: l'URL, l'account di test, cosa cliccare o scrivere e com'è un risultato corretto. L'agente legge la pagina tramite snapshot di accessibilità: etichette dei pulsanti e nomi dei campi chiari lo aiutano a trovare gli elementi giusti. Chiedigli di indicare per ogni passo se è riuscito o fallito, con il testo dell'errore o uno screenshot in caso di problemi.
   Consiglio: Scrivi il risultato atteso per ogni passo, altrimenti l'agente deve indovinare cosa significa «funziona».
3. **Segnala i fallimenti**: Collega il server MCP di GitHub con il permesso di creare issue nel tuo repository. Chiedi all'agente di aprire una issue per ogni fallimento con i passi per riprodurlo, il risultato atteso e quello ottenuto, il browser usato ed eventuali errori in console. Rivedi ogni issue prima di approvarne la creazione.
   Consiglio: Chiedi all'agente di trasformare un percorso che si rompe spesso in un file di test Playwright da eseguire nella tua CI.

## Prompt da provare

- Apri https://staging.example.com, registrati con una nuova email di test, verifica di arrivare alla dashboard e riferisci su ogni passo.
- Accedi come test-buyer@example.com, aggiungi due articoli al carrello, applica il codice TEST10 e verifica che il totale si aggiorni. Segnala tutto ciò che non funziona.
- Compila il modulo di contatto con un'email non valida e verifica che il messaggio di errore compaia accanto al campo.
- Ripeti il percorso di pagamento con una finestra larga 375 px e dimmi cosa si rompe su mobile.
- Per ogni fallimento, apri una issue GitHub in acme/web con i passi per riprodurlo e gli errori in console.

## Cosa ti serve

- Node.js installato in locale
- Claude Code o Cursor
- Ambiente di staging e account di test
- Accesso al repository GitHub per creare issue

## Limiti

- L'agente può fraintendere pagine complesse o con etichette poco chiare e cliccare l'elemento sbagliato.
- Le esecuzioni esplorative sono più lente e meno riproducibili di una suite di test scriptata.
- CAPTCHA, richieste di autenticazione a due fattori e passaggi di verifica via email di solito richiedono un intervento manuale.

## Note di sicurezza

- Eseguilo sullo staging, non in produzione.
- Usa account di test, mai le credenziali di clienti reali.

## Server MCP

- [Playwright MCP Server](https://github.com/microsoft/playwright-mcp): browser-control
- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write

## Domande frequenti

**Sostituisce la mia suite di test Playwright?**

No. L'agente esplora i percorsi partendo da istruzioni in linguaggio normale, utile per controlli rapidi e nuove funzionalità. Per i controlli che devono girare a ogni commit, chiedigli di scrivere un file di test Playwright ed eseguilo nella tua CI.

**Quali browser può usare?**

Playwright MCP usa Chromium di default e si può configurare per usare Firefox, WebKit o un Chrome o Edge installato. Scegli il browser nelle opzioni da riga di comando del server.

**Si può usare senza rischi in produzione?**

Usalo sullo staging con account di test. L'agente clicca davvero i pulsanti e invia davvero i moduli: in produzione potrebbe effettuare ordini o mandare email.

**È a pagamento?**

Playwright e il suo server MCP sono gratuiti e open source. Paghi solo l'uso del tuo host IA, come Claude Code o Cursor.

## Strumenti

- **[GitHub](https://suiteintent.com/t/github?m=IT)**: Hosting di codice, issue e pull request. · Ideale per: Team che revisionano il codice con pull request · Piano gratuito · 10000