JinDaGe - zed-mcp-server-linear MCP Details

article

README

🚀 线性 MCP 服务器的 Zed 扩展

本扩展可将我自己的线性 MCP 服务器集成到 Zed 的 AI 助手中，借助 Zed 实现与线性的直接交互。

🚀 快速开始

此扩展可将线性 MCP 服务器集成到 Zed 的 AI 助手中，让用户能通过 Zed 直接与线性进行交互。以下为您介绍详细的使用步骤。

✨ 主要特性

✨ 借助 MCP 全面集成线性 API
🔄 可直接在 Zed 中创建、更新和管理问题
📝 支持评论管理（创建、更新、删除、解决）
📊 能够进行项目和里程碑管理
👥 支持多工作区
🔍 具备高级问题搜索和过滤功能
🏷️ 可进行标签管理
📎 支持父/子问题关系

📦 安装指南

选项 1：开发者令牌

访问线性，依次点击：工作区设置 > API > OAuth 应用程序 > 创建或选择一个应用程序（例如，“Cline MCP”）。
在“开发者令牌”下，点击“创建并复制令牌”。
选择“应用程序”作为操作员，并复制生成的令牌。

选项 2：个人 API 密钥

访问线性，点击：您的个人设置 > API > 个人 API 密钥。
点击“创建密钥”，给它一个标签（例如，“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”，允许您同时与多个线性工作区交互。

zed-mcp-server-linear