Linear MCP: cómo conectarlo y gestionar tareas con IA

URL del servidor Linear MCP y autenticación

Usa https://mcp.linear.app/mcp mediante Streamable HTTP, una conexión web al servidor alojado. La configuración interactiva utiliza OAuth 2.1 con registro dinámico de clientes, que se encarga del registro del cliente y de la autorización del usuario. Como alternativa, puedes enviar un token OAuth o una clave de API de Linear en Authorization: Bearer <yourtoken>. Configuración de Linear MCP

Piensa en MCP como una ventanilla de servicios compartida. Tu asistente solicita una operación por su nombre, como buscar una tarea o guardar un cambio. El servidor de Linear ejecuta la operación que permite la conexión. El prompt expresa lo que quieres hacer; no concede permisos adicionales.

Son distintas maneras de limitar una conexión. Un prompt que diga «no edites» da una instrucción al asistente; un endpoint o una credencial de solo lectura limita lo que puede hacer. Opciones de acceso de Linear

Cómo conectar Linear con el cliente que usa tu equipo

Cómo conectar Linear con Claude y Claude Code

En la aplicación de Claude para navegador o escritorio, abre Settings → Connectors y conecta Linear. Ese es el procedimiento que indica la página de integración de Linear con Claude.

Para Claude Code:

1. Ejecuta claude mcp add --transport http linear-server https://mcp.linear.app/mcp en la terminal.
2. Abre una sesión de Claude Code.
3. Ejecuta /mcp y completa el proceso de autenticación.

Tanto el comando como el paso posterior proceden de la guía de configuración de Linear con Claude.

Cursor

La guía principal de Linear ofrece un enlace de instalación e indica que busques Linear en la página de herramientas MCP de Cursor. Usa la opción de instalación del apartado de Cursor en la guía de Linear.

La página específica de Cursor también describe este procedimiento manual:

1. Pulsa Ctrl/Cmd + Shift + J para abrir la configuración de Cursor.
2. Selecciona MCP.
3. Selecciona Add new global MCP server.
4. Añade esta configuración:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

Esta configuración usa mcp-remote como puente entre el cliente y el servidor alojado. Es la que publica la página de integración de Linear con Cursor.

Codex CLI y la extensión para IDE

Según Linear, la CLI y la extensión para IDE comparten la configuración de MCP.

1. Ejecuta codex mcp add linear --url https://mcp.linear.app/mcp.
2. Sigue la indicación para iniciar sesión en Linear que describe su guía de configuración.
3. Si optas por la configuración manual, Linear indica que debes autenticarte con codex mcp login linear después de editar ~/.codex/config.toml.

Antes de copiar una configuración, ten presente esta discrepancia entre las páginas de la documentación:

La entrada manual del servidor en la página específica es [mcp_servers.linear] con url = "https://mcp.linear.app/mcp". Aquí se reproducen las opciones tal como están publicadas, pero esas opciones de activación contradictorias no deben tomarse como un requisito universal vigente. Integración de Linear con Codex, guía principal de MCP

Usa el procedimiento anterior para añadir el servidor e iniciar sesión. La guía actual de MCP de OpenAI documenta la configuración de servidores HTTP y codex mcp login <server-name> sin exigir ninguna de esas dos opciones. Documentación oficial de MCP de OpenAI

ChatGPT

Sigue el procedimiento que documenta Linear:

1. Abre la configuración de conectores de ChatGPT mediante el enlace de la página de integración de Linear con ChatGPT.
2. Conecta Linear.
3. En investigación en profundidad, añade Linear como fuente.

Linear describe esta conexión como una forma de consultar tareas, proyectos y conversaciones que respeta los permisos existentes de cada usuario. No documenta la creación ni la actualización de tareas mediante esta configuración. Úsala para investigar y preparar resúmenes; para los ejemplos de edición que aparecen más adelante, elige un cliente MCP cuya capacidad de escritura esté documentada. Esta distinción se refiere a esa conexión concreta, no a todas las integraciones de ChatGPT.

Qué herramientas documenta Linear

La distinción útil es entre consultar contexto y guardar cambios. Estos son los identificadores exactos de la lista de herramientas de uso habitual publicada por Linear, junto con su función. La lista aparece en su página de integración con Slack, en el apartado sobre cómo conectar ese mismo servidor Linear MCP con Slackbot. Lista de herramientas de Linear

El registro de cambios de Linear también menciona list_cycles, list_issue_labels, list_comments, save_project y save_document. Documenta los detalles de los ciclos, la consulta paginada de etiquetas y comentarios, los cambios en proyectos y la creación o reasignación de documentos bajo iniciativas o ciclos. Se trata de un inventario publicado de herramientas relevantes; no implica que todos los clientes ofrezcan un catálogo idéntico y de tamaño fijo. Herramientas de ciclos y etiquetas, herramientas de comentarios, herramientas de proyectos y documentos

Los ejemplos antiguos pueden usar create_issue y update_issue por separado. Linear las unificó en save_issue. Tenlo presente al copiar prompts antiguos o desarrollar soluciones que dependan de los nombres de las herramientas. Cambio en las herramientas de Linear

A qué datos accede y qué puede controlar un administrador

Considera la conexión una vía autorizada de acceso a los datos del espacio de trabajo. En la terminología OAuth de Linear, read significa «acceso de lectura a la cuenta del usuario» y write, «acceso de escritura a la cuenta del usuario». El actor de tipo usuario, que es el predeterminado, crea recursos en nombre de la persona que autorizó la aplicación. Permisos OAuth de Linear

Para las claves de API, Linear habla de «acceso completo a los datos a los que puede acceder tu usuario», con la posibilidad de limitar los permisos y los equipos. Por eso, una clave restringida ofrece un alcance de acceso muy distinto al de una clave personal con permisos amplios. Permisos de las claves de API

Los controles dependen del método de autenticación de la conexión:

Según Linear, las aprobaciones de aplicaciones sirven para controlar «qué aplicaciones pueden acceder al espacio de trabajo y a sus datos». Los miembros pueden solicitar la aprobación durante la instalación. Los controles de claves se aplican a la autenticación mediante claves de API; no sustituyen la gestión de las conexiones de aplicaciones OAuth. Aprobación de aplicaciones, administración de la API

En los clientes compatibles de Anthropic, los espacios de trabajo Enterprise con Okta SAML pueden usar una autorización gestionada por la empresa. Linear señala que así «se aplican sus permisos existentes de Linear». Los administradores gestionan el acceso a través de Okta, sin que cada usuario tenga que autorizar cada conexión por separado. Autorización gestionada por la empresa

Si el flujo solo necesita consultar el estado del trabajo, elige acceso de solo lectura. Para clasificar y crear tareas, concede los permisos de escritura necesarios y muestra los cambios propuestos antes de aplicarlos. Ese paso de revisión es una recomendación para el flujo de trabajo; no significa que todos los clientes impongan el mismo proceso de aprobación.

Tres flujos de trabajo para automatizar Linear

Empieza por los informes de ciclo, porque pueden elaborarse sin modificar datos. Después, pasa a la clasificación inicial de tareas si la recepción de reportes resulta repetitiva. Convertir especificaciones en tickets compensa cuando un responsable dedica tiempo a trasladar a Linear decisiones que ya están tomadas.

Los siguientes ejemplos son ficticios y se presentan paso a paso. Ilustran prompts y los entregables esperados; no son resultados de una prueba con una sesión iniciada.

Clasificar tareas nuevas y presentar una propuesta para revisión

Un responsable de ingeniería puede pedir al asistente que examine los reportes entrantes, consulte tareas similares que ya existan y presente una propuesta conjunta de cambios. Así se reducen las búsquedas repetidas y la edición de propiedades, mientras el responsable conserva la decisión sobre la asignación y la prioridad.

Ejemplo de entrada: Un reporte nuevo, «El botón de exportación se queda bloqueado», indica que el navegador deja de responder durante una exportación con filtros. Una tarea existente, «La exportación con filtros nunca termina», describe la misma pantalla. Otro reporte, «Las invitaciones nunca llegan», no incluye registros de entrega ni pasos para reproducir el problema.

Prompt:

Una propuesta de resultado útil:

Tras la revisión, el responsable puede autorizar únicamente los cambios de etiquetas y asignación acordados mediante save_issue, sin modificar los reportes ambiguos. El asistente debe devolver los enlaces de las tareas afectadas y un registro de los campos modificados. Las operaciones de consulta y guardado figuran en la lista de herramientas de Linear.

Antes de desarrollar un sistema de clasificación a medida, compáralo con Triage Intelligence. Linear ya ofrece sugerencias de propiedades y detección de duplicados o relaciones. Una solución personalizada que coordine herramientas mediante MCP tiene más sentido cuando la decisión requiere contexto o reglas que van más allá del flujo nativo. Triage Intelligence

Convertir una especificación en tareas sin inventar requisitos

Un fundador puede partir de una especificación de funcionalidad aprobada, convertirla en borradores de tareas y, una vez revisadas, crearlas en Linear. La ventaja es la coherencia: cada ticket conserva el requisito del que procede y las decisiones pendientes quedan a la vista.

Ejemplo de especificación: «Los administradores del espacio de trabajo pueden invitar a miembros por correo electrónico. Las personas invitadas aceptan mediante un enlace enviado por correo. Los administradores pueden revocar las invitaciones pendientes. Los cambios de facturación y las invitaciones masivas quedan fuera del alcance».

Prompt:

Desglose de tareas propuesto:

Preguntas pendientes: ¿Qué ocurre si el correo ya pertenece a un miembro? ¿Caducan las invitaciones? ¿Qué debe ver la persona invitada después de una revocación? Siguen siendo preguntas hasta que quien esté a cargo del producto decida.

Una vez aprobada la propuesta, el asistente puede crear la tarea principal y las subtareas, devolver sus URL e indicar cualquier elemento que no haya podido crear. La creación de subtareas es una capacidad documentada de MCP. Cambios en MCP de Linear

El asistente se encarga de trasladar la especificación a las tareas. Las decisiones de producto siguen siendo responsabilidad de quien dirige el producto.

Preparar un informe semanal a partir del ciclo

Un responsable puede convertir el trabajo de un ciclo en un borrador de informe con enlaces que respalden cada afirmación. Así se acorta el camino entre las actualizaciones dispersas de las tareas y un informe que alguien pueda verificar.

Un informe semanal y un resumen de ciclo pueden abarcar periodos distintos. Especifica el equipo, el ciclo y el periodo del informe para evitar que «completado en este ciclo» pase a significar, sin justificación, «completado esta semana».

Ejemplo de información de origen: «Correo de invitación» se marca como completada durante el periodo del informe. «Aceptar invitación» sigue en curso. Un comentario en «Revocar invitación» indica que la implementación espera una decisión de producto sobre qué ocurre al abrir un enlace revocado.

Prompt:

Ejemplo de borrador:

En un borrador real, cada frase debe incluir la URL de la tarea correspondiente. El ejemplo omite deliberadamente cualquier porcentaje de avance o afirmación de lanzamiento. La consulta de ciclos, tareas y comentarios aporta la información necesaria para este flujo. Herramientas de ciclos y tareas, consulta de comentarios

Otros usos cuando los flujos anteriores ya funcionan bien

La creación de comentarios forma parte de las capacidades documentadas del servidor, y las herramientas de proyectos aportan contexto para un traspaso. Capacidades del servidor, herramientas de proyectos

Cómo calcular el valor: la revisión también consume tiempo

La partida de costos afectada es la coordinación de ingeniería. Antes de usar MCP, un responsable busca, copia, concilia información y redacta. Con un asistente conectado, todavía tiene que delimitar la petición, revisar el resultado y corregir errores.

Usa este cálculo del punto de equilibrio con tus propios costos:

Valor neto = (tiempo de preparación manual − tiempo de preparación asistida, revisión y corrección) × costo por hora con todas las cargas incluidas − costos adicionales del cliente y de operación.

Un informe impecable que tarda más en verificarse no ha ahorrado tiempo al equipo. Al comparar los flujos, mantén el mismo alcance del informe y cuenta también el trabajo de corregir ediciones erróneas. El objetivo útil es dedicar menos esfuerzo de coordinación a cada resultado aceptado.

Para elegir una suscripción, consulta los precios de Linear. Si aún no has elegido la herramienta de gestión de tareas, Linear vs Jira analiza esa decisión. Nuestra guía de los mejores servidores MCP cubre otras conexiones relacionadas.

Qué productos tiene sentido desarrollar a partir de esta conexión

Un servicio que prepare borradores de informes de ciclo es la oportunidad inicial más sólida. Un responsable de ingeniería podría pagar por un informe consistente que respete los límites entre equipos, separe el trabajo terminado del pendiente e incluya la evidencia de las tareas. La versión mínima útil guardaría una definición del informe, consultaría los datos del ciclo correspondientes y produciría un borrador editable. La programación de ejecuciones, los reintentos y la entrega formarían parte de tu aplicación.

La dificultad está en diferenciarse: un prompt genérico de resumen es fácil de reproducir. El posible producto está en las reglas de informes de la empresa, la trazabilidad de las fuentes y el proceso de revisión. Antes de crear una suscripción independiente, confirma que esos detalles son un problema recurrente para los equipos.

Una cola personalizada de revisión para clasificar tareas es una oportunidad más acotada. Un responsable de plataforma o de ingeniería de soporte podría pagar por combinar el contexto de las tareas de Linear con sus propias políticas de asignación y con contexto de soporte autorizado por separado. La versión mínima mostraría los cambios de campos propuestos, la evidencia y una opción para aprobarlos u omitirlos; después aplicaría los cambios aceptados.

La dificultad es competir directamente con Triage Intelligence, la función nativa de Linear. Desarrolla esta solución solo cuando el contexto o las políticas adicionales cambien una decisión que el sistema nativo no pueda resolver adecuadamente para ese equipo. Son hipótesis de producto, no resultados atribuidos a clientes.

Cuáles son los límites de la conexión

MCP permite que el asistente acceda a operaciones; no resuelve requisitos ambiguos ni convierte datos incompletos de las tareas en información fiable. Una tarea marcada como completada puede respaldar una afirmación sobre su estado. Por sí sola, no demuestra que una funcionalidad haya llegado al cliente.

Del mismo modo, autorizar Linear no autoriza el acceso a cada documento, repositorio o sistema de soporte mencionado en una tarea. Si tu solución necesita esas fuentes, planifica por separado cómo acceder a ellas y consultar su información.

Para configuraciones nuevas, usa /mcp. Linear considera /sse una alternativa obsoleta. El antiguo servidor comunitario de jerhadf también indica expresamente que está obsoleto y ya no recibe mantenimiento, y remite a los usuarios al servidor oficial de Linear. Recomendaciones actuales sobre el endpoint

Para empezar el lunes: pide al responsable de ingeniería que defina el equipo, el ciclo y el periodo de un borrador de informe de estado con acceso de solo lectura. Comprueba sus afirmaciones frente a las tareas enlazadas y compara el esfuerzo de preparación con el proceso actual. Amplía el acceso a escritura cuando el equipo tenga una rutina de revisión clara.

Si quieres implementar estos flujos según las reglas de tu equipo, desarrollamos automatizaciones con IA.