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

圖:本站根據 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/mcp | Streamable HTTP | 當前主流客戶端(Claude Code、新版 Cursor、Codex、VS Code)首選地址 |
https://mcp.linear.app/sse | HTTP + SSE | 僅用於尚未支持 Streamable HTTP 的舊版本客戶端兼容回退 |
| 只讀限定配置 | Streamable HTTP | 只允許查詢 Issue、Project 與評論,攔截創建或狀態修改操作 |
關於這兩種遠程協議的底層區別,可先看 MCP 的 stdio、SSE 和 Streamable HTTP 有什麼區別。不確定客戶端版本時,一律優先填 https://mcp.linear.app/mcp。
二、在主流編程工具中接入 mcp.linear.app
1. Claude Code 配置方法
- 在終端運行命令註冊遠程 HTTP 伺服器(加上
--scope user可對本機所有倉庫生效):
bash
claude mcp add --transport http linear https://mcp.linear.app/mcp
- 進入
claude會話,輸入/mcp查看已註冊服務。 - 選中
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)與評論的工具:
- 按編號精準拉取上下文:直接對助手說「讀取 Linear 裏的
ENG-402號 Issue 詳情和全部評論,結合當前倉庫分析復現原因」; - 查當前迭代待辦:輸入「列出 Linear 當前 Cycle 裏分配給我、狀態為 Todo 或 In Progress 的所有任務,按優先級排序」;
- 拆解子任務與改狀態:修完代碼提交分支後,可讓助手「在
ENG-402下留一條包含改動文件摘要的評論,並把狀態更新為 In Review」。
建議團隊協作時把建單和改狀態工具設為「每次詢問確認」,避免模型理解偏差把尚未合入主幹的任務提前標成已完成(Done)。

圖:本站根據 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,全程無需交出帳號密碼,支持開具增值稅發票;實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。
相關教學
- Claude Code MCP 配置教學:claude mcp add、配置文件位置與常用 MCP
- Cursor MCP 配置教學:mcp.json 寫法、項目與全局位置、OAuth 與連接失敗排查
- Codex 怎麼配置 MCP:codex mcp add 命令、config.toml 寫法與常見問題
- MCP 的 stdio、SSE 和 Streamable HTTP 有什麼區別
參考資料
- 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
0 條評論
還沒有評論,來搶沙發~