Linear MCP Server

项目管理工具是现代软件开发团队的中枢神经，而 Linear 以其简洁高效的设计理念，已成为众多开发团队的首选。但当我们的 AI 编码助手（如 Claude、Cursor、Copilot）能够编写代码、调试错误时，却无法直接操作 Linear 中的任务——查看 Issue 状态、创建新任务、更新进度——这便形成了一道无形的隔离墙。Linear MCP Server 的出现彻底打通了这道墙，它将 Linear 的项目管理能力以标准化 MCP 工具的形式注入你的 AI 助手，让你在编码环境中就能完成项目管理的全流程操作。

项目基本信息

一、项目介绍

Linear MCP Server 是 Linear 官方推出的模型上下文协议（MCP）服务器。它作为一座桥梁，让各种 MCP 客户端（如 Claude Desktop、Cursor、VS Code 等）能够通过标准化的工具接口，直接与你的 Linear 工作区进行交互。

核心能力概览

该服务器提供的工具覆盖了 Linear 工作流的核心环节：

• 议题管理：创建、查询、更新和搜索 Issue，支持按团队、状态、负责人、标签等多个维度进行筛选。
• 项目与里程碑：查看项目进度、里程碑状态，帮助 AI 理解整体开发节奏。
• 评论与协作：让 AI 能够读取 Issue 下的评论讨论，并在需要时添加新的评论。
• 工作流自动化：将 AI 辅助开发与任务状态更新紧密结合，例如在提交代码后自动将关联 Issue 标记为“已完成”。

通过将 Linear 的操作能力赋予 AI，开发者无需在编辑器、浏览器和项目管理工具之间频繁切换，真正实现了“在上下文内完成一切”。

二、核心优势

官方出品，深度集成

这是 Linear 官方提供的 MCP 服务器，而非社区第三方实现。这意味着它在 API 兼容性、功能完整性和持续维护方面拥有最高保障。每当 Linear 平台推出新功能，官方 MCP 服务器都会第一时间跟进适配。

完整的项目管理能力

与一些只提供“创建 Issue”基本功能的非官方实现不同，Linear MCP Server 覆盖了从任务创建、搜索查询、状态更新到评论协作的完整工作流。AI 不只是能帮你“记个任务”，而是能真正参与到项目管理的各个环节中。

高度可查询性

项目特别强化了搜索和筛选能力，AI 可以通过团队、负责人、状态、标签、优先级等多个维度组合查询，精准定位到你关心的 Issue 集合。这使得“帮我找出所有高优先级且未分配的前端 Bug”这样的复杂查询成为可能。

安全授权机制

连接 Linear 工作区需要有效的 API 密钥或个人访问令牌（Personal Access Token）。所有操作都在你授权的权限范围内执行，确保数据安全。

三、适用场景

开发过程中的任务查询

在编写代码时，无需切换到 Linear 网页，直接问 AI：“当前 Sprint 中分配给张工程师的、状态为‘进行中’的任务有哪些？”AI 会调用 Linear MCP Server 工具，返回精准的任务列表。

自动化工作流集成

你可以设置规则：当 Git 分支名或提交消息中包含特定的 Issue ID 时，AI 自动将该 Issue 更新为对应状态。例如，fix/ENG-123 分支合并后，自动将 ENG-123 标记为“已完成”并添加评论。

每日站会准备

早上开始工作时，让 AI 帮你汇总：“列出我名下所有即将到期或已逾期的任务，并按优先级排序。”AI 会查询 Linear 工作区并生成一份简明的待办清单。

项目进度可视化

通过询问“当前版本迭代的项目完成率是多少？”，AI 可以计算已完成任务与总任务的比例，帮助你快速把握项目整体进展。

四、安装教程

环境要求

获取 Linear API 密钥

1. 登录 Linear。
2. 进入 Settings (设置) -> API。
3. 创建一个新的 Personal API Key，并复制保存。

在 MCP 客户端中配置

Claude Desktop 配置

编辑 claude_desktop_config.json 文件，位置如下：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@linear/mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your-linear-api-key"
      }
    }
  }
}

Cursor 配置

在 ~/.cursor/mcp.json 中添加相同的配置结构。

VS Code 配置

在 .vscode/mcp.json 中添加相同的配置结构。

配置完成后，重启你的 MCP 客户端，Linear MCP Server 即可开始工作。

五、使用示例

示例一：查询当前任务

用户：帮我查看当前 Sprint 中所有优先级为“紧急”且未分配的任务。

AI 会调用 Linear MCP Server 的查询工具，按条件筛选并返回任务列表，包含标题、状态、负责人等信息。

示例二：创建新 Issue

用户：创建一个新 Issue，标题为“用户登录页面在 Safari 中无法正常显示”，分配给李工程师，优先级设为“高”，并附上描述：“在 Safari 17.4 版本中测试发现登录按钮错位，详见截图。”

AI 会调用 create_issue 工具，填写完整的任务信息并返回创建成功的确认。

示例三：更新 Issue 状态

用户：把 Issue ENG-456 的状态改为“已完成”，并添加评论“已在 PR #789 中修复，等待部署。”

AI 会依次调用状态更新和评论添加工具，完成操作。

示例四：汇总工作进展

用户：总结一下这个迭代中，前端团队完成了多少个 Issue，还有多少在进行中。

AI 会查询迭代面板数据，计算出完成与未完成任务的统计信息，并给出简洁的总结。

六、常见问题

问：配置后 Claude 提示“工具未找到”怎么办？

答：请按以下步骤排查：

1. 检查 API 密钥：确保 LINEAR_API_KEY 正确且未过期。
2. 查看网络：npx 首次运行时需要从 npm 下载 @linear/mcp-server 包，请确保网络连接正常。
3. 检查配置文件：确认 JSON 格式正确，没有丢失逗号或括号。

问：AI 能访问我 Linear 工作区的所有数据吗？

答：AI 的访问权限取决于你提供的 API 密钥所关联的账户权限。建议使用最小权限原则，仅为 MCP 服务器创建一个专用的 API 密钥，并限制其权限范围。

问：支持哪些 Linear 操作？

答：目前支持的操作包括：创建 Issue、查询 Issue、更新 Issue 状态和属性、添加评论、搜索项目等。具体的完整工具列表可在连接后通过 MCP 客户端的工具发现功能查看。

七、总结

Linear MCP Server 是 Linear 团队为 AI 辅助开发时代交出的一份精彩答卷。它将项目管理从独立的 Web 应用中解放出来，无缝融入开发者的编码环境。通过标准化的 MCP 协议，你的 AI 助手不仅能帮写代码，还能帮你管理写代码的任务——这或许正是未来人机协作的应有姿态。

对于所有 Linear 用户和 AI 辅助开发的实践者来说，这个官方 MCP 服务器不是“锦上添花”的装饰，而是能实实在在减少上下文切换、提升工作流效率的生产力利器。花几分钟完成配置，你会惊讶于这种“在代码里管任务”的全新体验。