关键词

Linear项目管理任务管理AI助手集成工作流自动化

使用说明

项目简介

MCP Linear 是一个基于 Model Context Protocol (MCP) 的服务器实现，它充当 AI 助手与 Linear 项目管理工具之间的桥梁。通过 MCP 协议，MCP Linear 允许 AI 助手安全地访问和操作 Linear 中的数据，从而实现更智能的任务管理和工作流程自动化。

主要功能点

  • 问题 (Issues) 管理: 检索、创建、更新和搜索 Linear 中的问题（Issues）。
  • 项目 (Projects) 管理: 创建、更新和检索 Linear 中的项目（Projects），并将问题关联到项目。
  • 团队 (Teams) 和工作流 (Workflow) 管理: 获取团队列表和团队的工作流状态。
  • 用户 (Users) 和标签 (Labels) 信息: 获取组织内的用户信息和问题标签信息。
  • 周期 (Cycles) 管理: 检索项目周期和将问题添加到周期。
  • 评论 (Comments) 功能: 为 Linear 问题添加评论。
  • 灵活的问题操作: 支持问题的指派、订阅、转化为子任务、创建关联、归档、设置优先级、转移团队和复制等多种操作。

安装步骤

  1. 获取 Linear API Token:

    • 登录 Linear 账户。
    • 点击左上角组织头像 -> Settings -> Security & access -> Personal API Keys -> New API Key。
    • 为密钥命名 (例如 'MCP Linear Integration') 并复制生成的 API Token。请妥善保管此 Token。

  2. 安装 MCP Linear:

    • 推荐使用 Smithery: Smithery 简化了 MCP 服务器的安装和配置。根据你使用的 MCP 客户端，运行相应的命令：
      • Cursor: 
        npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor
      • Claude Desktop: 
        npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude
    • 手动安装 (npm 全局安装): 
      npm install -g @tacticlaunch/mcp-linear

服务器配置

对于 MCP 客户端，你需要在其配置文件中添加 MCP Linear 服务器的配置信息。以下是 JSON 格式的配置示例，你需要将 '<YOUR_TOKEN>' 替换为你在安装步骤中获取的 Linear API Token。

{
  "mcpServers": {
    "linear": {  // 服务器名称，可以自定义
      "command": "npx", // 启动服务器的命令，这里使用 npx 执行 npm 包
      "args": ["-y", "@tacticlaunch/mcp-linear"], // 传递给 command 的参数，-y 表示自动确认，@tacticlaunch/mcp-linear 是要执行的 npm 包名
      "env": {
        "LINEAR_API_TOKEN": "<YOUR_TOKEN>" // 设置环境变量 LINEAR_API_TOKEN，用于传递 Linear API 令牌
      }
    }
  }
}

注意:

  • 如果你选择手动全局安装并使用 'mcp-linear' 命令直接运行服务器，可以将 'command' 修改为 '"mcp-linear"'，并移除 'args' 字段。同时，你需要确保环境变量 'LINEAR_API_TOKEN' 已经被正确设置。

  • 不同 MCP 客户端的配置文件位置可能不同，请参考 README.md 中的 "Client-Specific Configuration Locations" 部分查找你的客户端配置文件的位置。

基本使用方法

成功配置并启动 MCP Linear 服务器后，你可以在支持 MCP 协议的 AI 客户端中使用自然语言指令与 Linear 进行交互。

示例指令:

  • "Show me all my Linear issues" (显示我所有的 Linear 问题)
  • "Create a new issue titled 'Fix login bug' in the Frontend team" (在 Frontend 团队创建一个标题为 'Fix login bug' 的新问题)
  • "Change the status of issue FE-123 to 'In Progress'" (将问题 FE-123 的状态更改为 'In Progress')
  • "Assign issue BE-456 to John Smith" (将问题 BE-456 指派给 John Smith)
  • "Add a comment to issue UI-789: 'This needs to be fixed by Friday'" (为问题 UI-789 添加评论: 'This needs to be fixed by Friday')

请根据你的 AI 客户端的具体使用方法来调用 MCP Linear 提供的功能。

信息

分类

生产力应用

访问项目