Linear MCP — Casos de uso, Instalar & Demo en vivo

Name: Linear MCP Server
Author: linear

Por qué usarlo

Características clave

Oficial, alojado de forma remota — autenticación vía OAuth mcp-remote, sin filtraciones de tokens
CRUD completo de issues: crear, actualizar, asignar, comentar, cambiar estado
Consultar por ciclo, equipo, asignado, etiqueta, proyecto o texto libre
Respeta tus permisos del workspace de Linear — el agente no puede hacer lo que tú no puedes

Demo en vivo

Cómo se ve en la práctica

linear.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add linear -- npx -y mcp-remote https://mcp.linear.app/sse

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Linear

Cómo hacer triage de un backlog desordenado de Linear en 10 minutos

👤 Managers de ingeniería, líderes técnicos ⏱ ~15 min intermediate

Cuándo usarlo: Lunes por la mañana. El backlog tiene 200+ issues sin triage y la planificación es en una hora.

Requisitos previos

Acceso al workspace de Linear — OAuth a través de mcp-remote — la primera llamada de herramienta abre el navegador para otorgar
Team slug (p. ej. ENG) — Mira cualquier identificador de issue — el prefijo es tu team slug

Flujo

Extrae todos los issues sin triage del equipo

Lista todos los issues ENG en estado 'Triage' o sin prioridad establecida, creados en los últimos 30 días. Devuelve id, título, reportero y longitud de descripción.✓ Copiado

→ Tabla de candidatos con contexto suficiente para clasificar
Agrupa por tema

Agrupa estos en 4-6 temas (bug / infra / onboarding / perf / etc.). Para cada cluster, propón una prioridad y proyecto sugerido.✓ Copiado

→ Clusters temáticos con justificación
Aplica las decisiones

Para cada cluster, actualiza los issues: establece prioridad, añade la etiqueta correspondiente y mueve a estado 'Backlog'. NO asignes a nadie.✓ Copiado

→ N issues actualizados, confirmaciones registradas

Resultado: Un backlog listo para planificación, agrupado y priorizado, con un registro de auditoría de cada cambio que hizo el agente.

Errores comunes

El agente asigna masivamente issues a personas equivocadas basándose en 'quién escribió código similar' — Dile explícitamente que NO asigne — la asignación es una decisión humana y debe seguir siéndolo
Linear de nivel gratuito te limita la tasa después de ~1500 solicitudes/h — Procesa actualizaciones por lotes con issueBatchUpdate cuando esté disponible; de lo contrario, mantén ejecuciones de triage bajo 500 issues

Combinar con: sentry · github

Genera un informe de estado de ciclo semanal desde Linear

👤 Managers de ingeniería, PMs ⏱ ~10 min beginner

Cuándo usarlo: Viernes por la tarde, necesitas escribir la actualización semanal para el liderazgo.

Requisitos previos

Ciclo activo en Linear — Linear > tu equipo > Ciclos — anota el número de ciclo actual

Flujo

Extrae estadísticas de ciclo

Para el ciclo ENG 47, lista todos los issues agrupados por estado. Incluye completados-esta-semana, en-progreso, bloqueados y en-riesgo (sin actualización en 3+ días).✓ Copiado

→ Desglose con conteos y títulos de issues
Compara con la semana pasada

Compara con la instantánea de la semana pasada [pega el JSON anterior]. ¿Qué se entregó, qué regresó a estados anteriores, qué está recién bloqueado?✓ Copiado

→ Delta con narrativa
Redacta el informe

Escribe un informe Markdown de 1 página: ganancias, en-vuelo, bloqueadores, necesita-ayuda. Sé honesto — el liderazgo lee entre líneas.✓ Copiado

→ Informe listo para pegar en Slack o Notion

Resultado: Una actualización de ciclo pulida en 10 minutos en lugar de 45.

Errores comunes

Los issues completados sin PRs fusionados parecen progreso pero no lo son — Combina con GitHub MCP — verifica que cada issue 'Done' tenga un PR fusionado referenciado

Combinar con: github · notion

Registra automáticamente bugs de Linear desde nuevos issues de Sentry

👤 Ingenieros de guardia ⏱ ~15 min intermediate

Cuándo usarlo: Quieres que los picos de error en tiempo real en Sentry se conviertan en bugs rastreados sin copia-pega manual.

Requisitos previos

Sentry MCP instalado junto a Linear — Ver la guía de Sentry para configuración
Una etiqueta dedicada de Linear como from-sentry — Linear > Configuración > Etiquetas — crear una vez

Flujo

Encuentra nuevos issues de Sentry por encima del umbral

Encuentra issues de Sentry vistos por primera vez en las últimas 24h con >50 eventos en el proyecto web-prod.✓ Copiado

→ Lista con IDs de issues y conteos de eventos
Verifica duplicados en Linear

Para cada título de issue de Sentry, busca en Linear issues existentes con títulos similares o que contengan la URL de Sentry. Omite los que ya están registrados.✓ Copiado

→ Lista de deduplicación — solo elementos genuinamente nuevos
Crea los bugs de Linear

Crea un issue de Linear en el equipo ENG para cada nuevo issue de Sentry: título = título de Sentry, descripción = stacktrace + enlace, prioridad = Urgente si >1000 eventos si no Alto, etiqueta = from-sentry.✓ Copiado

→ N issues creados con enlaces devueltos

Resultado: Una ingesta limpia de bugs de Linear que nunca deja caer un error de producción en el piso.

Errores comunes

El mismo issue de Sentry se registra dos veces porque los títulos cambian ligeramente — Usa el short-id del issue de Sentry (p. ej. WEB-3a91) en el título de Linear y deduplica en ese substring

Combinar con: sentry

Empuja issues estancados en el ciclo actual

👤 Líderes técnicos, scrum masters ⏱ ~5 min beginner

Cuándo usarlo: Verificación a mitad de ciclo. Los issues asignados durante 5+ días sin cambio de estado usualmente están atascados.

Flujo

Encuentra los issues estancados

Lista issues en el ciclo ENG actual que han estado en 'En Progreso' durante 5+ días sin cambio de estado o comentario.✓ Copiado

→ Lista con asignado y días-estancado
Publica un comentario de empujón suave

Añade un comentario en cada uno: '¿Verificación rápida — sigues en pista para este ciclo, o necesitas desglosar esto / obtener ayuda?' Etiqueta al asignado.✓ Copiado

→ Comentarios publicados, enlaces devueltos
Escala si se ignora

En 48 horas, vuelve a ejecutar. Si aún no hay actualización, envíame una lista de mensaje directo para seguimiento 1:1.✓ Copiado

→ Lista de escalación para seguimiento humano

Resultado: Trabajo desbloqueado sin ser el manager pesado todos los días.

Errores comunes

Spam de comentarios si ejecutas esto cada hora — Verifica si el agente ya ha comentado en los últimos 3 días antes de publicar de nuevo

Genera un scaffold de un proyecto de Linear desde una especificación de Notion

👤 PMs, líderes técnicos que inician una nueva iniciativa ⏱ ~20 min intermediate

Cuándo usarlo: Tienes una PRD escrita y necesitas desglosarla en issues rastreables.

Requisitos previos

Notion MCP instalado — Ver guía de Notion
La URL de la página PRD — Copiar desde Notion

Flujo

Lee y resume la especificación

Lee la PRD de Notion en <URL> y lista cada entregable discreto como una descripción de una línea.✓ Copiado

→ 15-40 issues candidatos
Revisa y refina

Agrupa estos en 3-5 hitos. Marca cualquiera que necesite trabajo de diseño, API o BD como issues separados.✓ Copiado

→ Árbol de issues estructurado
Crea el proyecto y los issues de Linear

Crea un proyecto de Linear denominado '<Spec title>' en el equipo ENG. Crea cada hito como issue padre, con niños como sub-issues. Vincula la página de Notion en cada descripción.✓ Copiado

→ URL del proyecto + conteo de issues

Resultado: Un proyecto de Linear completamente generado en 20 minutos en lugar de 2 horas de escritura manual de tickets.

Errores comunes

El agente crea 80 issues cuando querías 20 — demasiado granular — En el paso 2, limita explícitamente: 'no más de 20 issues en total, fusiona cualquier cosa más pequeña que un día de trabajo'

Combinar con: notion

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

linear + sentry

Convierte picos de error de producción en bugs de Linear rastreados automáticamente

Encuentra nuevos issues web-prod de Sentry de las últimas 24h con >50 eventos. Para cada uno, crea un bug de Linear en el equipo ENG etiquetado como 'from-sentry', prioridad Alta, con el stacktrace en la descripción.✓ Copiado

linear + github

Vincula automáticamente PRs a issues de Linear y cierra issues cuando los PRs se fusionan

Para cada PR abierto en mi repo, encuentra el ID del issue de Linear en el título o nombre de rama y añade un comentario de referencia en el issue de Linear con la URL del PR.✓ Copiado

linear + notion

Publica resúmenes semanales de ciclo en una base de datos de Notion

Genera el estado del ciclo ENG de esta semana y crea una página en la base de datos de Notion 'Engineering Weekly' con el informe completo.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_issues	team?, assignee?, state?, label?, cycle?, query?, limit?	Búsqueda primaria — filtra el stream	1 llamada API
get_issue	id	Obtén contexto completo para un issue único	1 llamada API
create_issue	teamId, title, description?, priority?, labelIds?, assigneeId?, projectId?	Registra un nuevo issue	1 llamada API
update_issue	id, stateId?, priority?, assigneeId?, labelIds?, title?, description?	Cambia estado, prioridad o asignación	1 llamada API
create_comment	issueId, body	Publica un empujón o nota de estado en un issue	1 llamada API
list_projects	teamId?	Descubre proyectos activos en un equipo	1 llamada API
list_cycles	teamId	Encuentra ciclos activos o recientes para un equipo	1 llamada API
list_teams		Descubre equipos en el workspace	1 llamada API

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: 1500 req/h para apps OAuth, 120 req/min de ráfaga — generoso para cualquier flujo de trabajo real
Tokens por llamada: 300–1500 tokens por issue dependiendo de la descripción/comentarios
Monetario: Gratuito — Linear MCP está incluido en cualquier plan de Linear
Consejo: Usa list_issues con filtros específicos en lugar de extraer todo y luego filtrar — reduce el costo de tokens 10x en backlogs grandes

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: read write issues:create

Almacenamiento de credenciales: OAuth a través de mcp-remote — tokens almacenados en ~/.mcp-auth/, actualizables sin volver a iniciar sesión

Salida de datos: Todas las llamadas a api.linear.app y mcp.linear.app

No conceder nunca: admin

Resolución de problemas

Errores comunes y soluciones

El popup del navegador OAuth no se abre

Ejecuta npx -y mcp-remote https://mcp.linear.app/sse manualmente una vez — imprimirá una URL que puedes pegar en un navegador

Verificar: Después de autenticarte, vuelve a ejecutar tu agente; token en caché en ~/.mcp-auth/

403 en update_issue

Tu rol de Linear carece de acceso de escritura a ese equipo. Pide a un admin del workspace que te promocione o limita el agente a un equipo que poseas.

Issues devueltos pero comentarios faltantes

Los comentarios son una consulta separada — usa get_issue con include-comments, o lista comentarios por separado con el ID del issue.

No puedes encontrar un issue que sabes que existe

Verifica el filtro de equipo — los issues de otros equipos no se devuelven a menos que pases team=null o especifiques ese equipo.

Alternativas

Linear vs otros

Alternativa	Cuándo usarla	Contrapartida
Jira MCP	Tu organización está en Jira, no en Linear	API más pesada, más estados/campos a considerar — los agentes funcionan peor en Jira fuera de la caja
GitHub Issues (via GitHub MCP)	Quieres issues estrechamente acoplados al código sin una herramienta separada	Pierdes ciclos, proyectos y estados de flujo de trabajo — GitHub Issues es más simple pero menos estructurado

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills