Linear MCP

Servidor Linear MCP

Una implementación del servidor del Model Context Protocol (MCP) para la API GraphQL de Linear que permite a los asistentes de IA interactuar con los sistemas de gestión de proyectos de Linear.

Características

• Acceso a la API GraphQL de Linear a través de herramientas MCP
• Autenticación mediante clave de API de Linear
• 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

Instalación

Instalación mediante Smithery (Recomendado)

Para instalar Linear MCP Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @emmett.deen/linear-mcp-server --client claude

Configuración Manual

Después de la instalación, agregue lo siguiente a su archivo de configuración de MCP:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@emmett.deen/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Ubicaciones de Configuración Específicas del Cliente

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Extensión Claude VSCode: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• GoMCP: ~/.config/gomcp/config.yaml

Instalación Manual

1. Clone el repositorio

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. Instale las dependencias

npm install

3. Compile el proyecto

npm run build

4. Cree un archivo .env con su token de API de Linear

LINEAR_API_KEY=your_linear_api_key_here

5. Inicie el servidor

npm start

Herramientas Disponibles

Consulte TOOLS.md para obtener una lista completa de las herramientas disponibles y las características planificadas.

Descripción General

Linear-MCP-Server une la brecha entre Claude (asistente de IA) y Linear (herramienta de gestión de proyectos) implementando el protocolo MCP. Esto permite que Claude:

• Recupere problemas, proyectos, equipos y otros datos de Linear
• Cree y actualice problemas
• Cambie el estado de los problemas
• Asigne problemas a miembros del equipo
• Agregue comentarios
• Cree proyectos y equipos

El servidor utiliza la API GraphQL de Linear y se autentica mediante tokens de usuario (no OAuth) para mayor simplicidad.

Primeros Pasos

Requisitos Previos

• Node.js (v18+)
• NPM o Yarn
• Token de API de Linear

Instalación

# Install globally
npm install -g @emmett.deen/linear-mcp-server

# Or clone and install locally
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server
npm install
npm link  # Makes the package available globally

Ejecutar el Servidor

Ejecute el servidor con su token de API de Linear:

linear-mcp-server --token YOUR_LINEAR_API_TOKEN

O configure el token en su entorno y ejecute sin argumentos:

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
linear-mcp-server

Uso con Claude Desktop

Para usar este servidor MCP con Claude Desktop:

1. Habilite el Modo Desarrollador en Claude Desktop (desde la barra de menú)
2. Vaya a Configuración > Opciones de desarrollador
3. Haga clic en "Agregar servidor"
4. Configure con los siguientes ajustes:
   • Nombre: Linear MCP Server
   • Tipo: Proceso local
   • Comando: linear-mcp-server
   • Argumentos: --token SU_TOKEN_DE_API_DE_LINEAR

Alternativamente, edite manualmente el archivo de configuración:

{
  "mcp": {
    "servers": [
      {
        "name": "Linear MCP Server",
        "transport": {
          "type": "stdio",
          "command": "linear-mcp-server",
          "args": ["--token", "YOUR_LINEAR_API_TOKEN"]
        }
      }
    ]
  }
}

5. Guarde la configuración
6. Reinicie Claude Desktop (salga completamente y vuelva a abrir)
7. Ahora debería ver Linear MCP Server disponible como herramienta en Claude

Ejemplos de Prompts para Claude

Una vez conectado a Claude Desktop, puede usar prompts como:

• "Muéstrame todos mis problemas de Linear"
• "Crea un nuevo problema titulado 'Corregir error de inicio de sesión' en el equipo Frontend"
• "Cambia el estado del problema FE-123 a 'En progreso'"
• "Asigna el problema BE-456 a John Smith"
• "Agrega un comentario al problema UI-789: 'Esto debe corregirse antes del viernes'"

Desarrollo

Para desarrollar localmente:

# Clone the repository
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

# Install dependencies
npm install

# Run in development mode
npm run dev -- --token YOUR_LINEAR_API_TOKEN

Extender el Servidor

Para agregar nuevas herramientas al servidor:

1. Siga la guía de implementación en el documento TOOLS.md
2. Asegúrese de seguir la estructura de código establecida en el directorio src/
3. Actualice la documentación para reflejar sus cambios

Desarrollo y Contribuciones

Configurar el Entorno de Desarrollo

1. Clone el repositorio

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. Instale las dependencias

npm install

3. Inicie en modo de desarrollo

npm run dev

Publicar en npm

Para publicar este paquete en npm:

1. Actualice la versión en package.json

npm version patch  # or minor, or major

2. Compile el proyecto

npm run build

3. Asegúrese de haber iniciado sesión en npm

npm login

4. Publique en npm

npm publish --access public

5. 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 LICENSE para obtener más detalles.