Linear MCP: Claude, Cursor, Codex, ChatGPT에 Linear를 연결하는 방법

Weft 창업자 Andrei Finogeev ·

Linear는 https://mcp.linear.app/mcp에서 공식 MCP 서버를 운영하며, 별도의 읽기 전용 엔드포인트 https://mcp.linear.app/mcp/readonly도 있습니다. Streamable HTTP와 동적 클라이언트 등록을 지원하는 OAuth 2.1을 쓰므로 대부분의 클라이언트에는 URL만 있으면 됩니다. Linear API 키도 bearer 토큰으로 작동합니다. MCP 사용은 Free를 포함한 모든 Linear 요금제에 포함됩니다. Claude는 커넥터 디렉터리에 올려 두었고, ChatGPT에서는 OpenAI의 Linear 앱이 이슈를 동기화하고 검색하며, OpenAI에 따르면 티켓도 만들 수 있습니다.

Linear MCP 한눈에 보기

서버 URLhttps://mcp.linear.app/mcp. 읽기 전용: /mcp/readonly. /sse의 SSE는 지원 중단
로그인동적 클라이언트 등록을 지원하는 OAuth 2.1, 또는 bearer 토큰 / API 키
무료 요금제가능. 모든 요금제에 “MCP access: Included”
요청 한도명시 없음
읽기 전용 옵션있음. /readonly 엔드포인트, 또는 read 범위만 준 OAuth
유료 요금제Basic 사용자당 월 $10, Business $16(연간 결제)

“명시 없음”은 Linear이(가) 밝히지 않았다는 뜻입니다. 가격은 좌석당 미국 달러 정가이며, 세금과 지역별 가격은 다를 수 있습니다.

비서별 Linear MCP 설정 방법

Claude(웹과 데스크톱)

Settings → Connectors → Linear(Team과 Enterprise에서는 claude.ai/customize/connectors)로 가서 로그인합니다.

Claude Code

서버를 추가한 다음 Claude Code에서 /mcp를 실행하고 로그인하세요.

claude mcp add --transport http linear-server https://mcp.linear.app/mcp

Cursor

Linear의 설치 링크를 쓰거나, Cursor의 MCP 도구 페이지에서 Linear를 검색하세요.

VS Code, Windsurf, Zed

Linear는 이들을 mcp-remote를 통해 안내합니다. VS Code에서는 “MCP: Add Server”, Windsurf에서는 Settings → Cascade → MCP servers → Add custom server.

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

Codex

서버를 추가하고 로그인합니다. Linear에 따르면 Codex에는 rmcp 기능이 필요할 수 있습니다: experimental_use_rmcp_client = true.

codex mcp add linear --url https://mcp.linear.app/mcp
codex mcp login linear

ChatGPT

Linear의 MCP 문서는 ChatGPT를 다루지 않습니다. OpenAI의 Linear 앱(“app with sync”)은 이슈와 프로젝트를 검색하며, OpenAI에 따르면 티켓 만들기 같은 쓰기 동작도 지원합니다. OpenAI에 따르면 MCP URL을 직접 추가하는 것은 Business, Enterprise, Edu 기능이고, Pro에서는 읽기와 가져오기만 됩니다.

AI가 Linear에서 할 수 있는 일

  • 이슈 찾기, 만들기, 수정(save_issue). completedAt 같은 필터로 이슈 나열.
  • 프로젝트, 프로젝트 업데이트, 마일스톤, 라벨. 이니셔티브와 이니셔티브 업데이트.
  • 팀, 사용자, 사이클, 댓글, 고객 요구사항. 이미지 불러오기.

알아 둘 한계

  • Linear 워크스페이스마다 따로 로그인합니다(여러 개라면 Linear는 MCP_REMOTE_CONFIG_DIR을 권합니다).
  • 연결이 “may occasionally need a reconnect”. WSL에서는 SSE 대체 방식이 필요합니다.
  • Linear는 전체 도구 목록이나 MCP 요청 한도를 공개하지 않습니다.
  • OpenAI의 동기화형 Linear 앱은 첨부 파일이나 이미지를 동기화하지 않으며, 새 이슈가 나타나기까지 몇 시간이 걸릴 수 있습니다.
  • 에이전트가 작업하는 동안 이슈를 맡거나 진행을 보고하는 도구가 없습니다.

AI와 일할 때 Linear인가, Weft인가?

이슈, 사이클, 풀 리퀘스트 속에서 일하는 소프트웨어 팀이라면 Linear를 고르세요. MCP 서버가 탄탄하고 모든 요금제에서 무료이며, 읽기 전용 엔드포인트는 조심스러운 설정의 좋은 기본값입니다.

엔지니어만이 아니라 AI 비서가 일의 상당 부분을 하는 1인 창업자나 소규모 팀이라면 Weft를 고르세요. Weft는 Free를 포함한 모든 요금제의 ChatGPT에서 작동하고, 도구는 에이전트를 위해 만들어졌습니다. 시작 전에 작업을 맡아 둘이 부딪치지 않게 하고, 진행을 보고하고, 받은 편지함에서 당신을 기다리는 질문을 남기고, 결정을 기록합니다. 비서마다 전체, 쓰기, 읽기 전용 권한을 줄 수 있습니다.

휴대폰에 띄운 Weft 보드의 Doing 컬럼: AI 비서가 맡은 작업 세 개, 각각 AI 표시가 붙어 있음
비서가 다음 작업을 맡습니다. 카드마다 누가 작업 중인지 보입니다.
AI가 만든 Weft 작업이 완료된 모습. 비서가 남긴 결과: 무엇을 고쳤는지, 테스트 실행 40회가 통과했다는 내용
비서는 일을 마치면 영수증을 남깁니다. 무엇을 했고 어떻게 확인했는지.

Weft 설정: ChatGPT에서 Weft · Claude에서 Weft · Claude Code에서 Weft · Cursor에서 Weft · Codex에서 Weft

자주 묻는 질문

Linear MCP 서버 URL은 무엇인가요?

읽기와 쓰기는 https://mcp.linear.app/mcp, 읽기 전용은 https://mcp.linear.app/mcp/readonly입니다. SSE 엔드포인트 https://mcp.linear.app/sse는 지원 중단된 대체 방식입니다.

Linear MCP는 무료인가요?

네. Linear의 요금 페이지에는 Free를 포함한 모든 요금제에 MCP 사용이 포함된다고 나와 있습니다.

OAuth 대신 Linear API 키를 쓸 수 있나요?

네. Linear는 bearer 토큰이나 Linear API 키로 인증할 수 있다고 안내합니다.

Linear가 ChatGPT에서 작동하나요?

OpenAI의 Linear 앱을 통해 작동합니다. 이 앱은 이슈를 동기화하고 검색하며, OpenAI에 따르면 티켓도 만들 수 있습니다. Linear 자체 MCP 문서는 ChatGPT를 다루지 않습니다.

출처

2026년 11월 11일에 읽음.

다른 MCP 설정 가이드