Linear MCP (tacticlaunch)

Name: Linear MCP (tacticlaunch) MCP Server
Author: tacticlaunch

왜 쓰나요

핵심 기능

이슈, 코멘트, 프로젝트, 팀 전체 CRUD
이름으로 상태 전환 (UUID 검색 불필요)
담당자, 프로젝트, 레이블, 상태로 이슈 필터링
스프린트 계획을 위한 프로젝트 + 로드맵 조회
env에 PAT — OAuth 불필요

라이브 데모

실제 사용 모습

linear-mcp-tacticlaunch.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "linear-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "linear-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "linear-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "linear-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "linear-mcp-tacticlaunch",
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "linear-mcp-tacticlaunch": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@tacticlaunch/mcp-linear"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add linear-mcp-tacticlaunch -- npx -y @tacticlaunch/mcp-linear

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Linear MCP (tacticlaunch)

Linear를 한 번도 열지 않고 기능 출시

👤 컨텍스트 전환을 싫어하는 개발자 ⏱ ~10 min beginner

언제 쓸까: 코딩에 집중 중이고 티켓 업데이트를 위해 흐름을 끊고 싶지 않을 때.

사전 조건

Linear PAT — linear.app → Settings → API → Personal API keys

흐름

작업 선택

Use Linear MCP. Show me my open issues in 'In Progress'. Pick the highest-priority one and mark it 'In Review' — I'm done.✓ 복사됨

→ 이슈 목록 표시, 상태 업데이트됨
코멘트 작성

Add a comment: 'PR #1234 ready for review. Tests pass, perf benchmarks linked.' Link the PR.✓ 복사됨

→ PR 링크가 포함된 코멘트 게시됨
다음 작업 계획

What's next in my queue? Group by project.✓ 복사됨

→ 프로젝트별 그룹화된 이슈 목록

결과: 터미널을 벗어나지 않고 프로젝트 관리 위생 유지.

함정

상태 이름 불일치 (예: 'In Review' vs 'Review') — 먼저 해당 팀의 워크플로 상태 목록을 Claude에게 요청

함께 쓰기: github

Linear 활동에서 주간 스탠드업 자동 생성

👤 주간 업데이트를 작성하는 IC ⏱ ~5 min beginner

언제 쓸까: 금요일 오후 — 이번 주에 뭘 했는지 기억이 안 날 때.

흐름

조회

Pull all issues I closed or commented on this week. Group by project.✓ 복사됨

→ 프로젝트별 그룹화된 활동 로그
초안 작성

Write a 5-bullet update — Done / In Progress / Blocked. Keep it concise.✓ 복사됨

→ 간결한 5개 항목 요약

결과: 30분이 아닌 30초 만에 스탠드업 문서 생성.

함정

PR 전용 작업 누락 — github MCP와 결합하여 PR 활동 포착

함께 쓰기: github

밀려드는 버그 보고서를 Linear에 일괄 트리아지

👤 온콜 / 트리아지 순환 담당자 ⏱ ~30 min intermediate

언제 쓸까: 고객 지원팀이 버그 30개를 보냈을 때. 레이블링, 우선순위 지정, 담당자 배정이 필요.

흐름

일괄 가져오기

Read /tmp/bugs.md. Each bullet is a bug. Create a Linear issue per bullet with the right team and project.✓ 복사됨

→ N개 이슈 생성됨, ID 반환
우선순위 지정

Read each issue's description and set priority (urgent/high/medium/low) based on user impact.✓ 복사됨

→ 우선순위 적용됨

결과: 수신함 초기화; Linear에 트리아지된 작업 완료.

함정

중복 이슈 — 생성 전 유사한 제목 검색

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

linear-mcp-tacticlaunch + github

PR을 Linear 이슈에 자동 연결; 병합 시 이슈 완료 처리

linear-mcp-tacticlaunch + filesystem

Markdown 버그 파일에서 일괄 가져오기

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
list_issues	team?, assignee?, status?, project?, limit?	할 일 찾기	GraphQL 호출 1회
create_issue	title, description?, team, project?, assignee?, priority?	새 버그나 작업 등록	mutation 1회
update_issue	id, status?, assignee?, priority?, title?, description?	워크플로를 통해 티켓 이동	mutation 1회
add_comment	issue_id, body	상태 업데이트, PR 링크	mutation 1회
list_projects	team?	프로젝트 수준 보고	쿼리 1회
list_teams	(없음)	크로스팀 쿼리	쿼리 1회

비용 및 제한

운영 비용

API 쿼터: Linear 플랜 제한 — 무료 250명, Plus 이상에서 rate limit 완화
호출당 토큰: 200–2000
금액: 무료 (MCP 자체)
팁: 적극적으로 필터 사용; 큰 list_issues 하나가 수백 번의 개별 get보다 저렴

보안

권한, 시크릿, 파급범위

최소 스코프: Personal API token — 워크스페이스 멤버 범위

자격 증명 저장: LINEAR_API_TOKEN 환경 변수

데이터 외부 송신: api.linear.app 전용

절대 부여 금지: 에이전트에 워크스페이스 관리자 token 부여

PAT는 전체 워크스페이스 권한을 상속함 — 노트북이 분실되면 즉시 갱신

문제 해결

자주 발생하는 오류와 해결

401 Unauthorized

Token 누락 또는 취소됨; linear.app/settings/api에서 재생성

확인: curl -H 'Authorization: <token>' https://api.linear.app/graphql

상태를 찾을 수 없음

워크플로 상태는 팀별로 다름; 먼저 해당 팀의 상태 목록 조회

Rate limited (429)

백오프; 가능한 곳에서 작업 일괄 처리

대안