Linear MCP Server

Linear MCP Server

Un servidor de Model Context Protocol para la Linear API.

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 mediante Smithery

Para instalar Linear Integration Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @gerbal/linear-mcp-server-1 --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",
        "@modelcontextprotocol/server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Componentes

Herramientas

1. linear_create_issue: Crear una nueva incidencia de Linear

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

2. linear_update_issue: Actualizar incidencias existentes

   • Entradas requeridas:
     • id (string): ID de la incidencia a actualizar
   • Entradas opcionales:
     • title (string): Nuevo título
     • description (string): Nueva descripción
     • priority (number, 0-4): Nueva prioridad
     • status (string): Nuevo nombre de estado

3. linear_search_issues: Buscar incidencias con filtrado flexible

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

4. linear_get_user_issues: Obtener incidencias asignadas a un usuario

   • Entradas opcionales:
     • userId (string): ID de usuario (omitir para el usuario autenticado)
     • includeArchived (boolean): Incluir incidencias archivadas
     • limit (number, default: 50): Resultados máximos

5. linear_add_comment: Añadir comentarios a incidencias

   • Entradas requeridas:
     • issueId (string): ID de la incidencia en la que comentar
     • body (string): Texto del comentario (soporta markdown)
   • Entradas opcionales:
     • createAsUser (string): Nombre de usuario personalizado
     • displayIconUrl (string): 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 alta prioridad" → ejecuta la herramienta search_issues y/o linear-user:///{userId}/assigned para encontrar incidencias asignadas a ti con prioridad 1

2. "Basándote en lo que ya 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 en 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 y comentarios recientes

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.