Linear MCP Integration Server

Integrations

  • Used for environment variable management, specifically to load the Linear API key for authentication with Linear's API.

  • Provides tools for interacting with Linear for issue tracking and project management, including creating issues, searching issues, retrieving sprint issues, searching teams, filtering sprint issues, and bulk updating issue statuses.

  • Supported in Linear issue descriptions, allowing rich text formatting when creating issues.

Servidor de integración MCP lineal

Este servidor proporciona capacidades de integración con Linear mediante el Protocolo de Contexto de Modelo (MCP). Permite que los modelos de IA interactúen con Linear para el seguimiento de problemas y la gestión de proyectos.

Características

El servidor proporciona las siguientes herramientas a través de la interfaz MCP:

problema de creación lineal

Crea un nuevo problema lineal con los siguientes parámetros:

  • title (obligatorio): Título del problema
  • teamId (obligatorio): ID del equipo para crear el problema
  • description (opcional): Descripción del problema (compatible con Markdown)
  • priority (opcional): Nivel de prioridad (0-4)
  • status (opcional): Nombre del estado inicial

problemas de búsqueda lineal

Buscar problemas lineales con filtrado flexible:

  • query (opcional): Texto a buscar en el título/descripción
  • teamId (opcional): Filtrar por equipo
  • status (opcional): Filtrar por estado
  • assigneeId (opcional): Filtrar por cesionario
  • priority (opcional): Nivel de prioridad (0-4)
  • limit (opcional, predeterminado: 10): Máximo de resultados a devolver

Problemas de sprint lineal

Obtener todos los problemas en el sprint/iteración actual:

  • teamId (obligatorio): ID del equipo para obtener los problemas del sprint

equipos de búsqueda lineal

Buscar y recuperar equipos lineales:

  • query (opcional): Texto para buscar en los nombres de los equipos

Problemas de sprint con filtros lineales

Filtra los problemas de sprint actuales por estado y filtra automáticamente al usuario actual:

  • teamId (obligatorio): ID del equipo para obtener los problemas del sprint
  • status (obligatorio): Estado por el que se filtrará (p. ej., "Pendiente de lanzamiento de producto")

estado de actualización masiva lineal

Actualizar el estado de varios problemas lineales a la vez:

  • issueIds (obligatorio): Lista de ID de problemas para actualizar (por ejemplo, ["ENG-123", "DATA-456"])
  • targetStatus (obligatorio): Estado objetivo que se establecerá para todos los problemas (por ejemplo, "En progreso")

Configuración del desarrollador

  1. Obtén tu clave API de Linear desde la sección API de configuración de Linear
  2. Cree un archivo .env en la raíz del proyecto:
LINEAR_API_KEY=your_api_key_here
  1. Instalar dependencias:
npm install
  1. Iniciar el servidor:
# Development mode with auto-reload npm run dev # Production mode npm start # Build TypeScript npm run build # Run linter npm run lint # Run tests npm run test # Inspect MCP server npm run inspect

Detalles técnicos

  • Desarrollado con TypeScript y el SDK del protocolo de contexto de modelo
  • Utiliza el SDK lineal para interacciones de API
  • Incluye manejo de errores, limitación de velocidad y administración de conexión.
  • Admite la reconexión automática con reintentos configurables
  • Implementa el monitoreo de latidos para la salud de la conexión
  • Proporciona un registro detallado en modo de depuración

Manejo de errores

El servidor incluye un manejo integral de errores:

  • Protección de tiempo de espera de API
  • Intentos de reconexión automática en caso de pérdida de conexión
  • Registro detallado de errores con marcas de tiempo
  • Manejo elegante del apagado
  • Monitoreo del ritmo cardíaco para la salud de la conexión

Dependencias

  • @linear/sdk : Cliente de API lineal
  • @modelcontextprotocol/sdk : Implementación del servidor MCP
  • zod : Comprobación y validación de tipos en tiempo de ejecución
  • dotenv : Gestión de variables de entorno
  • TypeScript y herramientas de desarrollo relacionadas

Para obtener la lista completa de dependencias, consulte package.json .

-
security - not tested
F
license - not found
-
quality - not tested

Permite que los modelos de IA interactúen con Linear para el seguimiento de problemas y la gestión de proyectos a través del Protocolo de contexto de modelo, lo que admite capacidades como la creación de problemas, la búsqueda, la gestión de sprints y la actualización masiva de estados.

  1. Features
    1. linear_create_issue
    2. linear_search_issues
    3. linear_sprint_issues
    4. linear_search_teams
    5. linear_filter_sprint_issues
    6. linear_bulk_update_status
  2. Developer Setup
    1. Technical Details
      1. Error Handling
        1. Dependencies
          ID: 95yu0123ap