# Conecta Claude a GitHub y Linear

> Los issues nuevos de GitHub se acumulan más rápido de lo que nadie puede etiquetarlos, y el trabajo real se sigue en Linear.

Esta configuración es para mantenedores y equipos de producto que reciben bugs en GitHub Issues pero planifican en Linear. Claude lee las issues nuevas de GitHub, propone etiquetas y prioridad y, cuando lo apruebas, crea las issues equivalentes en el equipo correcto de Linear. Al final tienes un backlog clasificado en Linear y una lista de GitHub más ordenada.

## Pasos

1. **Añade GitHub**: En GitHub, crea un token fine-grained limitado a los repositorios que quieras clasificar, con lectura y escritura de issues y lectura de metadatos. Añade el servidor MCP oficial de GitHub a Claude Desktop o Claude Code con ese token. Pide a Claude que liste las diez issues abiertas más recientes para comprobar el acceso.
   Consejo: Deja desactivados los permisos de contenido y pull requests; para clasificar basta con issues.
2. **Añade Linear**: Añade el servidor MCP remoto de Linear en mcp.linear.app y completa el inicio de sesión OAuth en el navegador. Elige el espacio de trabajo con tus equipos de producto. Pide a Claude que liste tus equipos de Linear y sus estados para confirmar que ve el espacio correcto.
   Consejo: Si perteneces a varios espacios, revisa los nombres de equipo antes de crear nada.
3. **Define las reglas de triaje**: Escribe un brief de clasificación breve: tus etiquetas de GitHub y su significado, cómo decides la prioridad y qué equipo de Linear se encarga de cada área. Guárdalo en un Proyecto de Claude, en CLAUDE.md o en un prompt que pegues cada vez. Añade dos o tres issues pasadas con la decisión que tomaste como ejemplo.
   Consejo: Incluye una regla para duplicados, como buscar en Linear por título antes de crear una issue.
4. **Revisa antes de escribir**: Pide primero una tabla de clasificación: issue, etiquetas propuestas, prioridad, equipo y un motivo en una línea. Corrige lo que esté mal y después aprueba los cambios de etiquetas y la creación en Linear. Mantén la aprobación de escrituras hasta que varias rondas salgan sin correcciones.
   Consejo: Pide a Claude que deje el enlace de Linear como comentario en la issue de GitHub para que quien la abrió pueda seguirla.

## Prompts para probar

- Clasifica las issues abiertas en acme/app creadas esta semana y muéstrame una tabla con etiquetas, prioridad y equipo de Linear.
- Crea issues en el equipo Platform de Linear para las issues de GitHub que marcaste como bug, con enlace a GitHub.
- Busca issues de GitHub que parezcan duplicadas de issues existentes en Linear y ponlas una al lado de la otra.
- Etiqueta la issue 512 como bug y needs-repro y pide al autor en un comentario la versión de su navegador.
- Resume por área de producto las issues nuevas de esta semana para la reunión de planificación.

## Qué necesitas

- Una cuenta de GitHub con permiso de escritura en las issues de los repositorios
- Un espacio de Linear donde puedas crear issues
- Claude Desktop o Claude Code
- Un brief escrito con etiquetas, prioridades y responsables por área

## Límites

- Claude decide la prioridad a partir del texto de la issue, así que un informe vago da una clasificación vaga.
- Las issues creadas así no se sincronizan con GitHub; cambiar el estado en una no actualiza la otra.
- Los backlogs grandes hay que procesarlos por lotes, porque Claude maneja bien un número limitado de issues por conversación.

## Notas de seguridad

- Usa un token granular de GitHub limitado a repositorios concretos.
- Mantén la aprobación manual para cualquier acción de escritura.

## 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 cerrará o borrará issues de GitHub?**

Solo si el token lo permite y tú apruebas la llamada. Para clasificar, limítate a etiquetas, comentarios y creación en Linear, y cierra las issues tú.

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

El servidor MCP de Linear funciona con el plan gratuito, dentro de sus límites de issues y equipos. Necesitas un plan de Claude que admita conectores MCP o Claude Code.

**¿Puede ejecutarse de forma programada?**

En Claude Desktop inicias la clasificación a mano. Si la quieres periódica, puedes ejecutar Claude Code en una tarea programada, pero mantén una revisión humana antes de escribir.

**¿Y si Claude asigna una issue al equipo equivocado?**

Muévela en Linear y añade el caso como ejemplo a tu brief. Los ejemplos claros corrigen la mayoría de errores de asignació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