# Dale a Cursor acceso a Linear

> Copias a mano los detalles del ticket en el editor antes de cada tarea.

Esta configuración es para desarrolladores que planifican en Linear y programan en Cursor. El agente de Cursor lee una issue de Linear por su ID, planifica el cambio a partir de la descripción y los comentarios y abre una pull request en GitHub vinculada a la issue. Dejas de copiar a mano el texto de los tickets en el editor.

## Pasos

1. **Añade Linear a Cursor**: Abre Cursor Settings > MCP (Tools & Integrations en versiones recientes) y añade un servidor nuevo. Usa la URL del servidor remoto de Linear, https://mcp.linear.app/mcp, en tu mcp.json. Guarda el archivo y espera a que el servidor aparezca como conectado.
   Consejo: Ponlo en .cursor/mcp.json del proyecto si solo un repositorio necesita Linear, o en la configuración global para todos.
2. **Autoriza tu espacio de trabajo**: La primera vez que Cursor llama a Linear se abre el navegador para OAuth. Inicia sesión, elige el espacio de trabajo de tu equipo y vuelve a Cursor. Pide al agente que liste tus issues asignadas para confirmar que ve el espacio correcto.
   Consejo: Si cambias de espacio más adelante, elimina y vuelve a añadir el servidor para autorizar de nuevo.
3. **Menciona issues en tus prompts**: En modo Agent, pide a Cursor que lea una issue por su ID, como ENG-412, y proponga un plan antes de escribir código. Compara el plan con los criterios de aceptación y los comentarios. Después deja que haga el cambio en tu rama.
   Consejo: Pide al agente que deje un comentario breve de progreso en la issue de Linear al terminar.
4. **Abre el pull request**: Añade el servidor MCP de GitHub con un token fine-grained que pueda crear ramas y pull requests en el repositorio. Pide a Cursor que abra una PR con el ID de la issue en el título o en el nombre de la rama. La integración de Linear con GitHub vincula entonces la PR a la issue.
   Consejo: La integración de GitHub tiene que estar activada en los ajustes de Linear para el enlace automático.

## Prompts para probar

- Lee ENG-412 y propón un plan antes de escribir código.
- Implementa ENG-412 en una rama nueva llamada eng-412-export-csv y ejecuta los tests.
- Enumera mis issues de Linear del ciclo actual que están In Progress.
- Abre una pull request para esta rama con ENG-412 en el título y un resumen de los cambios.
- Añade un comentario en ENG-412 diciendo que el arreglo está en revisión, con el enlace a la PR.

## Qué necesitas

- Cursor con modo Agent
- Una cuenta de Linear en el espacio que quieres usar
- Un token fine-grained de GitHub con acceso a pull requests
- La integración de Linear con GitHub activada para vincular PR automáticamente

## Límites

- El agente solo conoce la issue, sus comentarios y tu repositorio; lo decidido en reuniones no lo ve.
- El acceso OAuth usa tus permisos de Linear, así que el agente ve todos los equipos que ves tú.
- Los hilos largos ocupan contexto; en issues grandes pide primero un resumen.

## Notas de seguridad

- Usa OAuth en lugar de una clave personal cuando sea posible.
- Revisa las actualizaciones de issues que proponga Cursor.

## Servidores MCP

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

## Preguntas frecuentes

**¿Qué plan de Cursor necesito?**

Los servidores MCP funcionan en el modo Agent de Cursor, disponible en el plan gratuito y en los de pago con distintos límites de uso. Consulta la página de precios de Cursor para ver los límites actuales.

**¿Puede Cursor modificar issues de Linear?**

Sí. El servidor MCP de Linear puede crear y actualizar issues y comentarios con los permisos de tu cuenta. Cursor pide confirmación antes de cada llamada salvo que actives la ejecución automática.

**¿Funciona en otros editores?**

El servidor de Linear funciona con cualquier host MCP, como Claude Code, VS Code o Windsurf. Esta guía usa Cursor porque los pasos y las rutas de ajustes coinciden con su interfaz.

**¿Y si la descripción de la issue es pobre?**

El agente planifica con lo que dice la issue. Añade antes criterios de aceptación y enlaces al diseño en Linear, o da los detalles que faltan en tu prompt.

## Herramientas

- **[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
- **[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
