Servidor MCP lineal
Un servidor de protocolo de contexto de modelo para la API lineal .
Este servidor proporciona integración con el sistema de seguimiento de problemas de Linear a través de MCP, lo que permite a los LLM interactuar con los problemas de Linear.
Instalación
Instalación automática
Para instalar automáticamente el servidor Linear MCP para Claude Desktop a través de Smithery :
Instalación manual
Cree u obtenga una clave API personal de Linear: https://linear.app/settings/account/security
Agregar configuración de servidor a Claude Desktop:
MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Related MCP server: Linear MCP Server
Componentes
Herramientas
Herramientas relacionadas con el usuario
linear_get_viewer: Obtener información sobre el usuario autenticadoNo se requieren entradas
Devuelve información del perfil del usuario, incluido ID, nombre, correo electrónico y estado activo.
linear_get_user_issues: Obtener los problemas asignados a un usuarioEntradas opcionales:
userId(cadena): ID de usuario (omitir para usuario autenticado)includeArchived(booleano): incluye problemas archivadoslimit(número, predeterminado: 50): Máximo de resultados
linear_get_user_teams: Obtener los equipos asociados con un usuarioEntradas opcionales:
userId(cadena): ID de usuario para el que se obtendrán los equipos (omitir para usuarios autenticados)includeArchived(booleano): incluye equipos archivadoslimit(número, predeterminado: 50): Número máximo de equipos a devolver
Devuelve la lista de equipos de los que el usuario es miembro
linear_get_user_projects: Obtener proyectos asociados con un usuarioEntradas opcionales:
userId(cadena): ID de usuario para el que se obtendrán proyectos (omitir para usuarios autenticados)includeArchived(booleano): incluye proyectos archivadoslimit(número, predeterminado: 50): número máximo de proyectos a devolverstatus(cadena): filtrar por estado del proyecto (por ejemplo, 'completado', 'en progreso')
Devuelve una lista de proyectos en los que el usuario es líder o miembro.
Herramientas relacionadas con el equipo
linear_get_teams: Obtener equipos en la organizaciónEntradas opcionales:
includeArchived(booleano): incluye equipos archivadoslimit(número, predeterminado: 50): Número máximo de equipos a devolver
linear_get_team: Obtener detalles sobre un equipo específicoEntradas requeridas:
teamId(cadena): ID del equipo para obtener detalles
Devuelve información del equipo, incluido nombre, clave, miembros y configuraciones.
linear_get_team_issues: Obtener problemas para un equipo específicoEntradas requeridas:
teamId(cadena): ID del equipo para el que se obtendrán los problemas
Entradas opcionales:
includeArchived(booleano): incluye problemas archivadoslimit(número, predeterminado: 50): número máximo de problemas a devolverstatus(cadena): Filtrar por estado del problemapriority(número): Filtrar por nivel de prioridadassigneeId(cadena): Filtrar por cesionario
Herramientas relacionadas con el proyecto
linear_get_projects: Obtener proyectos en la organizaciónEntradas opcionales:
teamId(cadena): Filtrar proyectos por equipoincludeArchived(booleano): incluye proyectos archivadoslimit(número, predeterminado: 50): número máximo de proyectos a devolverstatus(cadena): Filtrar por estado del proyecto
linear_get_project: Obtener detalles sobre un proyecto específicoEntradas requeridas:
projectId(cadena): ID del proyecto del que se obtendrán detalles
Devuelve información detallada del proyecto, incluido el progreso, el estado, el equipo, el líder y las fechas.
linear_get_project_issues: Obtener problemas para un proyecto específico
Entradas requeridas:
projectId(cadena): ID del proyecto para el que se obtendrán los problemas
Entradas opcionales:
includeArchived(booleano): incluye problemas archivadoslimit(número, predeterminado: 50): número máximo de problemas a devolverstatus(cadena): Filtrar por estado del problemapriority(número): Filtrar por nivel de prioridad
Herramientas relacionadas con problemas
linear_create_issue: Crea un nuevo problema lineal
Entradas requeridas:
title(cadena): Título del problemateamId(cadena): ID del equipo en el que se creará el problema
Entradas opcionales:
description(cadena): Descripción del problema (compatible con Markdown)priority(número, 0-4): Nivel de prioridad (1=urgente, 4=baja)status(cadena): nombre del estado inicial
linear_update_issue: Actualizar problemas existentes
Entradas requeridas:
id(cadena): ID del problema a actualizar
Entradas opcionales:
title(cadena): Nuevo títulodescription(cadena): Nueva descripciónpriority(número, 0-4): Nueva prioridadstatus(cadena): nuevo nombre de estado
linear_search_issues: Problemas de búsqueda con filtrado flexible
Entradas opcionales:
query(cadena): Texto a buscar en el título/descripciónteamId(cadena): Filtrar por equipostatus(cadena): Filtrar por estadoassigneeId(cadena): Filtrar por cesionariolabels(string[]): Filtrar por etiquetaspriority(número): Filtrar por prioridadlimit(número, predeterminado: 10): Máximo de resultados
linear_add_comment: Agregar comentarios a los problemas
Entradas requeridas:
issueId(cadena): ID del problema sobre el que se realizará el comentariobody(cadena): Texto del comentario (compatible con Markdown)
Entradas opcionales:
createAsUser(cadena): nombre de usuario personalizadodisplayIconUrl(cadena): URL de avatar personalizada
Herramientas de gestión de etiquetas
linear_get_labels: Obtener etiquetas en la organización
Entradas opcionales:
teamId(cadena): Filtrar etiquetas por equipoincludeArchived(booleano): incluye etiquetas archivadaslimit(número, predeterminado: 50): Número máximo de etiquetas a devolver
linear_create_label: Crea una nueva etiqueta
Entradas requeridas:
name(cadena): nombre de la etiquetateamId(cadena): ID del equipo en el que se creará la etiqueta
Entradas opcionales:
color(cadena): código hexadecimal de color (p. ej., "#FF0000")description(cadena): Descripción de la etiqueta
linear_update_label: Actualizar una etiqueta existente
Entradas requeridas:
id(cadena): ID de etiqueta a actualizar
Entradas opcionales:
name(cadena): nuevo nombre de etiquetacolor(cadena): Nuevo código hexadecimal de colordescription(cadena): Nueva descripción
Herramientas de gestión de archivos adjuntos
linear_add_attachment: Agregar un archivo adjunto a un problema
Entradas requeridas:
issueId(cadena): ID del problema al que se agregará el archivo adjuntourl(cadena): URL del archivo adjuntotitle(cadena): Título del archivo adjunto
Entradas opcionales:
subtitle(cadena): subtítulo para el archivo adjuntoicon(cadena): URL del icono para adjuntar
linear_get_attachments: Obtener archivos adjuntos para un problema
Entradas requeridas:
issueId(cadena): ID del problema para el que se obtendrán los archivos adjuntos
Herramientas de relación de problemas
linear_link_issues: Crea una relación entre problemas
Entradas requeridas:
issueId(cadena): ID del problema de origenrelatedIssueId(cadena): ID del problema de destinotype(cadena): Tipo de relación (por ejemplo, "bloques", "relacionado", "duplicado")
linear_get_issue_relations: Obtener relaciones para un problema
Entradas requeridas:
issueId(cadena): ID del problema para obtener las relaciones
Entradas opcionales:
type(cadena): Filtrar por tipo de relación
Herramientas de gestión de hitos
linear_get_milestones: Obtener hitos para un proyecto
Entradas opcionales:
projectId(cadena): Filtrar hitos por proyectoincludeArchived(booleano): incluye hitos archivadoslimit(número, predeterminado: 50): número máximo de hitos a devolver
linear_create_milestone: Crea un nuevo hito
Entradas requeridas:
name(cadena): nombre del hitoprojectId(cadena): ID del proyecto para crear el hito entargetDate(cadena): Fecha de finalización del objetivo (formato ISO)
Entradas opcionales:
description(cadena): Descripción del hitosortOrder(número): Posición en la lista de hitos
linear_update_milestone: Actualizar un hito existente
Entradas requeridas:
id(cadena): ID del hito a actualizar
Entradas opcionales:
name(cadena): nombre del nuevo hitotargetDate(cadena): Nueva fecha objetivodescription(cadena): Nueva descripciónstatus(cadena): Nuevo estado (por ejemplo, "planificado", "en progreso", "completado")
Recursos
linear-issue:///{issueId}: Ver detalles de problemas individualesDevuelve información del problema, incluido el título, la descripción, los comentarios y los metadatos.
linear-team:///{teamId}: Ver detalles del equipoDevuelve información del equipo, incluido nombre, clave, descripción y miembros.
linear-team:///{teamId}/issues: Ver problemas del equipoDevuelve todos los problemas de un equipo específico con información de estado y prioridad.
linear-project:///{projectId}: Ver detalles del proyectoDevuelve información del proyecto, incluido el nombre, la descripción, el progreso, el estado, el líder, los equipos y los cronogramas.
linear-project:///{projectId}/issues: Ver problemas del proyectoDevuelve todos los problemas de un proyecto específico con información de estado y asignación
linear-project:///{projectId}/milestones: Ver los hitos del proyectoDevuelve todos los hitos de un proyecto específico con información de progreso y estado.
linear-user:///{userId}/assigned: Ver los problemas asignados al usuarioDevuelve problemas asignados a un usuario específico con contexto de proyecto y equipo
linear-organization:: Ver información de la organizaciónDevuelve información a nivel de organización, incluido el nombre y la configuración.
linear-viewer:: Ver el contexto actual del usuarioDevuelve información sobre el usuario autenticado
linear-viewer:///teams: Ver equipos para el usuario autenticadoDevuelve todos los equipos de los que es miembro el usuario actual
linear-viewer:///projects: Ver proyectos para el usuario autenticadoDevuelve todos los proyectos en los que está involucrado el usuario actual (como líder o miembro)
linear-viewer:///assigned: Ver los problemas asignados al usuario autenticadoDevuelve todos los problemas asignados al usuario actual con el contexto del proyecto y del equipo.
linear-label:///{labelId}: Ver detalles de la etiquetaDevuelve información de la etiqueta, incluido el nombre, el color y los problemas asociados.
Ejemplos de uso
A continuación se muestran ejemplos de indicaciones que puede utilizar con Claude Desktop para interactuar con Linear:
Gestión de problemas
"Crear un nuevo informe de error para el sistema de autenticación" → utilice
linear_create_issuepara crear un nuevo problema con los detalles apropiados"Actualizar la prioridad del ticket FRONT-123 a urgente" → utilice
linear_update_issuepara modificar la prioridad de un problema existente"Agregar un comentario al error de la página de inicio de sesión explicando la causa raíz" → use
linear_add_commentpara agregar información a un problema existente
Encontrar y filtrar problemas
"Muéstrame todos mis problemas de alta prioridad" → usa
linear_get_user_issuesolinear-viewer:///assignedpara encontrar problemas asignados a ti con alta prioridad"Buscar todas las tareas de frontend en curso" → use
linear_search_issuespara localizar problemas relacionados con el frontend con estado "en curso"."¿Qué problemas tiene asignados Sarah actualmente?" → usa
linear_get_user_issuescon el ID de Sarah para ver sus tareas.
Gestión de equipos y proyectos
"¿De qué equipos soy miembro?" → use
linear_get_user_teamsolinear-viewer:///teamspara listar todos los equipos a los que pertenece el usuario autenticado"Muéstrame los proyectos que estoy liderando o a los que contribuyo" → usa
linear_get_user_projectsolinear-viewer:///projectspara obtener todos los proyectos asociados con el usuario actual"¿Cuál es el progreso actual del proyecto de la aplicación móvil?" → Use
linear_get_projectpara obtener información detallada sobre el proyecto, incluido el progreso."Enumerar todos los proyectos activos del equipo de Frontend" → combinar
linear_get_teampara encontrar el ID del equipo ylinear_get_projectscon el filtro de equipo para localizar proyectos activos
Análisis del estado y la carga de trabajo
"Proporcione un resumen de las actualizaciones recientes sobre los problemas del sistema de facturación" → utilice
linear_search_issuespara identificar los problemas relevantes y, luego,linear-issue:///{issueId}para obtener los detalles del problema."¿Cuál es la carga de trabajo actual del equipo móvil?" → Use
linear-team:///{teamId}/issuesolinear_get_team_issuespara analizar la distribución de problemas en el equipo."Muéstrame mi rol y responsabilidades en la organización" → usa
linear_get_viewerylinear-viewer:///teamspara analizar las membresías y roles del equipo
Etiqueta y categorización
"Crear una etiqueta de 'seguridad' para problemas de seguridad de alta prioridad" → usar
linear_create_labelpara crear una nueva etiqueta con la configuración adecuada"¿Qué etiquetas están disponibles en el equipo de frontend?" → Use
linear_get_labelscon el ID del equipo de frontend para ver las categorizaciones disponibles."Aplicar la etiqueta 'necesita documentación' a todos los problemas de la API" → usar
linear_search_issuespara encontrar problemas relacionados con la API y luego actualizar cada uno conlinear_update_issue
Gestión de hitos
"Crear un hito para la versión beta" → use
linear_create_milestonepara establecer un hito del proyecto con una fecha objetivo"¿Qué hitos se avecinan en el proyecto de la aplicación móvil?" → Use
linear_get_milestonescon el ID del proyecto para ver los puntos de entrega planificados."Actualizar el estado del hito de la API v2 a completado" → usar
linear_update_milestonepara cambiar el estado del hito
Relaciones de problemas
"Marcar el problema FRONT-123 como API-456 de bloqueo" → usar
linear_link_issuespara crear una relación de bloqueo entre problemas"¿Qué problemas están siendo bloqueados por este error?" → usar
linear_get_issue_relationspara encontrar dependencias"Muéstrame todos los problemas relacionados con el sistema de autenticación" → usa
linear_search_issuescon los filtros adecuados y luego explora las relaciones conlinear_get_issue_relations
Desarrollo
Instalar dependencias:
Configurar la clave API lineal en
.env:
Construir el servidor:
Para desarrollo con reconstrucción automática:
Licencia
Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.