# Que Claude revise tus pull requests

> Las revisiones tardan días y los detalles se escapan cuando todos están ocupados.

Esta configuración es para equipos de desarrollo pequeños cuyas pull requests esperan días a que alguien las revise. Claude lee el diff mediante el servidor MCP de GitHub, lo compara con tus convenciones y con la issue de Linear vinculada y deja comentarios de revisión. Así cada PR recibe una primera revisión y las personas pueden centrarse en el diseño y la intención.

## Pasos

1. **Crea un token de GitHub**: En GitHub, ve a Settings > Developer settings > Fine-grained tokens y crea un token solo para los repositorios que quieras revisar. Dale lectura de contenidos y lectura y escritura de pull requests para que Claude pueda comentar. Pon una fecha de caducidad y apúntala.
   Consejo: Una caducidad de 90 días equilibra seguridad y frecuencia de rotación.
2. **Añade GitHub**: En Claude Code, ejecuta claude mcp add con el servidor MCP oficial de GitHub, remoto o con la imagen de Docker, y pásale el token. En Cursor, añade el mismo servidor en Settings > MCP. Pide al agente que liste las PR abiertas de un repositorio para confirmar la conexión.
   Consejo: Si la lista sale vacía, revisa que el token incluya ese repositorio.
3. **Dale tu checklist de revisión**: Escribe tus reglas de revisión en CLAUDE.md, en una regla de Cursor o en un prompt que reutilices: nombres, manejo de errores, tests esperados y qué ignorar. Incluye ejemplos de comentarios útiles y de comentarios que consideras ruido. Así Claude señala líneas concretas en lugar de dar consejos genéricos.
   Consejo: Dile que ignore el estilo que ya revisa tu linter.
4. **Enlaza el ticket**: Añade el servidor MCP remoto de Linear y autorízalo con OAuth. Cuando una PR mencione una issue, pide a Claude que la lea y compruebe el cambio frente a sus criterios de aceptación. Lo que falte aparece como comentario de revisión y no como sorpresa después del merge.
   Consejo: Pon el ID de la issue de Linear en el nombre de la rama o en el título de la PR.

## Prompts para probar

- Revisa la PR 142 de acme/web con nuestra checklist y deja comentarios en línea donde no se cumpla.
- Lee la issue de Linear vinculada a la PR 142 y dime qué criterios de aceptación no cubre el diff.
- Enumera las PR abiertas en acme/api que llevan más de dos días sin revisión.
- Resume en tres puntos qué cambia la PR 87 para las notas de versión.
- Revisa si faltan tests para las funciones nuevas de la PR 142 y propón casos de prueba.

## Qué necesitas

- Una cuenta de GitHub con acceso a los repositorios
- Un token de acceso personal fine-grained
- Claude Code o Cursor
- Un espacio de Linear si quieres comprobar criterios de aceptación

## Límites

- Claude revisa el diff y los archivos que lee; no ejecuta tu aplicación y puede pasar por alto fallos en tiempo de ejecución.
- Las PR muy grandes pueden no caber en una pasada; divídelas o pide la revisión por carpetas.
- La calidad de la revisión depende de lo claras que sean tus convenciones.

## Notas de seguridad

- Nunca concedas permisos de merge o administración.
- Mantén la aprobación humana en cada merge.

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

## Preguntas frecuentes

**¿Claude aprueba o fusiona pull requests?**

Solo puede hacer lo que permita el token y lo que tú apruebes. Deja las decisiones de merge a las personas y usa Claude para comentarios y resúmenes.

**¿Necesito un plan de pago de GitHub?**

No. Los tokens fine-grained y el servidor MCP de GitHub funcionan con cuentas gratuitas. Sí necesitas un plan de Claude que incluya Claude Code o un plan de Cursor.

**¿Verá los repositorios privados?**

Solo los que selecciones al crear el token. El código de esos repositorios se envía al proveedor del modelo dentro de la conversación, así que revisa antes la política de tu empresa.

**¿Puede revisar cada PR de forma automática?**

Esta configuración es interactiva: tú pides la revisión. Para revisiones automáticas en cada PR, usa Claude Code en GitHub Actions, que es otra configuración.

## Herramientas

- **[GitHub](https://suiteintent.com/t/github?m=ES)**: Alojamiento de código, incidencias y pull requests. · Ideal para: Equipos que revisan código con pull requests · Plan gratis · 10000
- **[Linear](https://suiteintent.com/t/linear?m=ES)**: Gestor de incidencias rápido y pensado para teclado. · Ideal para: Startups que planifican por ciclos · Plan gratis · Gratis para startups