Zed MCP Server Linear

🚀 線性 MCP 服務器的 Zed 擴展

本擴展將 我自己的線性 MCP 服務器 集成到 Zed 的 AI 助手中，藉助 Zed 實現與線性的直接交互。

🚀 快速開始

此擴展能讓你通過 Zed 與線性進行直接交互，下面將為你介紹具體的設置方法。

✨ 主要特性

• ✨ 通過 MCP 實現全面的線性 API 集成
• 🔄 可直接從 Zed 創建、更新和管理問題
• 📝 支持評論管理（創建、更新、刪除、解決）
• 📊 具備項目和里程碑管理功能
• 👥 支持多工作區
• 🔍 提供高級問題搜索和過濾功能
• 🏷️ 可進行標籤管理
• 📎 支持父/子問題關係

📦 安裝指南

選項 1：開發者令牌

1. 訪問線性：工作區設置 > API > OAuth 應用程序 > 創建或選擇一個應用程序（例如，“Cline MCP”）。
2. 在“開發者令牌”下，點擊“創建並複製令牌”。
3. 選擇“應用程序”作為操作員，並複製生成的令牌。

選項 2：個人 API 密鑰

1. 訪問線性：您的個人設置 > API > 個人 API 密鑰。
2. 點擊“創建密鑰”，給它一個標籤（例如，“Cline MCP”），然後複製生成的密鑰。

在 Zed 中設置

獲取剛剛收到的密鑰，並將其添加到 Zed 的 settings.json 文件中的“context_servers”字段：

{
  "context_servers": {
    "mcp-server-linear": {
      "settings": {
        "linear_api_key": "<LINEAR_API_KEY>",
        "tool_prefix": "<可選工具前綴>"
      }
    }
  }
}

您還可以將這些密鑰直接添加到一個代理配置文件中，例如：

{
  "assistant": {
    "profiles": {
      "write": {
        "name": "Write",
        "context_servers": {
          "mcp-server-linear": {
            "settings": {
              "linear_api_key": "<LINEAR_API_KEY>",
              "tool_prefix": "company1" // 可選
            }
          }
        }
      }
    }
  }
}

📚 詳細文檔

多工作區支持

如果您使用多個線性工作區，可以使用可選的“tool_prefix”設置來在所有線性工具前添加前綴。這有助於區分不同的工作區：

{
  "context_servers": {
    "mcp-server-linear": {
      "settings": {
        "linear_api_key": "<LINEAR_API_KEY>",
        "tool_prefix": "company1"
      }
    }
  }
}

使用此配置：

• 工具名稱將帶有前綴（例如，“company1_linear_create_issue”）
• 能清楚地區分每個工具操作的工作區
• 可防止在處理多個線性實例時發生衝突

多個同時安裝

您可以通過配置不同命令塊並使用唯一的“TOOL_PREFIX”值來運行多個線性 MCP 服務器的實例：

{
  "context_servers": {
    "mcp-server-linear": {
      // 通過 Zed 擴展提供
      "settings": {
        "linear_api_key": "<LINEAR_API_KEY>",
        "tool_prefix": "company1"
      }
    },
    "linear-workspace2": {
      // 通過 npx 提供
      "settings": {},
      "command": {
        "command": "npx",
        "args": ["-y", "mcp-server-linear"],
        "env": {
          "LINEAR_ACCESS_TOKEN": "<LINEAR_API_KEY_2>",
          "TOOL_PREFIX": "workspace2"
        }
      }
    }
  }
}

每個實例都將工具前綴為指定的“TOOL_PREFIX”，允許您同時與多個線性工作區交互。