/ 目錄 / 演練場 / Linear
← 全部伺服器 ↗ GitHub
● 官方 linear 🔑 需要你的金鑰

Linear

作者 linear · linear/linear

讓你的代理幫你分類 Linear 積壓清單、發佈週期更新，以及從 Sentry 提報錯誤 — 無需打開應用程式。

Linear 官方遠端 MCP (SSE) 提供工作項目、專案、週期、團隊、評論和使用者。OAuth 由 Linear 處理，所以無需管理 PAT。最佳搭配 Sentry（自動提報錯誤）、GitHub（連結 PR）和 Notion（週報）。

▶ 觀看演示 📦 安裝 💡 使用場景

為什麼要用

核心特性

即時演示

實際使用效果

linear.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

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

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "linear",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列，而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "linear": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.linear.app/sse"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add linear -- npx -y mcp-remote https://mcp.linear.app/sse

一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。

使用場景

實戰用法： Linear

10 分鐘內分類凌亂的 Linear 積壓清單

👤 工程經理、技術負責人 ⏱ ~15 min intermediate

何時使用： 週一早上。積壓清單有 200+ 未分類的工作項目，規劃會議將在一小時內進行。

前置條件
  • Linear 工作區存取權限 — 透過 mcp-remote OAuth — 首次工具呼叫會開啟瀏覽器進行授權
  • 團隊代稱（例如 ENG） — 查看任何工作項目 ID — 前綴就是你的團隊代稱
步驟
  1. 擷取該團隊的所有未分類工作項目
    List all ENG issues in state 'Triage' or with no priority set, created in the last 30 days. Return id, title, reporter, and description length.✓ 已複製
    → 候選項的表格，具有足夠的分類背景資訊
  2. 按主題分組
    Group these into 4-6 themes (bug / infra / onboarding / perf / etc.). For each cluster, propose a priority and suggested project.✓ 已複製
    → 附帶理由的主題群組
  3. 套用決定
    For each cluster, update the issues: set priority, add the matching label, and move to 'Backlog' state. Do NOT assign anyone.✓ 已複製
    → N 個工作項目已更新，確認記錄已登錄

結果： 規劃就緒的積壓清單，已分組和優先化，並具有代理所做每項變更的稽核軌跡。

注意事項
  • 代理根據「誰編寫了類似程式碼」將工作項目大量指派給錯誤的人 — 明確告訴它不要指派 — 指派是人工決定，應該保持這樣
  • 免費版 Linear 在約 1500 次請求/小時後會對你進行速率限制 — 使用 issueBatchUpdate 進行批次更新（如果可用）；否則保持分類執行數量在 500 個工作項目以下
搭配使用： sentry · github

從 Linear 產生週報週期狀態報告

👤 工程經理、產品經理 ⏱ ~10 min beginner

何時使用： 週五下午，你需要為領導層撰寫週報更新。

前置條件
  • Linear 中的活躍週期 — Linear > 你的團隊 > Cycles — 記下目前的週期編號
步驟
  1. 擷取週期統計資料
    For ENG cycle 47, list all issues grouped by state. Include completed-this-week, in-progress, blocked, and at-risk (no update in 3+ days).✓ 已複製
    → 具有計數和工作項目標題的明細
  2. 與上週進行比較
    Compare to last week's snapshot [paste prior JSON]. What shipped, what regressed to earlier states, what's newly blocked?✓ 已複製
    → 具有敘述的差異
  3. 起草報告
    Write a 1-page Markdown report: wins, in-flight, blockers, help-needed. Keep it honest — leadership reads between the lines.✓ 已複製
    → 報告已準備好貼到 Slack 或 Notion 中

結果： 10 分鐘內的精美週期更新，而不是 45 分鐘。

注意事項
  • 沒有合併 PR 的已完成工作項目看起來像進度，但實際上不是 — 與 GitHub MCP 結合 — 驗證每個「完成」的工作項目都有參考的已合併 PR
搭配使用： github · notion

從新 Sentry 問題自動提報 Linear 錯誤

👤 待命工程師 ⏱ ~15 min intermediate

何時使用： 你希望 Sentry 中的實時錯誤尖峰變成被追蹤的錯誤，無需手動複製貼上。

前置條件
  • Sentry MCP 與 Linear 並肩安裝 — 參見 sentry 指南了解設定
  • 專用的 Linear 標籤，例如 from-sentry — Linear > Settings > Labels — 建立一次
步驟
  1. 尋找超過閾值的新 Sentry 問題
    Find Sentry issues first seen in the last 24h with >50 events in the web-prod project.✓ 已複製
    → 包含問題 ID 和事件計數的清單
  2. 檢查 Linear 中是否有重複項
    For each Sentry issue title, search Linear for existing issues with similar titles or containing the Sentry URL. Skip ones already filed.✓ 已複製
    → 去重清單 — 僅真正的新項目
  3. 建立 Linear 錯誤
    Create a Linear issue in ENG team for each new Sentry issue: title = Sentry title, description = stacktrace + link, priority = Urgent if >1000 events else High, label = from-sentry.✓ 已複製
    → 建立了 N 個工作項目，返回連結

結果： 乾淨的 Linear 錯誤進度，永遠不會漏掉生產環境錯誤。

注意事項
  • 由於標題略有變化，同一 Sentry 問題被提報兩次 — 在 Linear 標題中使用 Sentry 問題短 ID（例如 WEB-3a91）並基於該子字串去重
搭配使用： sentry

推動目前週期中的陳舊工作項目

👤 技術負責人、敏捷大師 ⏱ ~5 min beginner

何時使用： 週期中期檢查。指派 5+ 天但沒有狀態變化的工作項目通常卡住了。

步驟
  1. 尋找陳舊的工作項目
    List issues in the current ENG cycle that have been in 'In Progress' for 5+ days without a state change or comment.✓ 已複製
    → 包含指派人和陳舊天數的清單
  2. 發佈溫和的推動評論
    Add a comment on each: 'Quick check-in — still on track for this cycle, or do you need to break this down / get help?' Tag the assignee.✓ 已複製
    → 評論已發佈，返回連結
  3. 如果被忽略則升級
    In 48 hours, re-run. If still no update, DM me a list for 1:1 follow-up.✓ 已複製
    → 人工追蹤的升級清單

結果： 解除封鎖的工作，無需每天都像嘮叨的經理一樣。

注意事項
  • 如果你每小時執行一次，評論垃圾郵件 — 在再次發佈前檢查代理在過去 3 天內是否已評論

從 Notion 規格搭建 Linear 專案

👤 PM、啟動新計劃的技術負責人 ⏱ ~20 min intermediate

何時使用： 你有一份書面 PRD，需要將其分解為可追蹤的工作項目。

前置條件
  • Notion MCP 已安裝 — 參見 notion 指南
  • PRD 頁面 URL — 從 Notion 複製
步驟
  1. 閱讀並總結規格
    Read the Notion PRD at <URL> and list every discrete deliverable as a one-line description.✓ 已複製
    → 15-40 個候選工作項目
  2. 審查並改進
    Group these into 3-5 milestones. Flag any that need design, API, or DB work as separate issues.✓ 已複製
    → 結構化的工作項目樹
  3. 建立 Linear 專案和工作項目
    Create a Linear project named '<Spec title>' in ENG team. Create each milestone as a parent issue, with children as sub-issues. Link back to the Notion page in each description.✓ 已複製
    → 專案 URL + 工作項目計數

結果： 20 分鐘內一個完全搭建的 Linear 專案，而不是 2 小時的手動票證撰寫。

注意事項
  • 代理建立 80 個工作項目，而你只需要 20 個 — 太細粒度 — 在第 2 步中，明確上限：「總共不超過 20 個工作項目，合併任何少於一天的工作」
搭配使用： notion

組合

與其他 MCP 搭配，撬動十倍槓桿

linear + sentry

將生產環境錯誤尖峰自動轉換為被追蹤的 Linear 錯誤

Find new Sentry web-prod issues from the last 24h with >50 events. For each, create a Linear bug in ENG team labeled 'from-sentry', priority High, with the stacktrace in the description.✓ 已複製
linear + github

自動將 PR 連結到 Linear 工作項目，並在 PR 合併時關閉工作項目

For every open PR in my repo, find the Linear issue ID in the title or branch name and add a reference comment on the Linear issue with the PR URL.✓ 已複製
linear + notion

將週報週期摘要發佈到 Notion 資料庫

Generate this week's ENG cycle status and create a page in the Notion 'Engineering Weekly' database with the full report.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list_issues team?, assignee?, state?, label?, cycle?, query?, limit? 主要搜尋 — 篩選串流 1 次 API 呼叫
get_issue id 擷取單一工作項目的完整背景資訊 1 次 API 呼叫
create_issue teamId, title, description?, priority?, labelIds?, assigneeId?, projectId? 提報新工作項目 1 次 API 呼叫
update_issue id, stateId?, priority?, assigneeId?, labelIds?, title?, description? 變更狀態、優先級或指派 1 次 API 呼叫
create_comment issueId, body 在工作項目上發佈推動或狀態備註 1 次 API 呼叫
list_projects teamId? 發現團隊中的活躍專案 1 次 API 呼叫
list_cycles teamId 尋找團隊的活躍或最近週期 1 次 API 呼叫
list_teams 發現工作區中的團隊 1 次 API 呼叫

成本與限制

運行它的成本

API 配額
OAuth 應用程式 1500 req/h，120 req/min 突發 — 對任何真實工作流程都很慷慨
每次呼叫 Token 數
每個工作項目 300–1500 個 token，取決於描述/評論
費用
免費 — Linear MCP 包含在任何 Linear 計畫中
提示
使用具有特定篩選器的 list_issues 而不是擷取所有內容然後篩選 — 在大型積壓清單上降低 10 倍的 token 成本

安全

權限、密鑰、影響範圍

最小權限： read write issues:create
憑證儲存： 透過 mcp-remote OAuth — token 儲存在 ~/.mcp-auth/，無需重新登入即可重新整理
資料出站： 所有對 api.linear.app 和 mcp.linear.app 的呼叫
切勿授予： admin

故障排查

常見錯誤與修復

OAuth 瀏覽器快顯視窗不會開啟

手動執行一次 npx -y mcp-remote https://mcp.linear.app/sse — 它將列印一個你可以貼到瀏覽器的 URL

驗證： 認證後，重新執行你的代理；token 已快取在 ~/.mcp-auth/
update_issue 上的 403

你的 Linear 角色缺少該團隊的寫入存取權限。要求工作區管理員提升你或將代理範圍限定於你擁有的團隊。

返回工作項目但評論遺失

評論是單獨的查詢 — 使用 get_issue 搭配 include-comments，或使用工作項目 ID 單獨列出評論。

無法找到你知道存在的工作項目

檢查團隊篩選 — 除非你傳遞 team=null 或指定該團隊，否則不會返回其他團隊中的工作項目。

替代方案

Linear 對比其他方案

替代方案何時用它替代權衡
Jira MCP你的組織使用 Jira，而不是 Linear更重的 API、更多要推理的狀態/欄位 — 代理在 Jira 上的表現立即糟糕
GitHub Issues (via GitHub MCP)你希望工作項目與程式碼緊密結合，無需單獨的工具失去週期、專案和工作流程狀態 — GitHub Issues 更簡單但結構較少

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills