Skip to main content
Glama

Linear MCP Server

Servidor MCP lineal

Nota: Esta es una implementación personalizada. Para el servidor oficial de Cline Linear MCP, consulte cline/linear-mcp .

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona herramientas para interactuar con la API de Linear, lo que permite a los agentes de IA gestionar problemas, proyectos y equipos de forma programada a través de la plataforma Linear.

Características

  • Gestión de problemas
    • Cree nuevos problemas con propiedades personalizables (título, descripción, equipo, asignado, prioridad, etiquetas)
    • Enumere problemas con opciones de filtrado flexibles (equipo, asignado, estado)
    • Actualizar los problemas existentes (título, descripción, estado, cesionario, prioridad)
  • Gestión de equipos
    • Enumerar todos los equipos en el espacio de trabajo
    • Acceda a los detalles del equipo, incluidos ID, nombre, clave y descripción.
  • Gestión de proyectos
    • Enumere todos los proyectos con filtrado de equipo opcional
    • Ver detalles del proyecto, incluido el nombre, la descripción, el estado y los equipos asociados

Prerrequisitos

  • Node.js (v16 o superior)
  • Una cuenta lineal con acceso API
  • Clave API lineal con permisos adecuados

Inicio rápido

  1. Obtén tu clave API de Linear desde la Configuración para desarrolladores de Linear
  2. Ejecutar con su clave API:
LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

O configúrelo en su entorno:

export LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

Configuración de desarrollo

  1. Clonar el repositorio:
git clone [repository-url] cd linear-mcp
  1. Instalar dependencias:
npm install
  1. Construir el proyecto:
npm run build

Corriendo con Inspector

Para el desarrollo y la depuración local, puede utilizar el Inspector MCP:

  1. Instalar supergateway:
npm install -g supergateway
  1. Utilice el script run.sh incluido:
chmod +x run.sh LINEAR_API_KEY=your-api-key ./run.sh
  1. Acceder al Inspector:
    • Abra localhost:1337 en su navegador
    • El Inspector se conecta a través de eventos enviados por el servidor (SSE)
    • Pruebe y depure las llamadas a herramientas a través de la interfaz del Inspector

Configuración

Configure el servidor MCP en su archivo de configuración en función de su cliente:

Para Claude Desktop

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Ventanas: %APPDATA%/Claude/claude_desktop_config.json
{ "mcpServers": { "linear-mcp": { "command": "node", "args": ["/path/to/linear-mcp/build/index.js"], "env": { "LINEAR_API_KEY": "your-api-key-here" }, "disabled": false, "alwaysAllow": [] } } }

Para la extensión de VS Code (Cline)

Ubicación: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{ "mcpServers": { "linear-mcp": { "command": "node", "args": ["/path/to/linear-mcp/build/index.js"], "env": { "LINEAR_API_KEY": "your-api-key-here" }, "disabled": false, "alwaysAllow": [] } } }

Para el cursor ( cursor.sh )

Para Cursor, el servidor debe ejecutarse con la ruta completa:

node /Users/ibraheem/Projects/linear-mcp/build/index.js

Herramientas disponibles

crear_problema

Crea un nuevo problema en Linear.

{ title: string; // Required: Issue title description?: string; // Optional: Issue description (markdown supported) teamId: string; // Required: Team ID assigneeId?: string; // Optional: Assignee user ID priority?: number; // Optional: Priority (0-4) labels?: string[]; // Optional: Label IDs to apply }

lista_de_problemas

Enumera problemas con filtros opcionales.

{ teamId?: string; // Optional: Filter by team ID assigneeId?: string; // Optional: Filter by assignee ID status?: string; // Optional: Filter by status first?: number; // Optional: Number of issues to return (default: 50) }

problema de actualización

Actualiza un problema existente.

{ issueId: string; // Required: Issue ID title?: string; // Optional: New title description?: string; // Optional: New description status?: string; // Optional: New status assigneeId?: string; // Optional: New assignee ID priority?: number; // Optional: New priority (0-4) labels?: string[]; // Optional: Label IDs to apply to the issue }

lista_equipos

Enumera todos los equipos del espacio de trabajo. No se requieren parámetros.

lista_proyectos

Enumera todos los proyectos con filtrado opcional.

{ teamId?: string; // Optional: Filter by team ID first?: number; // Optional: Number of projects to return (default: 50) }

obtener_problema

Obtiene información detallada sobre un problema específico.

{ issueId: string; // Required: Issue ID }

Desarrollo

Para desarrollo con reconstrucción automática:

npm run watch

Manejo de errores

El servidor incluye un manejo integral de errores para:

  • Claves API no válidas
  • Faltan parámetros requeridos
  • Errores de API lineal
  • Solicitudes de herramientas no válidas

Todos los errores se formatean correctamente y se devuelven con mensajes descriptivos.

Detalles técnicos

Construido con:

  • Mecanografiado
  • SDK lineal (@linear/sdk v37.0.0)
  • Kit de desarrollo de software de MCP (@modelcontextprotocol/sdk v0.6.0)

El servidor utiliza stdio para la comunicación e implementa el Protocolo de Contexto de Modelo para una integración perfecta con agentes de IA.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Permite que los agentes de IA gestionen problemas, proyectos y equipos en la plataforma Linear mediante programación.

  1. Características
    1. Prerrequisitos
      1. Inicio rápido
        1. Configuración de desarrollo
          1. Corriendo con Inspector
            1. Configuración
              1. Para Claude Desktop
              2. Para la extensión de VS Code (Cline)
              3. Para el cursor ( cursor.sh )
            2. Herramientas disponibles
              1. crear\_problema
              2. lista\_de\_problemas
              3. problema de actualización
              4. lista\_equipos
              5. lista\_proyectos
              6. obtener\_problema
            3. Desarrollo
              1. Manejo de errores
                1. Detalles técnicos
                  1. Licencia

                    Related MCP Servers

                    • -
                      security
                      F
                      license
                      -
                      quality
                      Enables AI agent and task management using the CrewAI framework, allowing users to create and run agents and tasks in an automated workflow environment.
                      Last updated -
                      0
                      3
                      JavaScript
                    • -
                      security
                      F
                      license
                      -
                      quality
                      Enables AI models to interact with Linear for issue tracking and project management through capabilities like creating/searching issues, managing sprints, and retrieving workflow states.
                      Last updated -
                      TypeScript
                    • A
                      security
                      A
                      license
                      A
                      quality
                      Provides tools for interacting with Targetprocess, a project management and agile planning platform, enabling AI assistants to search, create, and update project entities with proper validation.
                      Last updated -
                      5
                      TypeScript
                      MIT License
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.
                      Last updated -
                      TypeScript
                      • Apple
                      • Linux

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/ibraheem4/linear-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server