선형 MCP 서버

참고: 이는 사용자 지정 구현입니다. 공식 Cline Linear MCP 서버는 cline/linear-mcp 를 참조하세요.

Linear의 API와 상호 작용하기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버로, AI 에이전트가 Linear 플랫폼을 통해 문제, 프로젝트 및 팀을 프로그래밍 방식으로 관리할 수 있도록 합니다.

특징

이슈 관리
- 사용자 정의 가능한 속성(제목, 설명, 팀, 담당자, 우선순위, 레이블)을 사용하여 새로운 이슈를 생성합니다.
- 유연한 필터링 옵션(팀, 담당자, 상태)을 사용하여 문제 목록 작성
- 기존 문제 업데이트(제목, 설명, 상태, 담당자, 우선순위)
팀 관리
- 작업 공간에 있는 모든 팀을 나열합니다.
- ID, 이름, 키, 설명을 포함한 팀 세부 정보에 액세스하세요.
프로젝트 관리
- 선택적 팀 필터링을 사용하여 모든 프로젝트를 나열합니다.
- 이름, 설명, 상태 및 관련 팀을 포함한 프로젝트 세부 정보를 확인하세요.

필수 조건

Node.js(v16 이상)
API 액세스가 가능한 선형 계정
적절한 권한이 있는 선형 API 키

빠른 시작

Linear 개발자 설정 에서 Linear API 키를 받으세요
API 키로 실행하세요:

지엑스피1

또는 환경에 설정하세요:

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

개발 설정

저장소를 복제합니다.

git clone [repository-url]
cd linear-mcp

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

Inspector로 실행

로컬 개발 및 디버깅을 위해 MCP Inspector를 사용할 수 있습니다.

Supergateway 설치:

npm install -g supergateway

포함된 run.sh 스크립트를 사용하세요.

chmod +x run.sh
LINEAR_API_KEY=your-api-key ./run.sh

검사기에 접속하세요:
- 브라우저에서 localhost:1337을 엽니다.
- 검사기는 SSE(Server-Sent Events)를 통해 연결합니다.
- Inspector 인터페이스를 통한 테스트 및 디버그 도구 호출

구성

클라이언트에 따라 설정 파일에서 MCP 서버를 구성하세요.

클로드 데스크탑용

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우: %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": []
    }
  }
}

VS Code 확장 프로그램(Cline)

위치: ~/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": []
    }
  }
}

커서( cursor.sh )에 대하여

커서의 경우 서버는 전체 경로로 실행되어야 합니다.

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

사용 가능한 도구

이슈 생성

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
}

목록_문제

선택적 필터와 관련된 문제를 나열합니다.

{
  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)
}

업데이트_문제

기존 문제를 업데이트합니다.

{
  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)
}

팀 목록

작업 공간의 모든 팀을 나열합니다. 매개변수는 필요하지 않습니다.

프로젝트 목록

선택적 필터링을 통해 모든 프로젝트를 나열합니다.

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

get_issue

특정 문제에 대한 자세한 정보를 얻습니다.

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

개발

자동 재빌드를 사용한 개발의 경우:

npm run watch

오류 처리

서버에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

잘못된 API 키
필수 매개변수가 없습니다
선형 API 오류
잘못된 도구 요청

모든 오류는 올바르게 형식화되어 설명 메시지와 함께 반환됩니다.

기술적 세부 사항

다음으로 구성됨:

타입스크립트
선형 SDK (@linear/sdk v37.0.0)
MCP SDK (@modelcontextprotocol/sdk v0.6.0)

서버는 통신에 stdio를 사용하고 AI 에이전트와의 원활한 통합을 위해 모델 컨텍스트 프로토콜을 구현합니다.

특허

MIT

Linear MCP Server

Integrations