Linear MCP Server

Linear MCP Server

Linear MCP Server 是一個模型上下文協議 (MCP) 整合,讓語言模型能夠以編程方式與 Linear 的問題追蹤系統互動。它允許人工智慧工具和代理創建、更新、搜索和管理 Linear 問題和評論,並通過標準化的協議端點查詢用戶和團隊資訊。

Author: jerhadf


查看協議

什麼是 Linear MCP Server?

Linear MCP Server 是一個輕量級伺服器,充當人工智慧應用程序(如 Claude Desktop)和 Linear 問題追蹤 API 之間的橋樑。它遵循模型上下文協議,提供 Linear 功能,例如問題創建、更新、評論和搜索,這些都可以輕鬆被大型語言模型訪問。這簡化了工作流程,自動化了項目管理,並通過無縫整合 AI 來提高生產力。

如何配置

  1. 前往你的 Linear 團隊的 API 設定頁面,以獲取 Linear API 金鑰。
  2. 為了與 Claude Desktop 整合,將以下配置添加到 claude_desktop_config.json 中(位於 ~/Library/Application Support/Claude/ 的 MacOS):
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}
  1. 或者,可以通過 Smithery 自動安裝:
npx @smithery/cli install linear-mcp-server --client claude
  1. 確保通過環境變數安全地提供你的 LINEAR_API_KEY,如配置所示。

如何使用

在配置並啟動伺服器後:

  • 使用你的人工智慧應用程序(如 Claude Desktop)通過自然語言查詢 Linear。應用程序會自動發現可用的 Linear 工具和資源。
  • 示例操作包括創建新問題、更新問題狀態、按關鍵字或優先級搜索任務、檢索指派的問題或添加評論。
  • 提示如「顯示我所有的高優先級問題」或「為登錄失敗創建錯誤報告」將觸發適當的 MCP 工具調用。
  • 開發人員可以直接使用 MCP 端點如 tools/call 來調用 Linear 功能,或使用 tools/list 瀏覽可用選項。

主要特點

  • 通過模型上下文協議實現人工智慧應用程序和 Linear 之間的無縫連接。
  • 無需自定義整合代碼;所有主要的問題操作都以標準化工具的形式提供。
  • 預定義工具可用於問題創建、更新、搜索、用戶查詢和評論。
  • 支持安全的本地環境配置,將 API 金鑰保留在你的基礎設施內。
  • 資源端點允許直接檢索或聚合 Linear 實體,如問題和團隊任務列表。
  • 開源(MIT 許可證),可進行修改和自託管。

使用案例

  • 從自然語言的錯誤報告或功能請求中自動創建、分類和跟蹤工程票據。
  • 在日常會議期間快速查找指派的任務或高優先級問題給團隊成員。
  • 使 AI 代理能夠在 Linear 中直接監控、總結和更新持續衝刺的進度。
  • 使用自然語言快速過濾問題,按團隊、指派者、標籤或自定義標準進行搜尋。
  • 在對話工作流中,向 Linear 問題添加評論或澄清。
  • 分析不同團隊或用戶的工作量和待辦事項分配。

常見問題

Q1: Linear MCP Server 仍然在維護中嗎?
A1: 不,這個項目已經不再維護。最新的官方 Linear MCP 整合請參見 https://linear.app/changelog/2025-05-01-mcphttps://mcp.linear.app/sse

Q2: 我能否在 Claude Desktop 以外的其他 LLM 工具中使用 Linear MCP Server?
A2: 可以,你可以在任何兼容模型上下文協議的主機中使用它,儘管提供的配置示例特別針對 Claude Desktop。

Q3: 我需要寫代碼來與 Linear MCP Server 互動嗎?
A3: 不一定。如果你的 AI 應用程序支持 MCP,你可以通過自然語言與 Linear 互動。開發人員若需要也可以直接調用工具端點。

Q4: 我應該將我的 Linear API 金鑰儲存在哪裡?
A4: 將你的 API 金鑰儲存在環境變數或你的應用配置文件中,如示例所示。請勿公開分享或曝露。

Q5: 如果我的 API 金鑰過期或被撤銷,會發生什麼?
A5: MCP 伺服器將失去對 Linear 的訪問權限,所有工具調用將失敗,直到提供有效的 API 金鑰。