Linear MCP란?

Linear MCP는 AI 모델이 Linear 프로젝트 관리 도구에 직접 접근할 수 있게 해주는 MCP 서버입니다. 이슈 생성, 상태 업데이트, 스프린트 관리, 팀 워크로드 분석까지 프로젝트 관리의 반복 작업을 AI가 자동화합니다. Linear는 GraphQL 기반 API와 빠른 응답 속도로 유명하며, MCP와의 궁합이 특히 좋습니다. 이슈·프로젝트·사이클·라벨·팀이라는 명확한 데이터 모델 덕분에 AI가 컨텍스트를 이해하기 쉽고, 자연어 지시만으로 복잡한 필터링·업데이트가 가능합니다.

이전 편에서 Slack MCP로 커뮤니케이션을 다뤘다면, 이번에는 프로젝트 관리 영역을 자동화합니다. 현장의 대부분 팀은 매주 같은 질문을 반복합니다 — "이번 스프린트에 뭐가 남았지?", "누구한테 이슈가 몰렸지?", "블로커 있는 이슈는?" 이런 질문은 원래 PM이 손으로 대시보드를 돌아다니며 찾아야 했지만, Linear MCP가 붙으면 한 줄 자연어로 즉시 답변을 얻을 수 있습니다.

!mcp-guide-07-linear 본문 이미지 1

설정

Linear MCP의 설정은 다른 MCP 서버와 동일한 패턴을 따릅니다 — 커뮤니티 패키지 mcp-linear를 npx로 기동하고, LINEAR_API_KEY 환경 변수를 주입합니다. Linear는 Personal API Key와 OAuth 앱 두 가지 인증 경로를 모두 지원하는데, 개인 개발 환경에서는 Personal API Key가 가장 간단하고, 여러 사용자가 공유하는 환경에서는 OAuth 앱을 권장합니다.

Linear API Key 발급

Linear Settings > API에서 Personal API Key를 생성합니다

필요한 경우 Workspace별 OAuth 앱을 생성할 수도 있습니다

MCP 서버 등록

{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "mcp-linear"],
"env": {
"LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxx"
}
}
}
}

!스프린트 관리 자동화

핵심 도구

Linear MCP가 제공하는 도구는 크게 이슈 / 스프린트 / 팀 세 범주로 구분할 수 있습니다. 이슈 범주는 일상 작업의 약 70%를 차지하며, CRUD에 더해 코멘트·라벨·할당 변경까지 포함합니다. 스프린트 범주는 사이클(Cycle) 단위의 진행률·번다운·회고 데이터 수집에 쓰이고, 팀 범주는 워크로드 분배와 병목 탐지에 활용됩니다. 아래는 자주 쓰는 자연어 지시 패턴입니다.

이슈 관리

# 이슈 생성
claude "Linear에 새 이슈를 생성해줘:
제목 '로그인 페이지 반응형 레이아웃 수정',
우선순위 High, 라벨 'frontend', 팀 'Engineering'"

이슈 검색
claude "나에게 할당된 In Progress 상태의 이슈를 모두 보여줘"

이슈 업데이트
claude "이슈 ENG-142의 상태를 Done으로 변경하고,
'PR #87 머지 후 배포 완료' 코멘트를 추가해줘"

스프린트 관리

# 현재 스프린트 현황
claude "현재 활성 스프린트의 진행률, 남은 이슈 수,
팀원별 할당량을 요약해줘"

스프린트 회고 데이터 수집
claude "지난 스프린트에서 완료된 이슈, 이월된 이슈,
평균 완료 시간을 분석해줘"

팀 워크로드 분석

# 팀원별 업무량 분석
claude "Engineering 팀의 각 멤버별 할당된 이슈 수와
우선순위 분포를 표로 보여줘"

병목 탐지
claude "2주 이상 In Progress 상태에 머무는 이슈를 찾아줘"

!mcp-guide-07-linear 본문 이미지 2

실전 워크플로우: 자동 스프린트 리포트

Linear MCP의 가장 유용한 활용 사례는 주간/스프린트 리포트 자동 생성입니다.

claude "다음 내용으로 스프린트 리포트를 생성해줘:
완료된 이슈 목록 (담당자, 완료일)
진행 중인 이슈와 예상 완료일
블로커가 있는 이슈
다음 스프린트 추천 사항

마크다운 형식으로 작성하고, #team-updates Slack 채널에 공유해줘."

GitHub + Linear 연동

GitHub MCP와 Linear MCP를 함께 사용하면 코드 변경과 이슈 관리를 동기화할 수 있습니다.

# PR과 이슈를 연결
claude "PR #87이 머지되었어. 관련 Linear 이슈 ENG-142의 상태를
Done으로 변경하고, PR 링크를 코멘트로 추가해줘."

코드 변경에서 이슈 자동 생성
claude "최근 커밋에서 TODO 코멘트를 찾아서
각각 Linear 이슈로 생성해줘. 라벨은 'tech-debt'로."

!이슈 라이프사이클

고급 활용: 자동 분류 및 추정

AI가 이슈 내용을 분석하여 자동으로 라벨, 우선순위, 스토리 포인트를 추정합니다.

# 신규 이슈 자동 분류
claude "라벨이 없는 최근 이슈 10개를 분석해서
적절한 라벨과 우선순위를 추천해줘"

스토리 포인트 추정
claude "백로그에 있는 이슈들의 설명을 읽고
스토리 포인트를 1/2/3/5/8 중에서 추정해줘"

Linear의 장점

Linear를 MCP와 함께 사용할 때의 장점입니다.

• 빠른 API 응답: Linear의 GraphQL API는 응답 속도가 매우 빠릅니다
• 풍부한 데이터 모델: 이슈, 프로젝트, 사이클, 라벨, 팀 등 세밀한 구조
• Webhook 지원: 실시간 이벤트 기반 자동화 구현 가능
• 검색 고급 필터: 복잡한 조건의 이슈 검색이 용이합니다

다음 단계

프로젝트 관리 자동화를 익혔다면, 다음 편에서는 커스텀 MCP 서버를 만들어 사내 API를 연동하는 방법을 다룹니다.

---

MCP 실전 가이드 시리즈

MCP란 무엇인가

첫 MCP 서버 만들기

Filesystem MCP 실전

GitHub MCP 자동화

PostgreSQL MCP 쿼리

Slack MCP 커뮤니케이션

Linear MCP 프로젝트 관리 (현재 글)

커스텀 MCP 서버

MCP 보안 가이드

MCP 생태계 총정리

AI K LINK의 Kit MCP 목록에서 프로젝트 관리 관련 MCP 서버를 탐색하세요. 기여 가이드에서 직접 MCP Kit을 등록하는 방법도 확인할 수 있습니다.