🚀 线性 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”，允许您同时与多个线性工作区交互。