Linear 官方 MCP Server 怎麼配:連 mcp.linear.app 查 Issue、建任務、更新狀態與授權排錯

Linear 官方提供遠程 MCP 伺服器 https://mcp.linear.app/mcp。本文按官方文檔整理在 Claude Code、Cursor 與 Codex 裏的 OAuth 配置、只讀模式 URL、Issue 讀寫用法與授權排錯。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

  1. Linear 官方遠程 MCP 標準地址是 https://mcp.linear.app/mcp,採用 Streamable HTTP 協議與動態 OAuth 2.1 認證,無需在本地運行 Node 服務或手填個人 API Key。
  2. 支持獨立只讀入口:如果只想讓 AI 查需求、讀評論而不允許改單或建單,可將連接地址改為只讀路徑(如官方提供的 /readonly 變體)或在客戶端裏關閉寫類工具自動放行。
  3. 本配置與「在 Linear 裏把 Issue 委派給雲端 Agent」是兩套機制:遠程 MCP 是讓你在本地編輯器裏主動讀寫 Linear,而不是在 Linear 介面裏 @ 機器人自動提 PR。
  4. 授權權限嚴格跟隨當前登入的 Linear 帳號:你看不到的私有團隊(Private Team)Issue,AI 通過 MCP 同樣無法讀取。
  5. 主力模型訂閱與帳號配套入口:跑通 MCP 工具鏈與多文件智能體編碼依賴穩定的底層大模型配額,國內免境外卡自助開通可見本站 Claude Code 訂閱頁、ChatGPT Plus 充值頁 與 AI 會員充值總覽。

Linear 官方遠程 MCP 配置步驟與端點選擇

圖:本站根據 Linear 官方文檔:MCP server 整理的示意圖

本文根據 Linear 官方文檔《MCP server》及 Claude Code、Cursor 官方 MCP 文檔整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Linear 或 Anthropic 官方網站。

適用於誰

  • 想在本地 IDE 或終端編碼工具裏直接查詢 Linear Issue、新建缺陷單、改狀態或加評論的研發人員;
  • 不想使用第三方非官方腳本管理 API Key,希望直接接入 mcp.linear.app 官方託管服務的團隊;
  • 配置 Linear MCP 後遇到 /sse 與 /mcp 混淆、OAuth 跳不過去或找不到團隊項目的人。

一、選對端點:/mcp、/sse 與只讀模式

在社區舊帖裏經常能看到不同的 Linear 地址寫法,按 Linear 官方現行說明區分如下:

端點地址傳輸方式適用情況
https://mcp.linear.app/mcpStreamable HTTP當前主流客戶端(Claude Code、新版 Cursor、Codex、VS Code)首選地址
https://mcp.linear.app/sseHTTP + SSE僅用於尚未支持 Streamable HTTP 的舊版本客戶端兼容回退
只讀限定配置Streamable HTTP只允許查詢 Issue、Project 與評論,攔截創建或狀態修改操作

關於這兩種遠程協議的底層區別,可先看 MCP 的 stdio、SSE 和 Streamable HTTP 有什麼區別。不確定客戶端版本時,一律優先填 https://mcp.linear.app/mcp。

二、在主流編程工具中接入 mcp.linear.app

1. Claude Code 配置方法

  1. 在終端運行命令註冊遠程 HTTP 伺服器(加上 --scope user 可對本機所有倉庫生效):
bash
claude mcp add --transport http linear https://mcp.linear.app/mcp
  1. 進入 claude 會話,輸入 /mcp 查看已註冊服務。
  2. 選中 linear 發起瀏覽器 OAuth 登入,在 Linear 授權頁確認目標工作區並點擊允許(Authorize)。詳細命令參數見 Claude Code MCP 配置教學。

日常讓 Claude Code 一邊拉取 Linear 缺陷描述、一邊定位代碼並跑測試,對上下文額度的消耗比較集中;若需升級訂閱檔位,可參考本站 Claude Code 充值頁。

2. Cursor 與桌面客戶端配置方法

打開項目級 .cursor/mcp.json 或全局 ~/.cursor/mcp.json,寫入:

json
{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/mcp"
    }
  }
}

儲存後打開設定(Settings)> Cursor Settings > 工具與 MCP(Tools & MCP),點擊 linear 右側的登入按鈕完成網頁授權。若遇到配置文件路徑或語法報錯,見 Cursor MCP 配置教學。

3. Codex CLI 配置方法

在 ~/.codex/config.toml 中添加:

toml
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

隨後在終端執行 codex mcp login linear 完成瀏覽器認證即可。更多 config.toml 字段說明可查閱 Codex 怎麼配置 MCP。

編程訂閱與高配額省心方案:在 Cursor、Claude Code 或 Codex 裏掛載外部工具做長鏈路開發時,固定月費訂閱通常比純按量 API 更易控成本。本站支持支付寶、微信支付與 AlipayHK 免密自助兌換 Claude Pro、Claude Max 與 ChatGPT Pro,團隊協作亦可定製 ChatGPT Business 團隊版。

三、查 Issue、建任務與更新狀態的常用做法

連上 Linear 官方 MCP 後,客戶端會自動加載管理 Issue、項目(Projects)、週期(Cycles)與評論的工具:

  1. 按編號精準拉取上下文:直接對助手說「讀取 Linear 裏的 ENG-402 號 Issue 詳情和全部評論,結合當前倉庫分析復現原因」;
  2. 查當前迭代待辦:輸入「列出 Linear 當前 Cycle 裏分配給我、狀態為 Todo 或 In Progress 的所有任務,按優先級排序」;
  3. 拆解子任務與改狀態:修完代碼提交分支後,可讓助手「在 ENG-402 下留一條包含改動文件摘要的評論,並把狀態更新為 In Review」。

建議團隊協作時把建單和改狀態工具設為「每次詢問確認」,避免模型理解偏差把尚未合入主幹的任務提前標成已完成(Done)。

Linear 官方 MCP 授權與工具調用異常排查

圖:本站根據 Linear 官方文檔:MCP server 整理的示意圖

四、常見授權報錯與連接排錯

  • 瀏覽器點同意後客戶端仍報 Unauthorized 或 401:常見於曾連接過舊版 /sse 端點導致本地緩存了失效的客戶端憑證。先在客戶端移除 linear 配置,重新添加 /mcp 地址後再觸發一次 /mcp 登入。
  • 提示工作區限制第三方應用(Admin approval required):如果公司 Linear 工作區開啟了集成審批開關,普通成員授權後會進入待審核隊列,需要工作區管理員在 Linear 設定(Settings)> 安全或已授權應用中放行。
  • 非交互式環境(如 CI 腳本)無法彈窗登入:遠程 OAuth 面向本地交互客戶端;若在無瀏覽器的流水線中運行,可按 Linear 文檔改在請求頭傳入個人 API Key 或 OAuth Access Token(Authorization: Bearer <TOKEN>)。

常見問題

問:配了 mcp.linear.app 和 GitHub Issue MCP 會衝突嗎?

答:不會衝突,但同時掛載過多 MCP 會佔用模型初始上下文。若團隊用 Linear 管需求、用 GitHub 管 PR,可按需啟停;GitHub 側做法見 Claude Code 管理 GitHub issue。

問:一個瀏覽器登了多個 Linear 工作區怎麼切換?

答:OAuth 授權頁頂部可以選擇要綁定的具體 Linear 工作區。如果想換到另一個工作區,先在客戶端斷開重連並在授權頁重新勾選對應組織。

問:怎麼徹底斷開並收回 AI 工具對 Linear 的權限?

答:打開 Linear 應用的設定(Settings)> 帳號(Account)> 安全與訪問(Security & access),在已授權應用列表裏找到對應的 MCP 客戶端並點擊撤銷(Revoke)。

問:配置好開發環境後,國內沒有外幣卡怎麼開通 Claude 或 ChatGPT 編程訂閱?

答:可在 本站充值中心 自助選購卡密開通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程無需交出帳號密碼,支持開具增值稅發票;實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。

相關教學

參考資料

  • Linear 官方文檔:MCP server — https://linear.app/docs/mcp
  • Claude Code 官方文檔:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
  • Cursor 官方文檔:Model Context Protocol (MCP) — https://cursor.com/docs/context/mcp

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 速讀英文產品手冊、開源文檔與 GitHub Issue 並沉澱團隊中文內訓手冊

    團隊引入海外 SaaS 工具或開源框架時,全英文文檔晦澀冗長、真正的坑全藏在幾十頁 GitHub Issue 討論裏。本文分享速讀拆解英文手冊、歸類 Issue 排障庫以及重構團隊中文內訓 SOP 的完整實戰流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 寫油猴腳本(Tampermonkey)與瀏覽器書籤小工具解決網頁繁瑣重複操作實戰

    每天在後台系統裏重複勾選幾十個複選框、手工複製網頁表格或清理遮擋閱讀的側邊欄,既枯燥又浪費時間。本文分享不會寫 JS 也能用 F12 配合 ChatGPT 寫出油猴腳本與書籤小工具的完整實戰流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 寫高質素 SQL 窗口函數(RANK / LAG / SUM OVER)做留存與漏斗分析實戰

    做用戶留存率、復購間隔與有序轉化漏斗時,多層自連接既難讀又拖垮數據庫,窗口函數則是高效解法。本文整理數據庫方言喂數規範、CTE 分層提示詞以及用內置沙盒先驗證再上線的完整實戰流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 連接 Canva、Figma、Linear、Jira、Dropbox 等第三方應用搜不到數據或授權失效怎麼辦

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 後,明明顯示已連接卻搜不到文件工單,或老提示授權失效怎麼辦?本文拆解帳號錯綁、OAuth 範圍漏選、權限繼承與管理員攔截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  6. 06

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~