선형 MCP 서버

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

선형 MCP 서버 npm 버전 대장간

특징

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

Related MCP server: MCP Linear App

설치

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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Linear MCP Server