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 mediante herrería

Para instalar Linear Integration Server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

1. Cree u obtenga una clave API lineal para su equipo: https://linear.app/YOUR-TEAM/settings/api
2. Agregar configuración de servidor a Claude Desktop:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Componentes

Herramientas

1. linear_create_issue : Crea un nuevo problema lineal
   • Entradas requeridas:
     • title (cadena): Título del problema
     • teamId (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
2. linear_update_issue : Actualizar problemas existentes
   • Entradas requeridas:
     • id (cadena): ID del problema a actualizar
   • Entradas opcionales:
     • title (cadena): Nuevo título
     • description (cadena): Nueva descripción
     • priority (número, 0-4): Nueva prioridad
     • status (cadena): nuevo nombre de estado
3. linear_search_issues : Problemas de búsqueda con filtrado flexible
   • Entradas opcionales:
     • query (cadena): Texto a buscar en el título/descripción
     • teamId (cadena): Filtrar por equipo
     • status (cadena): Filtrar por estado
     • assigneeId (cadena): Filtrar por cesionario
     • labels (string[]): Filtrar por etiquetas
     • priority (número): Filtrar por prioridad
     • limit (número, predeterminado: 10): Máximo de resultados
4. 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 archivados
     • limit (número, predeterminado: 50): Máximo de resultados
5. linear_add_comment : Agregar comentarios a los problemas
   • Entradas requeridas:
     • issueId (cadena): ID del problema sobre el que se realizará el comentario
     • body (cadena): Texto del comentario (compatible con Markdown)
   • Entradas opcionales:
     • createAsUser (cadena): nombre de usuario personalizado
     • displayIconUrl (cadena): URL de avatar personalizada

Recursos

• linear-issue:///{issueId} - Ver detalles de problemas individuales
• linear-team:///{teamId}/issues - Ver problemas del equipo
• linear-user:///{userId}/assigned - Ver los problemas asignados al usuario
• linear-organization: - Ver información de la organización
• linear-viewer: - Ver el contexto actual del usuario

Ejemplos de uso

Algunos ejemplos de indicaciones que puedes usar con Claude Desktop para interactuar con Linear:

1. "Muéstrame todos mis problemas de alta prioridad" → ejecuta la herramienta search_issues y/o linear-user:///{userId}/assigned para encontrar los problemas que te fueron asignados con prioridad 1
2. "Con base en lo que ya le comenté sobre este error, cree un informe de error para el sistema de autenticación" → use create_issue para crear un nuevo problema de alta prioridad con los detalles apropiados y el seguimiento del estado
3. "Buscar todas las tareas de frontend en curso" → use search_issues para localizar problemas relacionados con el frontend con la tarea en curso
4. "Brinde un resumen de las actualizaciones recientes sobre los problemas para el desarrollo de aplicaciones móviles" → use search_issues para identificar los problemas relevantes, luego, linear-issue:///{issueId} obtenga los detalles del problema y muestre la actividad y los comentarios recientes.
5. "¿Cuál es la carga de trabajo actual del equipo móvil?" → Combine linear-team:///{teamId}/issues y search_issues para analizar la distribución y las prioridades de los problemas en todo el equipo móvil.

Desarrollo

1. Instalar dependencias:

1. Configurar la clave API lineal en .env :

1. 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.