Servidor MCP lineal

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 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 :

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

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

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

Related MCP server: MCP Linear App

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 el equipo móvil.

Desarrollo

1. Instalar dependencias:

npm install

1. Configurar la clave API lineal en .env :

LINEAR_API_KEY=your_api_key_here

1. Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

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.