Linear MCP 一覽
資訊來自 Linear 的 MCP 文件、更新日誌和 API 文件,查核日期為 2026 年 11 月 17 日。這個伺服器由 Linear 開發,並以 Anthropic 驗證的身分列在 Claude 的連接器目錄中。
| Linear MCP 伺服器 | |
|---|---|
| 端點(讀取與寫入) | https://mcp.linear.app/mcp |
| 唯讀端點 | https://mcp.linear.app/mcp/readonly,「只會提供讀取工具」;2026 年 11 月 5 日起列於 MCP registry |
| 傳輸方式 | Streamable HTTP。不支援遠端 MCP 的用戶端可透過 npm 模組 mcp-remote 連線 |
| 驗證 | OAuth 2.1 搭配動態用戶端註冊(只支援 PKCE S256),或在 Authorization: Bearer <yourtoken> 標頭中帶入 OAuth 權杖或 Linear API key。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 key 時每位使用者每小時 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。
Claude Code
在終端機執行指令,接著在 Claude Code 工作階段中執行
/mcp,完成 Linear 的登入。加上--scope user可在每個專案使用 Linear,加上--scope project則透過.mcp.json與團隊共用。想跳過登入,可以用--header "Authorization: Bearer your-token"傳入權杖。如果你用 claude.ai 訂閱登入 Claude Code,在 claude.ai 連接的 Linear 也會出現在 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 /mcpClaude(claude.ai、桌面版和行動版)
Linear 的連接器列在 Claude 的連接器目錄中。以下是 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 onCursor
Linear 的文件用 Cursor deeplink 安裝(設定為
{"url":"https://mcp.linear.app/mcp"}),或在 Cursor 的 MCP 工具頁面搜尋 Linear;一鍵 OAuth 安裝隨 Cursor 1.0 推出。Linear 的 Cursor 頁面也提供手動的mcp-remote設定。Cursor 自己的文件則把遠端伺服器放在~/.cursor/mcp.json(全域)或.cursor/mcp.json(專案),並使用url欄位。更多見 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"]}}}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"]}}}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 linearWindsurf
Linear 的 Windsurf 頁面說,選擇 Cascade 外掛圖示,從那裡安裝 Linear MCP 伺服器,或照下方方式手動加入。Windsurf 的 MCP 文件網址現在會轉到 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"]}}}Zed
Linear 記載了兩種寫法:文件頁面用第一種,Zed 整合頁面用第二種。Zed 自己的文件也支援以網址新增遠端伺服器(Settings → AI → MCP Servers → Add Remote Server),並走 MCP OAuth 流程,但 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": {}}}}ChatGPT(deep research 連接器)
Linear 的 ChatGPT 頁面只涵蓋 deep research 連接器:在 ChatGPT 的連接器設定中連接 Linear,再把 Linear 加為 deep research 的來源。Plus 和 Pro 使用者(不含 EEA、瑞士和英國)以及 Team、Enterprise 和 Edu 使用者可用。Linear 沒有記載如何在 ChatGPT 的開發人員模式中加入它的 MCP 網址。OpenAI 把 Linear 列為 ChatGPT 外掛,而 ChatGPT 桌面版則透過上方的 Codex 設定使用這個 MCP 伺服器。更多見 ChatGPT + Linear。
ChatGPT connector settings > connect Linear Deep research > add Linear as a source其他用戶端,透過 mcp-remote
對於會執行本機 MCP 指令、但不支援遠端 MCP 的用戶端,Linear 提供以下數值。Linear 也記載了 fx(
/mcp add linear https://mcp.linear.app/mcp,再執行/mcp login linear)和 v0 by Vercel(從它的 MCP 連線頁面安裝)。Command: npx Arguments: -y mcp-remote https://mcp.linear.app/mcp Environment: None
你可以用它做什麼
Linear 的文件把這些工具描述為「在 Linear 中搜尋、建立和更新 issue、專案和留言等物件」,但沒有逐一列出名稱。以下名稱來自 Anthropic 的連接器目錄(22 個工具)和 Linear 的更新日誌。目錄中的清單早於 Linear 在 2026 年 2 月的新增項目,所以你的用戶端可能顯示更多工具。
- Issue:
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 issue」或「為這個 bug 建立一個 issue 並指派給我」。 - 留言:
list_comments、create_comment。試試:「摘要 ENG-123 的留言,並加一則說明修正方式的留言」。 - 專案:
list_projects、get_project、create_project、update_project。試試:「為帳單改寫建立一個專案,並把這三個 issue 加進去」。 - 團隊、使用者和 cycle:
list_teams、get_team(自 2026 年 9 月 14 日起會回傳每個團隊的可見度和retiredAt)、list_users、get_user、list_cycles。自 2026 年 10 月 22 日起,可以用姓名的一部分來指派人員。試試:「目前 cycle 中有哪些 issue 還沒有指派對象?」 - 文件與說明:
list_documents、get_document、search_documentation(Linear 自己的文件)。試試:「在 Linear 找到我們的新人上手規格並摘要」。 - 客戶:
list_customer_needs(自 2026 年 10 月 8 日起)會回傳某個 issue、專案或 initiative 的客戶需求;自 2026 年 10 月 22 日起,也能用網域和外部 ID 查詢客戶。試試:「哪些客戶要求過 SSO?」 - 產品管理(自 2026 年 2 月 5 日起):建立和編輯 initiative、initiative 更新、專案里程碑和專案更新,管理專案標籤,載入圖片,以及從網址載入 Linear 資源。試試:「根據已關閉的 issue,寫出 Mobile v2 本週的專案更新」。
- 自 2026 年 11 月 5 日起,伺服器會向用戶端傳送如何使用其工具的預設說明。
唯讀存取
Linear 記載了三種方式,可以避免 AI 用戶端更動任何東西:
- 使用唯讀端點
https://mcp.linear.app/mcp/readonly,它只會提供讀取工具。 - 使用
https://mcp.linear.app/mcp,但只授予readOAuth 範圍,這樣權杖就無法呼叫寫入 API。 - 在
Authorization: Bearer標頭中傳入只有 Read 權限的 Linear API key。
疑難排解
- 連線失敗或需要試好幾次: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:把網址改成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 日:新增 initiative、initiative 更新、專案里程碑、專案更新、專案標籤、圖片和資源網址;降低 token 用量;宣布移除 SSE,改用
/mcp。 - 2026 年 8 月 13 日:透過 Okta 的企業管理登入,適用於使用 Okta SAML 的 Enterprise 工作區。
- 2026 年 9 月 14 日:
list_teams和get_team會回傳團隊可見度和retiredAt。 - 2026 年 10 月 8 日:新增
list_customer_needs工具;PKCE 必須明確使用 S256 方法。 - 2026 年 10 月 22 日:可用部分姓名指派使用者、用網域和外部 ID 查詢客戶,透過 MCP 建立的子 issue 現在會沿用父 issue 的專案。
- 2026 年 11 月 5 日:用戶端預設說明、
list_issues的completedAt篩選,以及唯讀端點列入 MCP registry。 - 2026 年 11 月 12 日:以 API key 和應用程式權杖編輯描述與文件時,會保留未更動內容的格式。
Linear 搭配各個 AI agent
有些 agent 除了 MCP 伺服器之外,還有自己的 Linear 整合。每個頁面都涵蓋該 agent 與 Linear 搭配的所有方式。
由 AI agent 擔任負責人的看板
Linear 是為人打造的,agent 以受託人的身分加入。Crewmark 則是為 AI 員工團隊打造的 issue 追蹤工具。每位員工都是你自己電腦上的一段 Claude Code 或 Codex 對話,有職位、KPI 和專案;OpenCode 和 DeepSeek Harness 等其他 agent 則透過 Agent Client Protocol 連接。把 issue 指派給它,它就開始工作:它會在工作時間內依心跳醒來,隨時更新狀態、留言並 @提及其他員工,需要你時把 issue 設為「需處理」。
Crewmark 不會連接到 Linear。如果你的團隊繼續使用 Linear,員工仍然可以像使用其他工具一樣,使用你在它電腦上設定好的 Linear MCP 伺服器。Crewmark 以 GPL-3.0 授權開源,1 個專案、最多 3 位 AI 員工免費;agent 使用的是你已有的方案。
| Linear MCP 伺服器 | Crewmark | |
|---|---|---|
| 它是什麼 | 讓 AI 用戶端讀取和更動 Linear 的連線 | 由 AI 員工負責 issue 的 issue 追蹤工具 |
| 誰來做事 | 你,向你的 AI 用戶端下提示 | 每位 AI 員工,在工作時間內依心跳運作 |
| agent 在哪裡執行 | 在你的 AI 用戶端中 | 你自己的電腦,在你平常的 Claude Code 或 Codex 設定中 |
| 需要你的時候 | 等你下一個提示 | 把 issue 設為「需處理」,並在那裡問你 |
Linear MCP 常見問題
什麼是 Linear MCP 伺服器?
Linear 官方代管的遠端 MCP 伺服器,網址是 https://mcp.linear.app/mcp。Claude、Cursor、Codex、VS Code、Windsurf 和 Zed 等 AI 用戶端可以透過它搜尋、建立和更新 Linear 的 issue、專案、留言等內容。Linear 在 2025 年 5 月 1 日推出。
Linear MCP 伺服器免費嗎?
Linear 沒有指明它需要哪種方案,也沒有另外收費:其價格頁面把「MCP server」列在整合項目中,所有 Linear 方案都有 API 存取。只有附加功能有方案限制:Claude 自動連線需要 Linear Business 或 Enterprise,Okta 管理的登入需要 Enterprise。你的 AI 用戶端本身的方案仍然適用。
怎麼把 Linear MCP 加到 Claude Code?
執行 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 deeplink 或 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 範圍;或以 Bearer 權杖傳入只有 Read 權限的 Linear API key。
為什麼我的 Linear MCP 連線失敗?
Linear 表示遠端 MCP 連線仍在早期階段,可能要試好幾次:重新啟動用戶端,或把伺服器關掉再打開。如果出現內部伺服器錯誤,請執行 rm -rf ~/.mcp-auth、重新連線並更新 Node。如果你的設定還指向 /sse,請改成 https://mcp.linear.app/mcp;Linear 正在移除 SSE 支援。
已於 2026 年 11 月 17 日對照 Linear 的文件和更新日誌,以及各用戶端的文件查核。