Linear MCP Server

Linear MCP Server

Linear MCP 服务器是对 Linear 的模型上下文协议 (MCP) 集成,允许语言模型通过编程方式与 Linear 的问题跟踪系统互动。它使 AI 工具和代理能够通过标准化协议端点创建、更新、搜索和管理 Linear 问题和评论,以及查询用户和团队信息。

Author: jerhadf


查看协议

什么是 Linear MCP 服务器?

Linear MCP 服务器是一个轻量级服务器,充当 AI 应用程序(如 Claude Desktop)和 Linear 问题跟踪 API 之间的桥梁。它遵循模型上下文协议,提供 Linear 功能,如问题创建、更新、评论和搜索,这些功能可被大型语言模型轻松访问。这简化了工作流程,自动化了项目管理,增强了通过 AI 与 Linear 的无缝集成的生产力。

如何配置

  1. 访问你的 Linear 团队的 API 设置页面以获取 Linear API 密钥。
  2. 针对 Claude Desktop 的集成,在你的 claude_desktop_config.json 中添加以下配置(位于 MacOS 的 ~/Library/Application Support/Claude/):
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "你的_linear_api_key_here"
      }
    }
  }
}
  1. 或者,可以通过 Smithery 自动安装:
npx @smithery/cli install linear-mcp-server --client claude
  1. 确保通过环境变量安全地提供 LINEAR_API_KEY,如配置所示。

如何使用

配置并启动服务器后:

  • 使用你的 AI 应用程序(例如 Claude Desktop)通过自然语言查询 Linear。应用程序将自动发现通过 MCP 提供的可用 Linear 工具和资源。
  • 示例操作包括创建新问题、更新问题状态、按关键字或优先级搜索任务、检索已分配的问题或添加评论。
  • 使用 "显示我所有高优先级的问题" 或 "创建一个关于登录失败的错误报告" 的提示将触发相应的 MCP 工具调用。
  • 开发者可以直接使用 MCP 端点,如 tools/call,调用 Linear 功能,或使用 tools/list 浏览可用选项。

主要特点

  • 通过模型上下文协议实现 AI 应用与 Linear 之间的无缝连接。
  • 无需自定义集成编码;所有主要问题操作都作为标准化工具提供。
  • 预定义工具用于问题创建、更新、搜索、用户查询和评论。
  • 支持安全的本地环境配置,确保 API 密钥安全存放在你的基础设施内。
  • 资源端点支持直接检索或聚合 Linear 实体,如问题和团队任务列表。
  • 开源(MIT 许可证),支持修改和自托管。

使用案例

  • 自动化从自然语言的错误报告或功能请求中创建、分类和跟踪工程工单。
  • 在站会上快速显示分配的任务或高优先级问题。
  • 使 AI 代理能够直接在 Linear 内监控、总结和更新正在进行的工作进展。
  • 使用自然语言快速过滤按团队、负责人、标签或自定义标准的任务搜索。
  • 在对话工作流中给 Linear 问题添加评论或澄清。
  • 分析不同团队或用户的工作负载和积压分配。

常见问题

问1: 线性 MCP 服务器还在维护吗?
答1: 不,这个项目已经弃用。有关最新的官方线性 MCP 集成,请参考 https://linear.app/changelog/2025-05-01-mcphttps://mcp.linear.app/sse

问2: 我可以将 Linear MCP 服务器与 Claude Desktop 以外的其他 LLM 工具一起使用吗?
答2: 可以,你可以在任何兼容模型上下文协议的主机上使用它,尽管提供的配置示例专门针对 Claude Desktop。

问3: 我需要编写代码才能与 Linear MCP 服务器互动吗?
答3: 不一定。如果你的 AI 应用支持 MCP,你可以通过自然语言与 Linear 互动。如果愿意,开发者可以直接调用工具端点。

问4: 我该将 Linear API 密钥存储在哪里?
答4: 请将 API 密钥存储在环境变量或应用程序的配置文件中,如所示。请勿公开分享或暴露它。

问5: 如果我的 API 密钥过期或被撤销,会发生什么?
答5: MCP 服务器将失去对 Linear 的访问,所有工具调用将失败,直到提供有效的 API 密钥。