Servidor MCP lineal

Una implementación de servidor de Protocolo de contexto de modelo lineal (MCP) que proporciona una interfaz MCP para acceder a recursos lineales.

Configuración con cursor

1. Clonar el repositorio e instalar las dependencias:

git clone git@github.com:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

2. Crear un script de inicio:

# Create linear.sh
touch linear.sh
chmod +x linear.sh

# Add the following content
export LINEAR_API_KEY="<YOUR LINEAR API KEY>"
node /absolute/path/to/linear-mcp-server/index.js

3. Configurar en Cursor:

• Abrir la configuración del cursor

• Agregar un nuevo servidor en la sección Servidor MCP

• Seleccionar tipo: Command

• Comando de configuración: sh /absolute/path/to/linear.sh

Ahora puedes utilizar el servidor Linear MCP desde Cursor.

Puede obtener su clave API de Linear desde la página de configuración de Linear .

3. Iniciar el servidor:

npm start

Related MCP server: MCP Linear.app Server

Herramientas disponibles

crear problema

Cree un nuevo problema lineal con los parámetros especificados:

• title (obligatorio): Título del problema

• teamId (obligatorio): ID del equipo

• description (opcional): Descripción del problema

• priority (opcional): Prioridad del problema (0: Sin prioridad, 1: Urgente, 2: Alta, 3: Media, 4: Baja)

• stateId (opcional): ID del estado

• assigneeId (opcional): ID del cesionario

• estimate (opcional): Estimación de emisión

• labelIds (opcional): Matriz de ID de etiquetas

problemas de búsqueda

Busque problemas lineales mediante una cadena de consulta. Admite varios filtros:

• assignee:@me : Mostrar los problemas que se te asignaron

• priority:[value] : Filtrar por prioridad

  • Valores numéricos (0-4)

  • Valores de texto: "no", "urgente", "alto", "medio", "bajo"

  • Nota: priority:high incluye problemas de prioridad urgente y alta.

• state:[value] o status:[value] : Filtrar por nombre de estado

• team:[value] : Filtrar por nombre del equipo

• label:[value] : Filtrar por nombre de etiqueta

• Búsqueda de texto libre para título y descripción

recurso de lectura

Leer recursos lineales mediante URI:

• linear://organization - Detalles de la organización

• linear://issues - Lista de problemas

• linear://issues/{id} - Detalles específicos del problema

• linear://teams - Lista de equipos

• linear://teams/{id} - Detalles específicos del equipo

Limitación de velocidad

El servidor implementa la limitación de velocidad con:

• Límite de 1000 solicitudes por hora

• Seguimiento automático de solicitudes

• Métricas incluidas en cada respuesta

Manejo de errores

El servidor proporciona mensajes de error detallados para:

• Errores de API lineal

• Límite de velocidad excedido

• Tipos de recursos no válidos

• Problemas de autenticación