Linear MCP：AI 原生的專案管理整合

您的 AI 代理已經會寫程式、分類電子郵件與管理基礎架構。但在專案管理方面，它們是盲目的——無法看到待辦清單、建立議題或更新專案狀態，只能靠手動複製貼上。

Linear MCP 解決了這個問題。 它讓任何相容 MCP 的 AI 代理完整、結構化地存取您的 Linear 工作區。

功能說明

Linear MCP 透過 Model Context Protocol 公開 Linear 的整個專案管理介面。AI 代理可以：

核心工作管理

• 議題——建立（單筆或批次）、更新、搜尋、刪除、管理父子階層，以及建立議題關聯
• 專案——建立、更新、刪除、搜尋、隨議題建立，以及與計畫關聯
• 留言——建立串狀回覆、更新、刪除、解決/取消解決討論串
• 里程碑——完整 CRUD 加批次建立與搜尋

工作流程與探索

• 團隊、使用者、工作流程狀態、標籤與週期
• 自由文字搜尋，含選用篩選（團隊、專案、負責人、狀態、優先順序、週期）
• 精確議題識別碼解析（如 ENG-431），並備援至排名搜尋

整合與進階介面

• 附件、Webhook、組合實體（計畫、客戶）
• 代理会話與代理活動
• 執行時能力探索與即時診斷

架構

AI Agent (Claude / Codex / OpenClaw / Cline)
  -> MCP transport (stdio or HTTP)
    -> Linear MCP server
      -> Linear GraphQL API

Linear MCP 在處理器分派前於執行時強制工具結構描述。格式錯誤的承載會在 MCP 邊界以結構化驗證錯誤失敗——而非深入 Linear 的 API 中。

受守護合約——關鍵議題工作流程（單筆建立、批次建立、搜尋）使用經稽核的原始 GraphQL 作業而非 SDK 變動，防止 SDK 回歸影響您的代理。執行 npm run verify:linear-api-contracts 以在本機稽核。

結構化遙測——每個工具請求發出 stderr 遙測，含工具名稱、傳輸、持續時間與已清理的失敗中繼資料，以供疑難排解。

驗證

API 金鑰（最簡單）：

LINEAR_API_KEY=your_personal_access_token

OAuth（適用於共享或遠端部署）：

1. 以您的 clientId、clientSecret 與 redirectUri 呼叫 linear_auth
2. 開啟回傳的授權 URL
3. 以 code 與 state 呼叫 linear_auth_callback

在串流模式下，每個 MCP 会話取得各自隔離的驗證上下文。

快速開始

# Install from npm
npx @kkaminsk/linear-mcp

# Or clone and build
git clone https://github.com/kkaminsk/linear-mcp.git
cd linear-mcp && npm install && npm run build

# Run with API key
LINEAR_API_KEY=your_key npm start

MCP 客戶端設定：

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_personal_access_token"
      }
    }
  }
}

適用對象

• 開發團隊——AI 代理可作為工作流程一部分進行議題分類、建立與更新
• 工程管理者——自動化專案狀態更新、里程碑追蹤與待辦清單整理
• DevOps 與 SRE 團隊——AI 代理建立事件、連結議題並追蹤解決
• AI 代理建構者——任何需要結構化存取專案管理的 MCP 客戶端

GitHub: github.com/kkaminsk/linear-mcp

npm: @kkaminsk/linear-mcp