Linear MCP 實戰教學:讓 Claude 與 Cursor 直接讀寫 Issue、自動拆解 PRD 與追蹤進度

想讓 Claude 或 Cursor 直接幫你查 Backlog、把 PRD 拆成 Linear Issue 並自動回報進度嗎?本文完整解析 Linear MCP 的安裝設定、權限控管與三個高頻 PM 實戰指令。

Share
Claude 與 Cursor 透過 Linear MCP 協議直接讀取 PRD、拆解任務與更新 Sprint Issue 進度的操作流程示意圖

每天早上打開 Linear 整理積壓的 Bug、手動把 PRD 拆成十幾張票,是許多 PM 與 Tech Lead 最消耗心力的日常。

過去我們得把需求複製貼上給 AI,拆完再一張張手動貼回專案管理工具,來回複製的摩擦反而讓人懶得用。

透過 Linear MCP(Model Context Protocol),你可以讓 Claude Desktop 或 Cursor 直接讀寫團隊的 Workspace,一句話完成查票、建票與週報彙整。

延伸閱讀:Zapier MCP 實戰:讓 ChatGPT 與 Claude 直接讀寫 Notion、Slack 與 Google Calendar 延伸閱讀:CrewAI 多代理協作入門:打造自動化研究與執行團隊

Claude 與 Cursor 透過 Linear MCP 協議直接讀取 PRD、拆解任務與更新 Sprint Issue 進度的操作流程示意圖
透過官方或開源 Linear MCP Server,AI 代理不再只是寫程式的聊天機器人,而是能直接參與 Sprint 派工與狀態追蹤的團隊成員。 圖片來源:官方來源。

Linear MCP 是什麼?它解決了什麼跨工具痛點?

MCP(Model Context Protocol)是讓大型語言模型安全連接外部系統的開放標準。Linear 支援的 MCP Server 把專案裡的 Teams、Projects、Cycles、Issues 與 Comments 封裝成標準化工具(Tools),讓 AI 助手能「看懂」並「操作」你的專案看板。

對產品與研發團隊來說,最大的價值在於「上下文零斷層」。工程師在 Cursor 寫完一段功能,AI 可以直接讀取對應的 Linear Issue 驗收條件做自我檢查,並在開完 PR 後順手把票的狀態改為 In Review,完全不用切換視窗。

五分鐘設定指南:在 Claude Desktop 與 Cursor 啟用 Linear MCP

設定方式 適用對象 驗證方式 優點 注意事項
官方遠端 MCP(OAuth) 非工程師 PM、一般團隊 瀏覽器登入 Linear 授權 免本機裝 Node.js、設定最快 需確認客戶端支援 Remote MCP
本機 MCP Server(API Key) 工程師、Cursor 重度用戶 Personal API Key 可完全本機執行、便於整合其他工具 需妥善保管 Key,勿寫死進 Git

方式一:使用 Linear 官方遠端端點(推薦 PM 使用)

新版 Claude Desktop 與多數主流 MCP 客戶端已支援直接連線至 Linear 官方託管的遠端 MCP URL(https://mcp.linear.app/sse 或官方最新 Streamable HTTP 端點)。新增設定後會自動彈出 OAuth 授權視窗,登入你的 Linear 帳號並選擇允許存取的 Workspace 即可完成,全程不需碰終端機。

方式二:透過本機設定檔綁定 API Key(適合 Cursor)

若要在 Cursor 或本機環境統一管理多個 MCP,可先至 Linear 後台的 Settings → Security & Access → Personal API keys 產生一組專用的 Key,再於 .cursor/mcp.json 或 Claude 設定檔中加入對應的 Linear MCP 執行指令與環境變數 LINEAR_API_KEY。建議為 AI 代理建立獨立的授權範圍,方便追蹤是誰異動了看板狀態。

三個立即可用的 PM 與工程師實戰場景

場景一:把長篇 PRD 自動拆解成標準化 Issue

在 Claude 中貼上剛定案的規格文件,並下達指令:「請先讀取目前 Team Product-Core 的 Label 規範與進行中的 Cycle,接著將這份 PRD 拆解為 1 個 Parent Issue 與最多 6 個 Sub-issues。每張票必須包含背景、實作範圍與條列式驗收條件,先列出清單讓我確認,確認後再寫入 Linear。」

這樣做的關鍵在於「先讀規範、先預覽、再寫入」,避免 AI 在看板上亂建一堆不符合團隊標籤習慣的垃圾票。

場景二:在 Cursor 裡邊看 Issue 邊寫程式並更新進度

工程師在 Cursor 開發時,可以直接問:「幫我抓出指派給我的 High Priority Issue,根據它的驗收標準檢查目前這個 branch 還缺哪些邊界測試。」確認補齊後,直接補上一句:「在該張 Issue 下方留一則進度留言,附上已驗證項目,並將狀態切換為 In Review。」

場景三:週五自動產出無廢話 Sprint 週報

到了週五下午,PM 只要問 Claude:「幫我彙整本週 Cycle 所有狀態變更為 Done 與 Canceled 的 Issue,依功能模組分類,另外單獨列出卡在 In Progress 超過 4 天的項目與最新留言原因。」30 秒內就能產出可直接貼進 Slack 同步的精簡週報。

團隊導入 Linear MCP 的安全與權限邊界

雖然自動寫入很爽,但團隊正式導入前務必設定三條防線:

  1. 禁止未經確認的批次刪除或狀態覆蓋:在系統提示詞(System Prompt / .cursorrules)中明確規定,任何「修改超過 3 張票」或「關閉 Issue」的操作,必須先輸出變更清單並等待人類輸入確認。
  2. 善用草稿區(Triage):如果是讓自動化腳本或客服回饋機器人透過 MCP 建票,統一指定寫入團隊的 Triage 狀態,由 PM 每天定時審核後再排進正式 Backlog。
  3. 保護敏感客戶資料:若 Linear Issue 中包含客戶聯絡方式或內部帳號資訊,務必確認所使用的 AI 端已開啟企業級隱私保護(不將對話用於模型訓練)。

常見問題(FAQ)

Q1:Linear MCP 需要付費才能用嗎?

Linear MCP 本身不額外收費,只要擁有 Linear 帳號(包含免費版)即可使用。但你使用的 AI 客戶端(如 Claude Pro 或 Cursor Pro)通常需要對應的訂閱方案才能獲得較穩定的 MCP 工具呼叫額度。

Q2:AI 建出來的票會不會格式很亂、標籤都選錯?

會,如果你沒讓它先讀取現有結構的話。實務上的標準做法是要求 AI 在 create_issue 之前,先呼叫讀取 Labels、Workflow States 與 Cycle 的工具,強制它只能從現有的清單中挑選對應屬性。

Q3:Linear MCP 可以讀取外部連結(例如附在票裡的 Figma 或 Notion 頁面)嗎?

Linear MCP 本身只讀取 Linear 內的文字、留言與連結字串。如果你想讓 AI 同時看懂裡面附的 Figma 設計稿或 Notion 規格,只要在同一個客戶端同時掛載 Figma MCP 與 Notion MCP,AI 就能自動跨系統串聯讀取。

Q4:如果團隊用自架的 GitHub Issues 或 Jira,有類似的做法嗎?

有的。GitHub 官方與 Atlassian 生態系都有對應的 MCP Server,操作邏輯完全一致:先建立只讀測試、規範建票模板,再逐步開放狀態更新權限。

結語:讓專案管理系統從「人工填表」變成「自動同步」

好的專案管理不該讓團隊花 30% 的時間在維護看板。當 Linear 透過 MCP 接上日常工作的 AI 介面,進度更新會自然發生在討論與寫程式的當下,PM 也能把力氣真正花在釐清優先級與排除團隊障礙。

歡迎免費訂閱 AI 郵報,每週追蹤更多產品經理(PM)與 UI/UX 設計師的 AI 轉型實戰。

Read more