什麼是 Linear MCP Server?
Linear MCP Server 是一個輕量級伺服器,充當人工智慧應用程序(如 Claude Desktop)和 Linear 問題追蹤 API 之間的橋樑。它遵循模型上下文協議,提供 Linear 功能,例如問題創建、更新、評論和搜索,這些都可以輕鬆被大型語言模型訪問。這簡化了工作流程,自動化了項目管理,並通過無縫整合 AI 來提高生產力。
如何配置
- 前往你的 Linear 團隊的 API 設定頁面,以獲取 Linear API 金鑰。
- 為了與 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"
}
}
}
}
- 或者,可以通過 Smithery 自動安裝:
npx @smithery/cli install linear-mcp-server --client claude
- 確保通過環境變數安全地提供你的
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-mcp 或 https://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 金鑰。