Gestores de incidenciasLinear

Servidor MCP y CLI de Linear con incidencias sin conexión

Una CLI de Linear y un servidor MCP de Linear: tus incidencias y proyectos en tu ordenador, para que tu agente de IA los lea sin conexión y use toda la API de Linear.

Deja que tu agente de IA lea tus incidencias, proyectos y comentarios de Linear sin pegarlos en el chat. La herramienta de línea de comandos linear copia tu espacio de trabajo a tu ordenador, y el agente responde a partir de esa copia, incluso sin conexión. Si lo permites, la misma herramienta crea y cambia incidencias con la API de Linear.

Puedes preguntar a tu agente qué incidencias de un equipo siguen en curso, qué se dijo en los comentarios de ENG-12 o qué incidencias no tienen responsable. El agente las encuentra en la copia local y nombra cada incidencia por su clave. Una incidencia que asumes se convierte en una tarea en el almacén local, junto a las tareas de tus chats.

linear es a la vez una CLI de Linear para tu terminal y un servidor MCP de Linear para aplicaciones como Claude Desktop, y para ChatGPT a través de un túnel que ejecutas tú. Necesitas una clave de API personal de Linear, que creas una vez en los ajustes de Linear.

En esta página:

  1. Qué obtienes
  2. Cómo funciona
  3. Crea una clave de API personal
  4. Conecta y copia tu espacio de trabajo
  5. Qué no hace todavía
  6. Encuentra la guía para tu tarea

Qué obtienes

  • Incidencias sin conexión. Lista incidencias por equipo, proyecto, estado, responsable o etiqueta, abre una con sus comentarios y encuentra incidencias, proyectos y comentarios por sus palabras.
  • Una incidencia se convierte en tu tarea. issues assign ENG-12 te añade una tarea que apunta a la incidencia, con fecha límite si la indicas. No copia nada del texto de la incidencia y no cambia nada en Linear.
  • Todo lo demás que ofrece Linear. Crea una incidencia, cambia su estado, añade un comentario o lee ciclos y documentos con el grupo api. api list nombra todas las operaciones.
  • Tú decides qué puede cambiar el agente. Cada perfil permite, pregunta o rechaza cada tipo de escritura. Un borrado o un archivado necesita un permiso propio, WCLINEAR_READ_ONLY=1 rechaza cualquier escritura y --dry-run muestra lo que enviaría una escritura sin enviarlo. Por MCP no hay nadie a quien preguntar, así que una escritura en ask se ejecuta. Pon permissions.api en readonly para evitarlo. Más en los ajustes.
  • Tu agente conectado. Instala la skill de la herramienta para un agente de terminal como Claude Code o Codex, o sirve la herramienta por MCP a una aplicación que se conecta a servidores MCP.

La clave se queda en el llavero del sistema, o en un archivo privado donde no hay llavero. Se la das a la herramienta oculta o por stdin, nunca como argumento, así que no acaba en el historial de la terminal. Más en seguridad.

Cómo funciona

  • Una copia en tu ordenador. linear guarda tus incidencias, proyectos y comentarios, con sus equipos, estados y etiquetas, en el almacén local, un archivo de tu ordenador que comparten todas las herramientas de WireCat. Las listas y la búsqueda leen esta copia, no Linear.
  • La copia es tuya. Linear muestra a cada miembro equipos distintos, así que la copia guarda lo que ve tu propia clave y nada de los equipos privados de otra persona.
  • Una sincronización trae los cambios. La primera copia todo. Después solo lee lo que cambió, y una vez al día detecta lo que se borró en Linear. Las incidencias archivadas siguen en la copia, marcadas.
  • Un perfil para cada cuenta. Un perfil es un nombre que eliges para una cuenta de Linear, como work. Cada comando que usa una cuenta lo nombra primero: linear work issues show ENG-12.
  • Toda la API como comandos. Cada una de las 493 consultas y mutaciones de la API de Linear es un comando propio del grupo api, con sus opciones y su ayuda. Tu agente usa los mismos comandos, en una terminal o por MCP.

Crea una clave de API personal

En Linear, abre Settings → Account → Security & access y crea una clave de API personal. Linear te deja darle acceso completo o solo algunos permisos, como Read, y limitarla a algunos equipos. Para copiar y leer tu espacio de trabajo basta una clave de solo lectura. Para crear o cambiar incidencias con la herramienta, dale también Write. Si no ves la opción, un administrador de tu espacio de trabajo ha desactivado las claves de API para los miembros. Linear describe las opciones en su página de API y webhooks.

Conecta y copia tu espacio de trabajo

  1. Instala linear desde npm.
  2. Inicia sesión. work es un perfil, un nombre que eliges para una cuenta de Linear. La herramienta pide la clave oculta y la comprueba con Linear antes de guardarla.
linear work session start
  1. Copia tu espacio de trabajo y mira las incidencias en curso.
linear work sync
linear work issues list type:started
linear work issues show ENG-12

Vuelve a ejecutar sync más tarde para traer lo que cambió.

  1. Conecta tu agente. Un agente de terminal recibe la skill:
linear skill install

Una aplicación que se conecta a servidores MCP recibe el servidor, como se explica en úsalo.

Qué no hace todavía

  • La búsqueda común de WireCat todavía no lee las incidencias de Linear. Encuéntralas con issues search, no junto a tus mensajes y notas.
  • Solo inicia sesión con una clave de API personal, no a través del navegador.
  • Crear y cambiar incidencias pasa por el grupo api, una operación de Linear cada vez.

Encuentra la guía para tu tarea

TareaGuía
Instalar o actualizar la herramientaInstalar
Ver cómo se forma un comando y conectar un agenteÚsalo
Encontrar un comando o una opciónComandos
Cambiar un ajuste o un permisoAjustes
Arreglar un errorCuando algo falla
Saber qué guarda y envía la herramientaSeguridad
Compararla con otras herramientas de LinearComparada con otras herramientas