API de Linear: issues, proyectos y ciclos con agentes de IA
Linear tiene una API GraphQL pública, la misma que usa la propia app. Los equipos de producto e ingeniería la usan para crear issues, automatizar la clasificación e integrar soporte y monitoreo. El acceso se hace con una clave de API personal u OAuth.
Qué ofrece la API de Linear
Issues
Crear, buscar, actualizar, asignar y cambiar el estado de las issues.
Proyectos e iniciativas
Consultar y actualizar proyectos y sus hitos.
Ciclos
Leer los ciclos y el avance de cada uno.
Comentarios y adjuntos
Comentar y vincular enlaces a las issues.
Equipos y etiquetas
Consultar equipos, estados y labels.
Webhooks
Recibir eventos de issues, comentarios y proyectos.
Cómo acceder a la API de Linear
- Con las credenciales de tu empresaClave de API personal generada en la configuración de Linear, o app OAuth 2.0 con scopes, también como app-agente.
- La API tiene límites por complejidad de consulta; el agente pide solo los campos necesarios.
- Usa un usuario o una app dedicados para que la auditoría sea clara.
- Los cambios masivos, con aprobación.
Documentación oficial: developers.linear.app
Qué hace un agente de iTeam con la API de Linear
Clasificación de la bandeja de entrada
El agente lee las issues en triage, sugiere equipo, prioridad y etiqueta, y marca las duplicadas.
El feedback del cliente se vuelve issue
Los pedidos de soporte se agrupan y se convierten en una issue con enlaces a las conversaciones.
Resumen del ciclo
Al final del ciclo, el agente escribe qué entró, qué salió y qué quedó pendiente.
Error en producción registrado
Las alertas de monitoreo abren una issue con el stack trace y el contexto.
De la credencial al agente trabajando, con aprobación
Generar la clave o la app
En la configuración de Linear, genera una clave de API para un usuario de integración o registra una app OAuth.
Guardar el acceso y limitar lo que hace cada agente
El acceso a Linear se registra en la bóveda de iTeam. Tú eliges qué agentes lo usan y qué pueden hacer (crear una issue, comentar, cambiar el estado), con un tope de costo y el registro de cada llamada.
Ejecutar el piloto con aprobación
En el piloto, crea una issue en un equipo de prueba. El equipo aprueba las acciones sensibles y sigue el historial de llamadas en iTeam.
Equipos de IA listos para este trabajo
Reportes e indicadores
Nina junta los datos, Darwin revisa los números y el informe de indicadores llega a Slack con lo que cambió y por qué.
Gestión de inventario
Nina vigila cada referencia, Darwin calcula cuánto reponer y la orden de compra sale solo cuando una persona la aprueba.
Compras y cotizaciones
Darwin pide cotizaciones y las compara en una tabla, Henry revisa las condiciones y la orden de compra sale con la aprobación registrada.
Logística y entregas
Nina arma las rutas y sigue a cada conductor por WhatsApp; Jaca avisa al cliente del estado de su pedido antes de que llame.
Preguntas sobre la API de Linear
¿La API de Linear es gratuita?
La API está disponible en todos los planes de Linear, con límites de uso.
¿Necesito programar para usar la API de Linear con iTeam?
No necesariamente. El equipo de implantación de iTeam configura el acceso a Linear y las acciones de cada agente a partir de la documentación; TI solo habilita la credencial y revisa los permisos.
¿Linear tiene MCP?
Sí, Linear ofrece un servidor MCP oficial. iTeam puede usarlo o llamar a la API GraphQL, según el caso.
