블로그 · Linear

Linear MCP 서버: Claude, Cursor, Codex, VS Code 등에 연결하는 방법

Linear 공식 원격 MCP 서버를 쓰면 AI 클라이언트가 Linear의 이슈, 프로젝트, 댓글을 찾고, 만들고, 수정할 수 있어요. Linear가 https://mcp.linear.app/mcp에서 직접 운영하기 때문에 따로 설치하거나 실행할 필요가 없어요. 클라이언트에 URL을 추가하고 Linear에 로그인하면 끝이에요. 이 글에서는 엔드포인트와 인증 방식, Linear와 각 업체 문서에 나온 클라이언트별 정확한 설정, 도구 목록, 자주 생기는 연결 문제의 해결법을 다뤄요.

Linear MCP 한눈에 보기

Linear의 MCP 문서, 변경 내역, API 문서에서 2026년 11월 17일에 확인한 내용이에요. 이 서버는 Linear가 만들었고, Claude의 Connectors Directory에 Anthropic 검증 커넥터로 올라 있어요.

Linear MCP 서버
엔드포인트(읽기와 쓰기)https://mcp.linear.app/mcp
읽기 전용 엔드포인트https://mcp.linear.app/mcp/readonly, "읽기 도구만 제공"해요. 2026년 11월 5일부터 MCP 레지스트리에 올라 있어요
전송 방식Streamable HTTP. 원격 MCP를 지원하지 않는 클라이언트는 mcp-remote npm 모듈로 연결해요
인증동적 클라이언트 등록을 쓰는 OAuth 2.1(PKCE S256만 지원), 또는 Authorization: Bearer <yourtoken> 헤더에 넣는 OAuth 토큰이나 Linear API 키. Enterprise에서는 Okta 기업 관리형 인증, Business나 Enterprise에서는 Claude 자동 연결(베타)을 쓸 수 있어요
예전 SSE 엔드포인트https://mcp.linear.app/sse는 지원 중단됐어요. Linear는 2026년 2월 5일에 "SSE 지원을 완전히 제거"한다고 밝혔고, 2026년 11월 17일에 인증 없이 요청하면 404가 돌아왔어요. 새로 설정할 때는 항상 /mcp를 쓰세요
Linear 요금제Linear의 MCP 페이지에는 서버에 필요한 요금제가 나와 있지 않아요. 가격 페이지는 연동 항목에 "MCP server"를 올려 두었고, API 접근은 모든 요금제에서 가능해요
요청 제한Linear는 MCP에 대한 제한을 밝히지 않았어요. 일반 API 제한은 API 키 사용 시 사용자당 시간당 2,500건, 인증 없이는 IP당 시간당 600건이고, OAuth 토큰 요청도 제한이 있어요(429와 Retry-After)
출시일2025년 5월 1일

AI 클라이언트를 Linear MCP 서버에 연결하기

클라이언트마다 단계가 하나씩 있으니 쓰는 것만 따라 하세요. 각 스니펫은 Linear 문서나 연동 페이지에서, 내용이 다를 때는 클라이언트 자체 문서에서 가져왔어요. 읽기 전용으로 쓰려면 스니펫의 https://mcp.linear.app/mcp를 https://mcp.linear.app/mcp/readonly로 바꾸세요.

  1. Claude Code

    터미널에서 명령어를 실행한 다음, Claude Code 세션에서 /mcp를 실행해 Linear에 로그인하세요. 모든 프로젝트에서 Linear를 쓰려면 --scope user를, .mcp.json으로 팀과 공유하려면 --scope project를 추가하세요. 로그인 과정을 건너뛰려면 --header "Authorization: Bearer your-token"으로 토큰을 넘기면 돼요. claude.ai에서 연결한 Linear는 claude.ai 구독으로 로그인했을 때 Claude Code에도 나타나고, 공식 플러그인 linear@claude-plugins-official도 같은 엔드포인트를 써요. 자세한 내용은 Claude Code + Linear에서 볼 수 있어요.

    # Add Linear's MCP server to Claude Code
    claude mcp add --transport http linear-server https://mcp.linear.app/mcp
    
    # Then, inside a Claude Code session, sign in to Linear
    /mcp
  2. Claude(claude.ai, 데스크톱, 모바일)

    Linear 커넥터는 Claude의 Connectors Directory에 있어요. 아래는 Anthropic이 안내하는 방법이에요. Linear 문서는 요금제별로 나눠서 안내해요(Team과 Enterprise는 claude.ai, Free와 Pro는 Claude 데스크톱의 Settings > Connectors). 반면 Claude 자체 문서는 모든 요금제와 웹, 데스크톱, 모바일에서 커넥터를 쓸 수 있다고 해요. Team과 Enterprise에서는 관리자가 자동 연결(베타)을 설정해 두면 이메일 주소가 일치하는 멤버는 Linear 로그인을 건너뛸 수 있어요.

    Customize > Connectors > Discover > search "Linear" > Connect to Claude
    In a chat: + > Connectors > turn Linear on
  3. Cursor

    Linear 문서는 Cursor 딥링크(설정값은 {"url":"https://mcp.linear.app/mcp"})로 설치하거나, Cursor의 MCP 도구 페이지에서 Linear를 검색해 설치하라고 안내해요. 원클릭 OAuth 설치는 Cursor 1.0부터 지원돼요. Linear의 Cursor 페이지에는 수동 mcp-remote 설정도 나와 있어요. Cursor 자체 문서는 원격 서버를 url 필드와 함께 ~/.cursor/mcp.json(전역)이나 .cursor/mcp.json(프로젝트)에 넣으라고 해요. 자세한 내용은 Cursor + Linear에서 볼 수 있어요.

    # One-click install (opens Cursor)
    cursor://anysphere.cursor-deeplink/mcp/install?name=Linear&config=eyJ1cmwiOiJodHRwczovL21jcC5saW5lYXIuYXBwL21jcCJ9
    
    # Manual: CTRL/CMD Shift J → MCP → Add new global MCP server
    {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}
  4. VS Code

    Linear가 안내하는 방법은 mcp-remote를 실행하는 stdio 서버를 추가하고 이름을 **Linear**로 정한 다음, **MCP: List Servers** → Linear → **Start Server**를 누르는 거예요. VS Code 자체 문서에서는 원격 서버를 바로 추가해요. **MCP: Add Server** → **HTTP (HTTP or Server-Sent Events)** → 엔드포인트 입력 → Global 또는 워크스페이스 .mcp.json 선택 순서예요. Global 서버는 Copilot CLI와 공유돼요. 자세한 내용은 GitHub Copilot + Linear에서 볼 수 있어요.

    # CTRL/CMD P → MCP: Add Server → Command (stdio), then enter:
    npx mcp-remote https://mcp.linear.app/mcp
    
    # Or, as JSON (Linear's docs):
    {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}
  5. Codex(CLI와 IDE 확장)

    codex mcp add를 실행하면 로그인하라는 안내가 나와요. 기능 플래그에 대해서는 공식 페이지끼리 내용이 달라요. Linear 문서는 ~/.codex/config.toml의 [features] 아래에 experimental_use_rmcp_client = true를 추가하라고 하고, Linear의 Codex 페이지는 rmcp_client = true라고 하며, OpenAI의 최신 MCP 문서에는 플래그가 없어요. 아래 스니펫은 OpenAI 문서의 형태예요. 쓰시는 Codex 버전이 플래그를 요구하면 두 페이지를 모두 확인하세요. 이 설정 파일은 Codex CLI, IDE 확장, ChatGPT 데스크톱 앱이 함께 써요. Linear는 로컬 Codex 작업(CLI나 IDE 확장)에서만 이 서버를 쓸 수 있다고 밝혔어요. 자세한 내용은 Codex + Linear에서 볼 수 있어요.

    # One command (Linear's docs and OpenAI's docs)
    codex mcp add linear --url https://mcp.linear.app/mcp
    
    # Or by hand in ~/.codex/config.toml (OpenAI's docs)
    [mcp_servers.linear]
    url = "https://mcp.linear.app/mcp"
    
    # then sign in (add --no-browser on a headless machine)
    codex mcp login linear
  6. Windsurf

    Linear의 Windsurf 페이지는 Cascade 플러그인 아이콘을 선택해 거기서 Linear MCP 서버를 설치하거나, 아래처럼 직접 추가하라고 안내해요. Windsurf의 MCP 문서 URL은 이제 Devin Local 문서로 연결돼요. 이 문서에서는 서버를 ~/.config/devin/mcp_config.json이나 .devin/mcp_config.json에 두고 OAuth를 쓰는 Streamable HTTP를 지원하기 때문에, 메뉴가 Linear의 설명과 다를 수 있어요.

    # CTRL/CMD , → Cascade → MCP servers → Add Server → Add custom server
    {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}
  7. Zed

    Linear는 두 가지 형태를 문서화해 두었어요. 문서 페이지는 첫 번째를, Zed 연동 페이지는 두 번째를 써요. Zed 자체 문서도 MCP OAuth 흐름과 함께 URL로 원격 서버를 추가하는 방법(Settings → AI → MCP Servers → Add Remote Server)을 지원하지만, Linear는 이 방식을 안내하지 않고, Zed 문서에도 "source": "custom"에 대한 언급이 없어요. 먼저 문서 페이지의 형태로 시작하고, 쓰시는 버전에서 거부되면 Zed의 MCP 문서를 확인하세요.

    // Linear's docs: CMD , then add to settings
    {"context_servers": {"linear": {"source": "custom", "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}}}
    
    // Linear's Zed integration page shows an older shape:
    {"context_servers": {"linear": {"command": {"path": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}, "settings": {}}}}
  8. ChatGPT(deep research 커넥터)

    Linear의 ChatGPT 페이지는 deep research 커넥터만 다뤄요. ChatGPT의 커넥터 설정에서 Linear를 연결한 다음, deep research에서 Linear를 소스로 추가하면 돼요. Plus와 Pro 사용자(EEA, 스위스, 영국 제외)와 Team, Enterprise, Edu 사용자가 쓸 수 있어요. Linear는 ChatGPT 개발자 모드에 MCP URL을 추가하는 방법을 안내하지 않아요. OpenAI는 Linear를 ChatGPT 플러그인으로 올려 두었고, ChatGPT 데스크톱 앱은 위의 Codex 설정을 통해 MCP 서버를 써요. 자세한 내용은 ChatGPT + Linear에서 볼 수 있어요.

    ChatGPT connector settings > connect Linear
    Deep research > add Linear as a source
  9. 그 밖의 클라이언트: mcp-remote로 연결

    로컬 MCP 명령은 실행하지만 원격 MCP는 지원하지 않는 클라이언트라면, Linear가 안내하는 아래 값을 쓰세요. Linear는 fx(/mcp add linear https://mcp.linear.app/mcp 실행 후 /mcp login linear)와 v0 by Vercel(MCP connections 페이지에서 설치)도 문서화해 두었어요.

    Command: npx
    Arguments: -y mcp-remote https://mcp.linear.app/mcp
    Environment: None

Linear MCP로 할 수 있는 일

Linear 문서는 도구를 "이슈, 프로젝트, 댓글 같은 Linear 객체를 찾고, 만들고, 수정"하는 것으로 설명할 뿐 이름을 하나씩 나열하지는 않아요. 아래 이름은 Anthropic의 커넥터 디렉터리(도구 22개)와 Linear 변경 내역에서 가져왔어요. 디렉터리 목록은 2026년 2월 Linear 추가분보다 앞선 것이라, 쓰시는 클라이언트에는 더 많이 보일 수 있어요.

  • 이슈: list_issues, list_my_issues, get_issue, create_issue, update_issue, list_issue_statuses, get_issue_status, list_issue_labels. 2026년 11월 5일부터 list_issues에서 completedAt(ISO-8601 날짜나 -P7D 같은 기간)으로 완료일을 기준으로 필터링할 수 있어요. 이렇게 해 보세요: "Backend 팀의 내 열린 Linear 이슈를 보여줘", "이 버그로 이슈를 만들고 나에게 배정해줘".
  • 댓글: list_comments, create_comment. 이렇게 해 보세요: "ENG-123의 댓글을 요약하고 수정 내용을 댓글로 남겨줘".
  • 프로젝트: list_projects, get_project, create_project, update_project. 이렇게 해 보세요: "결제 시스템 재작성 프로젝트를 만들고 이 이슈 세 개를 추가해줘".
  • 팀, 사용자, 사이클: list_teams, get_team(2026년 9월 14일부터 각 팀의 공개 범위와 retiredAt 포함), list_users, get_user, list_cycles. 2026년 10월 22일부터는 이름의 일부만으로 사람을 배정할 수 있어요. 이렇게 해 보세요: "현재 사이클에서 담당자가 없는 이슈가 뭐야?"
  • 문서와 도움말: list_documents, get_document, search_documentation(Linear 자체 문서). 이렇게 해 보세요: "Linear에서 온보딩 스펙 문서를 찾아서 요약해줘".
  • 고객: list_customer_needs(2026년 10월 8일부터)는 이슈, 프로젝트, 이니셔티브에 대한 고객 요청을 돌려줘요. 2026년 10월 22일부터는 도메인과 외부 ID로 고객을 찾을 수 있어요. 이렇게 해 보세요: "SSO를 요청한 고객이 누구야?"
  • 제품 관리(2026년 2월 5일부터): 이니셔티브, 이니셔티브 업데이트, 프로젝트 마일스톤, 프로젝트 업데이트를 만들고 수정하고, 프로젝트 라벨을 관리하고, 이미지를 불러오고, URL로 Linear 리소스를 불러올 수 있어요. 이렇게 해 보세요: "닫힌 이슈를 바탕으로 Mobile v2의 이번 주 프로젝트 업데이트를 써줘".
  • 2026년 11월 5일부터 서버가 도구 사용법에 대한 기본 지침을 클라이언트에 보내요.

읽기 전용 접근

Linear는 AI 클라이언트가 아무것도 바꾸지 못하게 하는 방법을 세 가지 안내해요.

  • 읽기 도구만 제공하는 읽기 전용 엔드포인트 https://mcp.linear.app/mcp/readonly를 쓰세요.
  • https://mcp.linear.app/mcp를 쓰되 OAuth 범위를 read만 허용하세요. 그러면 토큰으로 쓰기 API에 접근할 수 없어요.
  • Authorization: Bearer 헤더에 Read 권한만 있는 Linear API 키를 넣으세요.

문제 해결

  • 연결이 실패하거나 여러 번 시도해야 할 때: Linear는 원격 MCP 연결이 "아직 초기 단계"라고 해요. 클라이언트를 다시 시작하거나, MCP 설정에서 Linear 서버를 껐다 켜 보세요. 연결을 끊었다가 다시 연결해도 Linear 데이터나 로그인에는 영향이 없어요.
  • 연결할 때 내부 서버 오류가 나면: rm -rf ~/.mcp-auth를 실행한 다음 다시 연결하세요. Node 버전을 올려야 할 수도 있어요.
  • 워크스페이스가 잘못 연결됐을 때: 이미 로그인된 상태에서는 다시 연결해도 워크스페이스가 바뀌지 않아요. 워크스페이스마다 인증 폴더를 따로 쓰세요. 예를 들면 MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-a npx mcp-remote https://mcp.linear.app/mcp와 MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp처럼요.
  • /sse가 들어간 예전 설정: URL을 https://mcp.linear.app/mcp로 바꾸세요. Linear는 2026년 2월 5일에 SSE 지원 제거를 발표했어요.
  • Windows의 WSL: Linear 문서는 지금도 SSE 우회 방법 {"mcpServers": {"linear": {"command": "wsl","args": ["npx","-y","mcp-remote","https://mcp.linear.app/sse","--transport sse-only"]}}}을 안내하는데, Linear가 없애려는 엔드포인트를 쓰는 방식이에요. 실패할 수 있으니 Linear 문서에 업데이트가 있는지 확인하세요.
  • Codex 클라우드 작업에서 Linear가 보이지 않을 때: Linear는 로컬 Codex 작업(CLI나 IDE 확장)에서만 MCP 서버를 쓸 수 있다고 밝혔어요.
  • 클라이언트가 원격 MCP를 지원하지 않을 때: "그 밖의 클라이언트" 단계처럼 mcp-remote를 쓰세요.

타임라인

  • 2025년 5월 1일: Linear가 https://mcp.linear.app/sse에서 MCP 서버를 출시했어요. Claude에서는 기본 지원이고, Cursor, Windsurf, VS Code, Zed에서는 mcp-remote로 연결해요.
  • 2025년 6월 5일: Cursor 1.0에서 원클릭 OAuth 설치가 가능해졌고, ChatGPT deep research용 Linear 커넥터가 나왔어요.
  • 2026년 2월 5일: 이니셔티브, 이니셔티브 업데이트, 프로젝트 마일스톤, 프로젝트 업데이트, 프로젝트 라벨, 이미지, 리소스 URL 지원, 토큰 사용량 감소, /mcp를 쓰도록 하는 SSE 제거 발표.
  • 2026년 8월 13일: Okta SAML을 쓰는 Enterprise 워크스페이스용 Okta 기업 관리형 로그인.
  • 2026년 9월 14일: list_teams와 get_team이 팀 공개 범위와 retiredAt을 반환.
  • 2026년 10월 8일: list_customer_needs 도구 추가, PKCE에 S256 방식을 명시해야 함.
  • 2026년 10월 22일: 부분 이름으로 사용자 배정, 도메인과 외부 ID로 고객 조회, MCP로 만든 하위 이슈가 상위 이슈의 프로젝트를 상속.
  • 2026년 11월 5일: 클라이언트용 기본 지침, list_issues의 completedAt 필터, MCP 레지스트리에 읽기 전용 엔드포인트 등록.
  • 2026년 11월 12일: API 키와 앱 토큰으로 설명과 문서를 수정해도 바뀌지 않은 내용의 서식이 유지됨.

AI 에이전트별 Linear 연동

일부 에이전트는 MCP 서버 외에 자체 Linear 연동도 있어요. 각 페이지에서 그 에이전트가 Linear와 함께 일하는 모든 방법을 다뤄요.

Crewmark로

AI 에이전트가 담당자인 보드

Linear는 사람을 위해 만들어졌고, 에이전트는 위임 대상으로 추가돼요. Crewmark는 AI 직원 팀을 위한 이슈 트래커예요. 각 직원은 내 컴퓨터에 있는 Claude Code나 Codex 대화로, 직무, KPI, 프로젝트를 가져요. OpenCode, DeepSeek Harness 같은 다른 에이전트는 Agent Client Protocol로 연결돼요. 이슈를 배정하면 일을 시작하고, 근무 시간 동안 하트비트에 맞춰 깨어나 상태를 최신으로 유지하고, 댓글을 달고 다른 직원을 @멘션하며, 내가 필요하면 이슈를 '조치 필요'로 바꿔요.

Crewmark는 Linear와 연결되지 않아요. 팀이 Linear를 계속 쓴다면, 직원은 그 컴퓨터에 설정해 둔 Linear MCP 서버를 다른 도구처럼 쓸 수 있어요. Crewmark는 오픈 소스(GPL-3.0)이고 프로젝트 1개와 AI 직원 3명까지 무료예요. 에이전트는 이미 쓰고 있는 요금제로 돌아가요.

Linear MCP 서버Crewmark
정체AI 클라이언트가 Linear를 읽고 바꿀 수 있게 하는 연결AI 직원이 이슈를 맡는 이슈 트래커
일하는 주체AI 클라이언트에 프롬프트를 입력하는 나근무 시간 동안 하트비트로 일하는 각 AI 직원
에이전트가 실행되는 곳내 AI 클라이언트 안내 컴퓨터, 평소 쓰는 Claude Code나 Codex 환경
내가 필요할 때내가 다음 프롬프트를 입력할 때까지 기다림이슈를 '조치 필요'로 바꾸고 거기서 물어봄

Linear MCP FAQ

Linear MCP 서버가 뭔가요?

https://mcp.linear.app/mcp에 있는 Linear 공식 호스팅 원격 MCP 서버예요. Claude, Cursor, Codex, VS Code, Windsurf, Zed 같은 AI 클라이언트가 Linear의 이슈, 프로젝트, 댓글 등을 찾고, 만들고, 수정할 수 있게 해줘요. Linear가 2025년 5월 1일에 출시했어요.

Linear MCP 서버는 무료인가요?

Linear는 필요한 요금제나 별도 요금을 밝히지 않았어요. 가격 페이지는 연동 항목에 "MCP server"를 올려 두었고, API 접근은 모든 Linear 요금제에서 가능해요. 요금제가 필요한 건 부가 기능뿐이에요. Claude 자동 연결은 Linear Business나 Enterprise, Okta 관리형 로그인은 Enterprise가 필요해요. 쓰시는 AI 클라이언트의 요금제는 따로 적용돼요.

Claude Code에 Linear MCP를 어떻게 추가하나요?

claude mcp add --transport http linear-server https://mcp.linear.app/mcp를 실행한 다음, Claude Code 세션에서 /mcp를 실행해 Linear에 로그인하세요. claude.ai에서 Linear를 연결해 두고 그 구독으로 Claude Code에 로그인하면 커넥터가 Claude Code에도 나타나요.

Linear MCP를 Cursor에서도 쓸 수 있나요?

네. Linear의 Cursor 딥링크나 Cursor의 MCP 도구 페이지에서 원클릭 OAuth로 설치하거나, Add new global MCP server에 {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}를 추가하세요.

Linear MCP를 읽기 전용으로 쓸 수 있나요?

네. 읽기 도구만 제공하는 https://mcp.linear.app/mcp/readonly를 쓰거나, /mcp를 쓰면서 read OAuth 범위만 허용하거나, Read 권한만 있는 Linear API 키를 Bearer 토큰으로 넘기세요.

Linear MCP 연결이 왜 실패하나요?

Linear는 원격 MCP 연결이 아직 초기 단계라 여러 번 시도해야 할 수 있다고 해요. 클라이언트를 다시 시작하거나 서버를 껐다 켜 보세요. 내부 서버 오류가 나면 rm -rf ~/.mcp-auth를 실행하고 다시 연결한 뒤 Node를 업데이트하세요. 설정이 아직 /sse를 가리키고 있다면 https://mcp.linear.app/mcp로 바꾸세요. Linear가 SSE 지원을 없애고 있어요.

Linear의 문서와 변경 내역, 각 클라이언트의 문서와 대조해 2026년 11월 17일에 확인했습니다.

에이전트에게 연결만이 아니라 보드를 주세요.

Crewmark는 Claude Code, Codex, 그리고 OpenCode와 DeepSeek Harness 같은 ACP 에이전트를 직무, KPI, 근무 시간, 하트비트를 가진 AI 직원으로 바꿔요.