Linear의 API와 상호작용하기 위한 MCP 서버입니다. 이 서버는 Cline을 통해 Linear 이슈, 프로젝트 및 팀을 관리할 수 있는 도구 세트를 제공합니다.

설정 가이드

1. 환경 설정

1. 저장소 복제

2. 의존성 설치:

3. .env.example를 .env로 복사하기:

2. 인증

서버는 두 가지 인증 방식을 지원합니다:

API 키 (권장)

1. 선형 설정으로 이동
2. “보안 및 접근” 섹션으로 이동하세요
3. “개인 API 키” 섹션 찾기
4. “새 API 키” 클릭
5. 키에 설명 라벨(예: “클라인 MCP”)을 붙인다
6. 생성된 토큰을 즉시 복사합니다
7. 토큰을 .env 파일에 추가:

OAuth Flow (대안) 구현되지 않음

1. [[T3]에서 OAuth 애플리케이션 생성
2. .env에서 OAuth 환경 변수를 구성하기:

3. 서버 운영

1. 서버 구축:

2. 서버 시작:

4. 클라인 적분

1. Cline MCP 설정 파일을 열어보세요:

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: '%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.

Linear MCP Server

An MCP server for interacting with Linear’s API. This server provides a set of tools for managing Linear issues, projects, and teams through Cline.

Setup Guide

1. Environment Setup

1. Clone the repository
2. Install dependencies:

   npm install
   

3. Copy .env.example to .env:

   cp .env.example .env
   

2. Authentication

The server supports two authentication methods:

API Key (Recommended)

1. Go to Linear Settings
2. Navigate to the “Security & access” section
3. Find the “Personal API keys” section
4. Click “New API key”
5. Give the key a descriptive label (e.g. “Cline MCP”)
6. Copy the generated token immediately
7. Add the token to your .env file:

   LINEAR_API_KEY=your_api_key
   

OAuth Flow (Alternative) NOT IMPLEMENTED

1. Create an OAuth application at https://linear.app/settings/api/applications
2. Configure OAuth environment variables in .env:

   LINEAR_CLIENT_ID=your_oauth_client_id
   LINEAR_CLIENT_SECRET=your_oauth_client_secret
   LINEAR_REDIRECT_URI=http://localhost:3000/callback
   

3. Running the Server

1. Build the server:

   npm run build
   

2. Start the server:

   npm start
   

4. Cline Integration

1. Open your Cline MCP settings file:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Add the Linear MCP server configuration:

   {
     "mcpServers": {
       "linear": {
         "command": "node",
         "args": ["/path/to/linear-mcp/build/index.js"],
         "env": {
           "LINEAR_API_KEY": "your_personal_access_token"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

Available Actions

The server currently supports the following operations:

Issue Management

• ✅ Create issues with full field support (title, description, team, project, etc.)
• ✅ Update existing issues (priority, description, etc.)
• ✅ Delete issues (single or bulk deletion)
• ✅ Search issues with filtering
• ✅ Associate issues with projects
• ✅ Create parent/child issue relationships
• ✅ Read and create comments and threaded comments

Project Management

• ✅ Create projects with associated issues
• ✅ Get project information with rich text descriptions
• ✅ Search projects with rich text descriptions
• ✅ Associate issues with projects
• ✅ Proper description handling using Linear’s documentContent field

Team Management

• ✅ Get team information (with states and workflow details)
• ✅ Access team states and labels

Authentication

• ✅ API Key authentication
• ✅ Secure token storage

Batch Operations

• ✅ Bulk issue creation