# Laissez Claude relire vos pull requests

> Les relectures attendent des jours, et les petits problèmes passent quand tout le monde est occupé.

Cette configuration s'adresse aux petites équipes techniques dont les pull requests attendent un relecteur. Claude lit le diff via le serveur MCP GitHub, le compare à vos conventions et au ticket Linear associé, puis laisse des commentaires de relecture. Chaque PR reçoit une première relecture, et les relecteurs humains peuvent se concentrer sur la conception et l'intention.

## Étapes

1. **Créer un jeton GitHub fine-grained**: Dans GitHub, allez dans Settings > Developer settings > Fine-grained tokens et créez un jeton limité aux dépôts à relire. Donnez-lui l'accès en lecture au contenu et en lecture et écriture aux pull requests pour que Claude puisse commenter. Fixez une date d'expiration et notez-la quelque part.
   Astuce: Une expiration à 90 jours est un bon équilibre entre sécurité et fréquence de renouvellement.
2. **Ajouter le serveur MCP GitHub**: Dans Claude Code, lancez claude mcp add avec le serveur MCP officiel de GitHub, soit le serveur distant, soit l'image Docker locale, et transmettez le jeton. Dans Cursor, ajoutez le même serveur sous Settings > MCP. Demandez à l'agent de lister les PR ouvertes d'un dépôt pour confirmer la connexion.
   Astuce: Si la liste revient vide, vérifiez que le jeton inclut bien ce dépôt.
3. **Lui donner votre checklist de relecture**: Écrivez vos règles de relecture dans CLAUDE.md, une règle Cursor ou un court prompt réutilisable : nommage, gestion des erreurs, attentes en matière de tests, ce qu'il faut ignorer. Ajoutez des exemples de commentaires que vous jugez utiles et d'autres que vous considérez comme du bruit. Claude pointera alors des lignes précises au lieu de donner des conseils génériques.
   Astuce: Dites-lui d'ignorer les problèmes de style que votre linter détecte déjà.
4. **Lier le ticket**: Ajoutez le serveur MCP distant de Linear et autorisez-le via OAuth. Quand une PR mentionne un identifiant de ticket, demandez à Claude de lire le ticket et de vérifier la modification par rapport à ses critères d'acceptation. Un critère manquant devient un commentaire de relecture plutôt qu'une surprise après le merge.
   Astuce: Mettez l'identifiant du ticket Linear dans le nom de branche ou le titre de la PR pour que Claude le trouve.

## Prompts à essayer

- Relis la PR 142 dans acme/web selon notre checklist et laisse des commentaires en ligne sur tout ce qui ne la respecte pas.
- Lis le ticket Linear lié à la PR 142 et dis-moi quels critères d'acceptation le diff ne couvre pas.
- Liste les pull requests ouvertes dans acme/api sans relecture depuis plus de deux jours.
- Résume en trois points ce que change la PR 87 pour les notes de version.
- Vérifie s'il manque des tests pour les nouvelles fonctions de la PR 142 et propose des cas de test.

## Ce qu'il vous faut

- Un compte GitHub ayant accès aux dépôts
- Un jeton d'accès personnel fine-grained
- Claude Code ou Cursor
- Un espace Linear si vous voulez vérifier les critères d'acceptation

## Limites

- Claude relit le diff et les fichiers qu'il lit ; il n'exécute pas votre application et peut donc manquer des problèmes d'exécution ou d'intégration.
- Les très grosses PR peuvent ne pas tenir en une seule passe : découpez-les ou demandez une relecture par dossier.
- La qualité de la relecture dépend de la clarté avec laquelle vous décrivez vos conventions.

## Notes de sécurité

- N'accordez jamais de droits de merge ou d'administration.
- Gardez une approbation humaine sur chaque merge.

## Serveurs 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

## Questions fréquentes

**Claude approuve-t-il ou merge-t-il les pull requests ?**

Il ne peut faire que ce que le jeton permet et ce que vous approuvez. Laissez les décisions de merge aux personnes : utilisez Claude pour les commentaires et les résumés, et laissez les approbations à vos relecteurs humains.

**Faut-il une offre GitHub payante ?**

Non. Les jetons fine-grained et le serveur MCP GitHub fonctionnent sur les comptes gratuits. Il vous faut en revanche une offre Claude incluant Claude Code, ou une offre Cursor, pour faire tourner l'agent.

**Verra-t-il les dépôts privés ?**

Uniquement les dépôts privés que vous sélectionnez à la création du jeton. Le code de ces dépôts est envoyé au fournisseur du modèle dans le cadre de la conversation : vérifiez d'abord la politique de votre entreprise.

**Cela peut-il tourner automatiquement sur chaque PR ?**

Cette configuration est interactive : vous demandez une relecture. Pour des relectures automatiques sur chaque PR, regardez du côté de Claude Code dans GitHub Actions, qui est une configuration distincte.

## Outils

- **[GitHub](https://suiteintent.com/t/github?m=FR)**: Hébergement de code, tickets et pull requests. · Idéal pour: Équipes qui relisent le code par pull request · Offre gratuite · 10000
- **[Linear](https://suiteintent.com/t/linear?m=FR)**: Suivi de tickets rapide, pensé pour le clavier. · Idéal pour: Startups qui planifient par cycles · Offre gratuite · Gratuit pour les startups
