# Fai rivedere le tue pull request a Claude

> Le review restano in attesa per giorni e i piccoli problemi passano quando tutti sono occupati.

Questo setup è pensato per i piccoli team tecnici le cui pull request aspettano un revisore. Claude legge il diff tramite il server MCP di GitHub, lo confronta con le vostre convenzioni e con il ticket Linear collegato, poi lascia commenti di review. Ogni PR riceve una prima review e i revisori umani possono concentrarsi su design e intenzioni.

## Passaggi

1. **Crea un token GitHub fine-grained**: In GitHub vai su Settings > Developer settings > Fine-grained tokens e crea un token limitato ai repository da rivedere. Dagli accesso in lettura ai contenuti e in lettura e scrittura alle pull request, così Claude può commentare. Imposta una data di scadenza e annotala da qualche parte.
   Consiglio: Una scadenza a 90 giorni è un buon compromesso tra sicurezza e frequenza di rinnovo.
2. **Aggiungi il server MCP di GitHub**: In Claude Code esegui claude mcp add con il server MCP ufficiale di GitHub, quello remoto o l'immagine Docker locale, e passagli il token. In Cursor aggiungi lo stesso server in Settings > MCP. Chiedi all'agente di elencare le PR aperte di un repository per confermare il collegamento.
   Consiglio: Se la lista torna vuota, controlla che il token includa davvero quel repository.
3. **Dagli la tua checklist di review**: Scrivi le tue regole di review in CLAUDE.md, in una regola di Cursor o in un breve prompt riutilizzabile: nomi, gestione degli errori, aspettative sui test, cosa ignorare. Aggiungi esempi di commenti che trovi utili e altri che consideri rumore. Così Claude indicherà righe precise invece di dare consigli generici.
   Consiglio: Digli di ignorare i problemi di stile che il tuo linter rileva già.
4. **Collega il ticket**: Aggiungi il server MCP remoto di Linear e autorizzalo tramite OAuth. Quando una PR cita l'ID di un ticket, chiedi a Claude di leggere il ticket e di verificare la modifica rispetto ai criteri di accettazione. Un criterio mancante diventa un commento di review invece di una sorpresa dopo il merge.
   Consiglio: Metti l'ID del ticket Linear nel nome del branch o nel titolo della PR, così Claude lo trova.

## Prompt da provare

- Rivedi la PR 142 in acme/web con la nostra checklist e lascia commenti in linea su tutto quello che non la rispetta.
- Leggi il ticket Linear collegato alla PR 142 e dimmi quali criteri di accettazione il diff non copre.
- Elenca le pull request aperte in acme/api senza review da più di due giorni.
- Riassumi in tre punti cosa cambia la PR 87 per le note di rilascio.
- Controlla se mancano test per le nuove funzioni della PR 142 e proponi dei casi di test.

## Cosa ti serve

- Un account GitHub con accesso ai repository
- Un personal access token fine-grained
- Claude Code o Cursor
- Un workspace Linear se vuoi controllare i criteri di accettazione

## Limiti

- Claude rivede il diff e i file che legge; non esegue la tua applicazione e può quindi perdere problemi di runtime o di integrazione.
- Le PR molto grandi potrebbero non entrare in una sola passata: dividile o chiedi una review per cartella.
- La qualità della review dipende da quanto descrivi chiaramente le tue convenzioni.

## Note di sicurezza

- Non concedere mai permessi di merge o di amministrazione.
- Mantieni un'approvazione umana su ogni merge.

## Server MCP

- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write
- [Linear MCP Server](https://linear.app/docs/mcp): issue-read, issue-write, project-read

## Domande frequenti

**Claude approva o fa il merge delle pull request?**

Può fare solo ciò che il token consente e che approvi tu. Lascia le decisioni di merge alle persone: usa Claude per commenti e riepiloghi e lascia le approvazioni ai revisori umani.

**Serve un piano GitHub a pagamento?**

No. I token fine-grained e il server MCP di GitHub funzionano con gli account gratuiti. Ti serve invece un piano Claude che includa Claude Code, o un piano Cursor, per far girare l'agente.

**Vedrà i repository privati?**

Solo i repository privati che selezioni quando crei il token. Il codice di quei repository viene inviato al fornitore del modello come parte della conversazione: controlla prima la policy della tua azienda.

**Può girare in automatico su ogni PR?**

Questo setup è interattivo: sei tu a chiedere la review. Per review automatiche su ogni PR, guarda Claude Code in GitHub Actions, che è un setup separato.

## 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
- **[Linear](https://suiteintent.com/t/linear?m=IT)**: Issue tracker veloce, pensato per la tastiera. · Ideale per: Startup che pianificano a cicli · Piano gratuito · Gratis per startup