Servidor MCP lineal
Una implementación de servidor de Protocolo de contexto de modelo (MCP) para la API GraphQL lineal que permite a los asistentes de IA interactuar con los sistemas de gestión de proyectos lineales.
Características
Acceso a la API GraphQL de Linear a través de herramientas MCP
Autenticación mediante clave API lineal
Recuperar y modificar datos relacionados con usuarios, equipos, proyectos y problemas.
Crear, actualizar y comentar problemas
Agregar y eliminar etiquetas
Crear proyectos
Documentación completa de las herramientas disponibles
Related MCP server: MCP Linear App
Instalación
Instalación mediante herrería (recomendado)
Para instalar Linear MCP Server para Claude Desktop automáticamente a través de Smithery:
Configuración manual
Después de la instalación, agregue lo siguiente a su archivo de configuración de MCP:
Ubicaciones de configuración específicas del cliente
Escritorio de Claude:
~/Library/Application Support/Claude/claude_desktop_config.jsonExtensión VSCode de Claude:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonGoMCP:
~/.config/gomcp/config.yaml
Instalación manual
Clonar el repositorio
Instalar dependencias
Construir el proyecto
Cree un archivo
.envcon su token de API lineal
Iniciar el servidor
Herramientas disponibles
Consulte TOOLS.md para obtener una lista completa de las herramientas disponibles y las funciones planificadas.
Descripción general
Linear-MCP-Server conecta a Claude (asistente de IA) con Linear (herramienta de gestión de proyectos) mediante la implementación del protocolo MCP. Esto permite a Claude:
Recupere problemas, proyectos, equipos y otros datos de Linear
Crear y actualizar problemas
Cambiar el estado del problema
Asignar problemas a los miembros del equipo
Añadir comentarios
Crear proyectos y equipos
El servidor utiliza la API GraphQL de Linear y se autentica a través de tokens de usuario (no OAuth) para simplificar.
Empezando
Prerrequisitos
Node.js (versión 18+)
NPM o Hilo
Token de API lineal
Instalación
Ejecución del servidor
Ejecute el servidor con su token de API lineal:
O configure el token en su entorno y ejecútelo sin argumentos:
Uso con Claude Desktop
Para utilizar este servidor MCP con Claude Desktop:
Habilitar el modo de desarrollador en Claude Desktop (desde la barra de menú)
Vaya a Configuración > Opciones de desarrollador
Haga clic en "Agregar servidor"
Configure con los siguientes ajustes:
Nombre : Servidor MCP lineal
Tipo : Proceso local
Comando : linear-mcp-server
Argumentos : --token SU_TOKEN_API_LINEAL
Alternativamente, edite manualmente el archivo de configuración:
Guardar la configuración
Reinicie Claude Desktop (ciérrelo por completo y vuelva a abrirlo)
Ahora debería ver Linear MCP Server disponible como herramienta en Claude
Ejemplo de indicaciones de Claude
Una vez conectado a Claude Desktop, podrá utilizar indicaciones como:
"Muéstrame todos mis problemas lineales"
Crear un nuevo problema titulado "Corregir error de inicio de sesión" en el equipo de Frontend.
Cambiar el estado del problema FE-123 a 'En proceso'
Asignar el problema BE-456 a John Smith
Añadir un comentario al problema UI-789: "Esto debe solucionarse antes del viernes".
Desarrollo
Para desarrollar localmente:
Ampliación del servidor
Para agregar nuevas herramientas al servidor:
Siga la guía de implementación en el documento TOOLS.md
Asegúrese de seguir la estructura de código establecida en el directorio
src/Actualice la documentación para reflejar sus cambios
Desarrollando y contribuyendo
Configurar el entorno de desarrollo
Clonar el repositorio
Instalar dependencias
Iniciar en modo de desarrollo
Publicación en npm
Para publicar este paquete en npm:
Actualizar la versión en package.json
Construir el proyecto
Asegúrate de que ya hayas iniciado sesión en npm
Publicar en npm
Para el registro de Smithery, deberá trabajar con el equipo de Smithery para que su servidor aparezca en su catálogo.
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.