Integrations
Interfaces with Linear's GraphQL API, enabling structured queries and mutations for accessing and manipulating data in the Linear platform.
Provides integration with Linear's issue tracking system, allowing management of issues, teams, projects, labels, milestones, and attachments. Supports creating and updating issues, adding comments, searching and filtering issues, managing relationships between issues, and accessing detailed information about teams, projects, and users.
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
- MacOS:
Componentes
Herramientas
Herramientas relacionadas con el usuario
linear_get_viewer
: Obtener información sobre el usuario autenticado- No 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 usuario- Entradas opcionales:
userId
(cadena): ID de usuario (omitir para usuario autenticado)includeArchived
(booleano): incluye problemas archivadoslimit
(número, predeterminado: 50): Máximo de resultados
- Entradas opcionales:
linear_get_user_teams
: Obtener los equipos asociados con un usuario- Entradas 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
- Entradas opcionales:
linear_get_user_projects
: Obtener proyectos asociados con un usuario- Entradas 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.
- Entradas opcionales:
Herramientas relacionadas con el equipo
linear_get_teams
: Obtener equipos en la organización- Entradas opcionales:
includeArchived
(booleano): incluye equipos archivadoslimit
(número, predeterminado: 50): Número máximo de equipos a devolver
- Entradas opcionales:
linear_get_team
: Obtener detalles sobre un equipo específico- Entradas requeridas:
teamId
(cadena): ID del equipo para obtener detalles
- Devuelve información del equipo, incluido nombre, clave, miembros y configuraciones.
- Entradas requeridas:
linear_get_team_issues
: Obtener problemas para un equipo específico- Entradas 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
- Entradas requeridas:
Herramientas relacionadas con el proyecto
linear_get_projects
: Obtener proyectos en la organización- Entradas 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
- Entradas opcionales:
linear_get_project
: Obtener detalles sobre un proyecto específico- Entradas 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.
- Entradas requeridas:
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 individuales- Devuelve información del problema, incluido el título, la descripción, los comentarios y los metadatos.
linear-team:///{teamId}
: Ver detalles del equipo- Devuelve información del equipo, incluido nombre, clave, descripción y miembros.
linear-team:///{teamId}/issues
: Ver problemas del equipo- Devuelve todos los problemas de un equipo específico con información de estado y prioridad.
linear-project:///{projectId}
: Ver detalles del proyecto- Devuelve 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 proyecto- Devuelve todos los problemas de un proyecto específico con información de estado y asignación
linear-project:///{projectId}/milestones
: Ver los hitos del proyecto- Devuelve todos los hitos de un proyecto específico con información de progreso y estado.
linear-user:///{userId}/assigned
: Ver los problemas asignados al usuario- Devuelve problemas asignados a un usuario específico con contexto de proyecto y equipo
linear-organization:
: Ver información de la organización- Devuelve información a nivel de organización, incluido el nombre y la configuración.
linear-viewer:
: Ver el contexto actual del usuario- Devuelve información sobre el usuario autenticado
linear-viewer:///teams
: Ver equipos para el usuario autenticado- Devuelve todos los equipos de los que es miembro el usuario actual
linear-viewer:///projects
: Ver proyectos para el usuario autenticado- Devuelve 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 autenticado- Devuelve todos los problemas asignados al usuario actual con el contexto del proyecto y del equipo.
linear-label:///{labelId}
: Ver detalles de la etiqueta- Devuelve 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_issue
para crear un nuevo problema con los detalles apropiados - "Actualizar la prioridad del ticket FRONT-123 a urgente" → utilice
linear_update_issue
para 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_comment
para agregar información a un problema existente
Encontrar y filtrar problemas
- "Muéstrame todos mis problemas de alta prioridad" → usa
linear_get_user_issues
olinear-viewer:///assigned
para encontrar problemas asignados a ti con alta prioridad - "Buscar todas las tareas de frontend en curso" → use
linear_search_issues
para localizar problemas relacionados con el frontend con estado "en curso". - "¿Qué problemas tiene asignados Sarah actualmente?" → usa
linear_get_user_issues
con el ID de Sarah para ver sus tareas.
Gestión de equipos y proyectos
- "¿De qué equipos soy miembro?" → use
linear_get_user_teams
olinear-viewer:///teams
para 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_projects
olinear-viewer:///projects
para 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_project
para obtener información detallada sobre el proyecto, incluido el progreso. - "Enumerar todos los proyectos activos del equipo de Frontend" → combinar
linear_get_team
para encontrar el ID del equipo ylinear_get_projects
con 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_issues
para 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}/issues
olinear_get_team_issues
para analizar la distribución de problemas en el equipo. - "Muéstrame mi rol y responsabilidades en la organización" → usa
linear_get_viewer
ylinear-viewer:///teams
para 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_label
para crear una nueva etiqueta con la configuración adecuada - "¿Qué etiquetas están disponibles en el equipo de frontend?" → Use
linear_get_labels
con 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_issues
para 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_milestone
para 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_milestones
con 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_milestone
para cambiar el estado del hito
Relaciones de problemas
- "Marcar el problema FRONT-123 como API-456 de bloqueo" → usar
linear_link_issues
para crear una relación de bloqueo entre problemas - "¿Qué problemas están siendo bloqueados por este error?" → usar
linear_get_issue_relations
para encontrar dependencias - "Muéstrame todos los problemas relacionados con el sistema de autenticación" → usa
linear_search_issues
con 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.
This server cannot be installed
Un servidor de protocolo de contexto de modelo que permite que grandes modelos de lenguaje interactúen con el sistema de seguimiento de problemas de Linear, lo que permite la gestión de problemas, proyectos, equipos y otros recursos de Linear.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.Last updated 5 days ago324288JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.Last updated 2 months ago151TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that integrates with Linear, enabling AI assistants to create, update, search, and comment on issues for project management and issue tracking.Last updated a month ago56PythonApache 2.0
- -security-license-qualityA Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.Last updated 2 months ago202TypeScript