Linear MCP Server

선형 MCP 서버

선형 API를 위한 모델 컨텍스트 프로토콜 서버입니다.

이 서버는 MCP를 통해 Linear의 문제 추적 시스템과 통합을 제공하여 LLM이 Linear 문제와 상호 작용할 수 있도록 합니다.

설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

1. 팀을 위한 Linear API 키를 생성하거나 받으세요: https://linear.app/YOUR-TEAM/settings/api
2. Claude Desktop에 서버 구성 추가:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

구성 요소

도구

1. linear_create_issue : 새로운 Linear 이슈를 생성합니다.
   • 필수 입력 사항:
     • title (문자열): 이슈 제목
     • teamId (문자열): 문제를 생성할 팀 ID
   • 선택 입력 사항:
     • description (문자열): 문제 설명(마크다운 지원)
     • priority (숫자, 0-4): 우선순위 수준(1=긴급, 4=낮음)
     • status (문자열): 초기 상태 이름
2. linear_update_issue : 기존 이슈 업데이트
   • 필수 입력 사항:
     • id (문자열): 업데이트할 문제 ID
   • 선택 입력 사항:
     • title (문자열): 새 제목
     • description (문자열): 새 설명
     • priority (숫자, 0-4): 새로운 우선순위
     • status (문자열): 새 상태 이름
3. linear_search_issues : 유연한 필터링을 통한 문제 검색
   • 선택 입력 사항:
     • query (문자열): 제목/설명에서 검색할 텍스트
     • teamId (문자열): 팀으로 필터링
     • status (문자열): 상태별 필터링
     • assigneeId (문자열): 담당자로 필터링
     • labels (string[]): 레이블로 필터링
     • priority (숫자): 우선순위로 필터링
     • limit (숫자, 기본값: 10): 최대 결과
4. linear_get_user_issues : 사용자에게 할당된 이슈를 가져옵니다.
   • 선택 입력 사항:
     • userId (문자열): 사용자 ID(인증된 사용자의 경우 생략)
     • includeArchived (부울): 보관된 이슈를 포함합니다.
     • limit (숫자, 기본값: 50): 최대 결과
5. linear_add_comment : 이슈에 댓글 추가
   • 필수 입력 사항:
     • issueId (문자열): 의견을 제시할 이슈 ID
     • body (문자열): 주석 텍스트(마크다운 지원)
   • 선택 입력 사항:
     • createAsUser (문자열): 사용자 정의 사용자 이름
     • displayIconUrl (문자열): 사용자 정의 아바타 URL

자원

• linear-issue:///{issueId} - 개별 이슈 세부 정보 보기
• linear-team:///{teamId}/issues - 팀 문제 보기
• linear-user:///{userId}/assigned - 사용자에게 할당된 문제 보기
• linear-organization: - 조직 정보 보기
• linear-viewer: - 현재 사용자 컨텍스트 보기

사용 예

Claude Desktop에서 Linear와 상호 작용하기 위해 사용할 수 있는 몇 가지 프롬프트 예는 다음과 같습니다.

1. "내 모든 높은 우선 순위 문제 표시" → search_issues 도구 및/또는 linear-user:///{userId}/assigned 를 실행하여 우선 순위 1로 할당된 문제를 찾습니다.
2. "이미 말씀드린 버그에 대한 내용을 바탕으로 인증 시스템에 대한 버그 보고서를 작성하세요" → create_issue 사용하여 적절한 세부 정보와 상태 추적을 통해 우선순위가 높은 새 이슈를 생성하세요.
3. "진행 중인 모든 프런트엔드 작업 찾기" → search_issues 사용하여 진행 중인 작업에서 프런트엔드 관련 문제를 찾습니다.
4. "모바일 앱 개발 이슈에 대한 최근 업데이트 요약을 알려주세요" → search_issues 사용하여 관련 이슈를 식별한 다음, linear-issue:///{issueId} 사용하여 이슈 세부 정보를 가져오고 최근 활동 및 댓글을 표시합니다.
5. "모바일 팀의 현재 업무량은 얼마입니까?" → linear-team:///{teamId}/issues 와 search_issues 결합하여 모바일 팀 전반의 문제 분포와 우선순위를 분석합니다.

개발

1. 종속성 설치:

1. .env 에서 Linear API 키 구성:

1. 서버를 빌드하세요:

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

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.