Linear MCP Server

Servidor Linear MCP

NOTA IMPORTANTE: Este servidor MCP está obsoleto y ya no recibe mantenimiento. Recomiendo usar el servidor MCP remoto oficial de Linear aquí: https://linear.app/changelog/2025-05-01-mcp (https://mcp.linear.app/sse)

Un servidor Model Context Protocol para la API de Linear.

Este servidor proporciona integración con el sistema de seguimiento de incidencias de Linear a través de MCP, permitiendo que los LLM interactúen con las incidencias de Linear.

Instalación

Instalación automática

Para instalar el servidor Linear MCP para Claude Desktop automáticamente a través de Smithery:

npx @smithery/cli install linear-mcp-server --client claude

Instalación manual

1. Crea u obtén una clave de API de Linear para tu equipo: https://linear.app/YOUR-TEAM/settings/api

2. Añade la configuración del servidor a Claude Desktop:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Componentes

Herramientas

1. linear_create_issue: Crear nuevas incidencias de Linear

   • Entradas requeridas:
     • title (cadena): Título de la incidencia
     • teamId (cadena): ID del equipo en el que crear la incidencia
   • Entradas opcionales:
     • description (cadena): Descripción de la incidencia (soporta markdown)
     • priority (número, 0-4): Nivel de prioridad (1=urgente, 4=baja)
     • status (cadena): Nombre del estado inicial

2. linear_update_issue: Actualizar incidencias existentes

   • Entradas requeridas:
     • id (cadena): ID de la incidencia 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: Buscar incidencias con filtrado flexible

   • Entradas opcionales:
     • query (cadena): Texto para buscar en título/descripción
     • teamId (cadena): Filtrar por equipo
     • status (cadena): Filtrar por estado
     • assigneeId (cadena): Filtrar por asignado
     • labels (cadena[]): Filtrar por etiquetas
     • priority (número): Filtrar por prioridad
     • limit (número, predeterminado: 10): Resultados máximos

4. linear_get_user_issues: Obtener incidencias asignadas a un usuario

   • Entradas opcionales:
     • userId (cadena): ID del usuario (omitir para el usuario autenticado)
     • includeArchived (booleano): Incluir incidencias archivadas
     • limit (número, predeterminado: 50): Resultados máximos

5. linear_add_comment: Añadir comentarios a incidencias

   • Entradas requeridas:
     • issueId (cadena): ID de la incidencia para comentar
     • body (cadena): Texto del comentario (soporta markdown)
   • Entradas opcionales:
     • createAsUser (cadena): Nombre de usuario personalizado
     • displayIconUrl (cadena): URL de avatar personalizado

Recursos

• linear-issue:///{issueId} - Ver detalles de una incidencia individual
• linear-team:///{teamId}/issues - Ver incidencias del equipo
• linear-user:///{userId}/assigned - Ver incidencias asignadas al usuario
• linear-organization: - Ver información de la organización
• linear-viewer: - Ver contexto del usuario actual

Ejemplos de uso

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

1. "Muéstrame todas mis incidencias de prioridad alta" → ejecuta la herramienta search_issues y/o linear-user:///{userId}/assigned para encontrar incidencias asignadas a ti con prioridad 1

2. "Basándome en lo que te he contado sobre este error, crea un informe de error para el sistema de autenticación" → usa create_issue para crear una nueva incidencia de alta prioridad con los detalles apropiados y seguimiento de estado

3. "Encuentra todas las tareas de frontend en progreso" → usa search_issues para localizar incidencias relacionadas con frontend con tarea en progreso

4. "Dame un resumen de las actualizaciones recientes sobre las incidencias para el desarrollo de la aplicación móvil" → usa search_issues para identificar la(s) incidencia(s) relevante(s), luego linear-issue:///{issueId} obtén los detalles de la incidencia y muestra la actividad reciente y los comentarios

5. "¿Cuál es la carga de trabajo actual para el equipo móvil?" → combina linear-team:///{teamId}/issues y search_issues para analizar la distribución de incidencias y prioridades en el equipo móvil

Desarrollo

1. Instala las dependencias:

npm install

1. Configura la clave de API de Linear en .env:

LINEAR_API_KEY=your_api_key_here

1. Compila el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.