선형 MCP 서버

AI 어시스턴트가 Linear 프로젝트 관리 시스템과 상호 작용할 수 있도록 하는 Linear GraphQL API를 위한 MCP(Model Context Protocol) 서버 구현입니다.

특징

MCP 도구를 통한 Linear의 GraphQL API에 액세스
선형 API 키를 통한 인증
사용자, 팀, 프로젝트 및 문제와 관련된 데이터를 검색하고 수정합니다.
이슈 생성, 업데이트 및 의견 제출
라벨 추가 및 제거
프로젝트 만들기
사용 가능한 도구에 대한 포괄적인 문서

설치

Smithery를 통해 설치(권장)

Smithery를 통해 Claude Desktop용 Linear MCP Server를 자동으로 설치하려면:

지엑스피1

수동 구성

설치 후 MCP 설정 파일에 다음을 추가하세요.

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

클라이언트별 구성 위치

Claude 데스크톱: ~/Library/Application Support/Claude/claude_desktop_config.json
Claude VSCode 확장: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
GoMCP: ~/.config/gomcp/config.yaml

수동 설치

저장소를 복제합니다

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

종속성 설치

npm install

프로젝트를 빌드하세요

npm run build

Linear API 토큰으로 .env 파일을 만듭니다.

LINEAR_API_KEY=your_linear_api_key_here

서버를 시작합니다

npm start

사용 가능한 도구

사용 가능한 도구와 계획된 기능의 전체 목록은 TOOLS.md를 참조하세요.

개요

Linear-MCP-Server는 MCP 프로토콜을 구현하여 Claude(AI 어시스턴트)와 Linear(프로젝트 관리 도구) 간의 격차를 해소합니다. 이를 통해 Claude는 다음과 같은 작업을 수행할 수 있습니다.

Linear에서 문제, 프로젝트, 팀 및 기타 데이터를 검색합니다.
문제 생성 및 업데이트
문제 상태 변경
팀원들에게 이슈 할당
댓글 추가
프로젝트와 팀을 만드세요

서버는 Linear의 GraphQL API를 사용하고 단순성을 위해 사용자 토큰(OAuth 아님)을 통해 인증합니다.

시작하기

필수 조건

Node.js(v18+)
NPM 또는 Yarn
선형 API 토큰

설치

# 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

서버 실행

Linear API 토큰으로 서버를 실행합니다.

linear-mcp-server --token YOUR_LINEAR_API_TOKEN

또는 환경에 토큰을 설정하고 인수 없이 실행합니다.

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
linear-mcp-server

Claude Desktop과 함께 사용

Claude Desktop과 함께 이 MCP 서버를 사용하려면:

Claude Desktop에서 개발자 모드 활성화(메뉴 표시줄에서)
설정 > 개발자 옵션으로 이동하세요
"서버 추가"를 클릭하세요
다음 설정으로 구성하세요.
- 이름 : 선형 MCP 서버
- 유형 : 로컬 프로세스
- 명령어 : linear-mcp-server
- 인수 : --token YOUR_LINEAR_API_TOKEN

또는 구성 파일을 수동으로 편집합니다.

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

구성을 저장합니다
Claude Desktop을 다시 시작합니다(완전히 종료하고 다시 엽니다).
이제 Claude에서 도구로 사용할 수 있는 Linear MCP Server가 표시됩니다.

클로드 프롬프트 예시

Claude Desktop에 연결되면 다음과 같은 프롬프트를 사용할 수 있습니다.

"내 모든 선형 문제를 보여주세요"
"프런트엔드 팀에 '로그인 버그 수정'이라는 제목의 새 이슈를 생성하세요."
"FE-123 문제의 상태를 '진행 중'으로 변경합니다."
"BE-456 문제를 John Smith에게 할당하세요"
"UI-789 문제에 주석을 추가하세요: '이 문제는 금요일까지 수정되어야 합니다'"

개발

지역적으로 개발하려면:

# 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

서버 확장

서버에 새로운 도구를 추가하려면:

TOOLS.md 문서의 구현 가이드를 따르세요.
src/ 디렉토리에 설정된 코드 구조를 따르도록 하세요.
변경 사항을 반영하도록 문서를 업데이트하세요.

개발 및 기여

개발 환경 설정

저장소를 복제합니다

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

종속성 설치

npm install

개발 모드로 시작

npm run dev

npm에 게시하기

이 패키지를 npm에 게시하려면:

package.json의 버전을 업데이트하세요

npm version patch  # or minor, or major

프로젝트를 빌드하세요

npm run build

npm에 이미 로그인했는지 확인하세요

npm login

npm에 게시

npm publish --access public

Smithery 레지스트리의 경우, Smithery 팀과 협력하여 서버를 카탈로그에 등록해야 합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.