당신의 AI 에이전트는 이미 코드를 작성하고, 이메일을 분류하며, 인프라를 관리합니다. 하지만 프로젝트 관리에 관해서는 눈이 먼 상태입니다 — 수동 복사-붙여넣기 없이는 백로그를 보거나, 이슈를 만들거나, 프로젝트 상태를 업데이트할 수 없습니다.
Linear MCP이 이를 해결합니다. 모든 MCP 호환 AI 에이전트에게 Linear 워크스페이스에 대한 전체적이고 구조화된 접근을 부여합니다.
제공하는 기능
Linear MCP은 Model Context Protocol을 통해 Linear의 전체 프로젝트 관리 영역을 노출합니다. AI 에이전트는 다음을 수행할 수 있습니다:
핵심 작업 관리
- 이슈 — 생성(단일 또는 배치), 업데이트, 검색, 삭제, 부모-자식 계층 관리, 이슈 관계 생성
- 프로젝트 — 생성, 업데이트, 삭제, 검색, 이슈와 함께 생성, 이니셔티브 연결
- 댓글 — 스레드 답글 생성, 업데이트, 삭제, 스레드 해결/미해결 처리
- 마일스톤 — 전체 CRUD와 대량 생성 및 검색
워크플로 및 검색
- 팀, 사용자, 워크플로 상태, 라벨, 사이클
- 선택적 필터를 포함한 자유 텍스트 검색(팀, 프로젝트, 담당자, 상태, 우선순위, 사이클)
- 순위 검색으로의 폴백을 포함한 정확한 이슈 식별자 해석(예:
ENG-431)
통합 및 고급 영역
- 첨부 파일, 웹훅, 포트폴리오 엔티티(이니셔티브, 고객)
- 에이전트 세션 및 에이전트 활동
- 런타임 기능 검색 및 라이브 진단
아키텍처
AI Agent (Claude / Codex / OpenClaw / Cline)
-> MCP transport (stdio or HTTP)
-> Linear MCP server
-> Linear GraphQL API
Linear MCP은 핸들러 디스패치 전에 런타임에서 도구 스키마를 강제합니다. 잘못된 형식의 페이로드는 Linear의 API 깊은 곳이 아닌 MCP 경계에서 구조화된 검증 오류와 함께 실패합니다.
가드된 계약 — 중요한 이슈 워크플로(단일 생성, 배치 생성, 검색)는 SDK 변형 대신 감사된 원시 GraphQL 작업을 사용하여, SDK 회귀가 에이전트에 도달하는 것을 방지합니다. 로컬에서 감사하려면 npm run verify:linear-api-contracts를 실행하세요.
구조화된 원격 측정 — 모든 도구 요청은 문제 해결을 위해 도구 이름, 전송, 지속 시간, 정제된 실패 메타데이터를 포함한 stderr 원격 측정을 내보냅니다.
인증
API 키 (가장 간단):
LINEAR_API_KEY=your_personal_access_token
OAuth (공유 또는 원격 배포용):
clientId,clientSecret,redirectUri와 함께linear_auth호출- 반환된 인증 URL 열기
code와state와 함께linear_auth_callback호출
스트림 모드에서는 각 MCP 세션이 자체 격리된 인증 컨텍스트를 갖습니다.
빠른 시작
# Install from npm
npx @kkaminsk/linear-mcp
# Or clone and build
git clone https://github.com/kkaminsk/linear-mcp.git
cd linear-mcp && npm install && npm run build
# Run with API key
LINEAR_API_KEY=your_key npm start
MCP 클라이언트 설정:
{
"mcpServers": {
"linear": {
"command": "node",
"args": ["/path/to/linear-mcp/build/index.js"],
"env": {
"LINEAR_API_KEY": "your_personal_access_token"
}
}
}
}
대상 독자
- 개발 팀 — 워크플로의 일부로 이슈를 분류하고, 생성하고, 업데이트할 수 있는 AI 에이전트
- 엔지니어링 매니저 — 자동화된 프로젝트 상태 업데이트, 마일스톤 추적, 백로그 정리
- DevOps 및 SRE 팀 — 인시던트를 생성하고, 이슈를 연결하고, 해결을 추적하는 AI 에이전트
- AI 에이전트 빌더 — 프로젝트 관리에 대한 구조화된 접근이 필요한 모든 MCP 클라이언트
GitHub: github.com/kkaminsk/linear-mcp
npm: @kkaminsk/linear-mcp