← 返回目录

Linear MCP Server

社区

通过 MCP 服务器与 Linear API 交互，管理问题、项目和团队。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 52 / 55
Stars: ★ 135 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
最近提交: 14 个月前 ⚠
工具数: 11

35FMRS · D

该服务器提供了基本的 Linear 集成，支持问题、项目和团队管理。它注重富文本描述处理，并具有批量操作能力。但 OAuth 尚未实现，部分功能仍在开发中。适合使用 Cline 并需要直接 API 访问的用户。

最强项 · 文档质量 8/20 最弱项 · 安全与权限 5/20

可靠性

8/20

安全与权限

5/20

维护活跃度

7/20

文档质量

8/20

安装易用性

7/20

查看各项评分依据

可靠性 8/20: 提供评分依据：源代码文件和配置表明服务器有结构化的构建（npm run build）和测试（npm test）流程。然而，缺乏可执行的证据，如CI工作流和已提交的全面测试，且README中提到的测试在仓库中未被发现。如果涉及OAuth流程，当前未实现，导致文档与实现之间存在差异。因此，根据仅静态审查，得分限制在12分以下。
安全与权限 5/20: 该分数为5分，因为存在API密钥处理、环境变量配置，以及删除操作似乎需要用户确认。但未披露数据流（工具调用会传输到外部API），且删除操作没有明确说明需要确认或撤销能力。安装示例在README中不含实际密钥，但.env示例可能未提交。没有源码可验证安全实施，因此根据证据不足扣分。
维护活跃度 7/20: 仓库有近期提交和活跃的问题跟踪，但未提供许可证，也没有版本标签或明确的维护者。README中提到了开发中的功能，表明正在进行维护，但缺乏安全响应渠道和发布流程，因此得分低于满分。
文档质量 8/20: README提供了详细的安装、认证和工具列表，并说明了开发中的功能和测试。然而，缺少工具参数的详细说明、限制、故障排除和成本考虑。文档在某些方面可能过时，如OAuth未实现。因此，因缺少分层文档和审查性证据而扣分。
安装易用性 7/20: 安装步骤清晰：克隆、npm install、设置.env、构建和启动。提供了Cline客户端集成示例。但配置手工操作多，且需要构建步骤，没有提供如Docker等开箱即用的解决方案。由于未执行验证，根据静态指导，得分上限为15分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

使用 Cline 且需要访问 Linear 的开发者
希望将 Linear 问题管理与 AI 编程助手集成的团队

不适合谁

需要 OAuth 认证的用户（尚未实现）
需要高级搜索过滤或分页支持的用户（开发中）
非 Cline 用户（README 主要围绕 Cline 集成）

所需权限

需要有效的 Linear API 密钥（个人访问令牌）
API 密钥权限与创建密钥的用户相同，可能具有创建、更新和删除问题的权限

风险与副作用

API 密钥泄露可能导致未授权访问
批量操作可能意外删除或修改大量问题
服务器为私有项目，可能存在未解决的 bug 或安全问题

安装接入

准备工作

运行环境：Node.js

LINEAR_API_KEY 必填密钥 Linear 个人 API Key，在 Linear 设置的 Security & access 下的 Personal API keys 中创建。

LINEAR_CLIENT_SECRET 可选密钥 OAuth 应用的 Client Secret，与 LINEAR_CLIENT_ID 一同获取（OAuth 流程未实现）。

其他可选配置项（2 个）

LINEAR_CLIENT_ID 可选 OAuth 应用的 Client ID，在 https://linear.app/settings/api/applications 创建应用后获取（OAuth 流程未实现）。

LINEAR_REDIRECT_URI 可选 OAuth 回调地址，例如 http://localhost:3000/callback（OAuth 流程未实现）。

克隆仓库
运行 npm install
复制 .env.example 为 .env
在 Linear 设置中创建个人 API 密钥，并添加到 .env 文件中的 LINEAR_API_KEY
运行 npm run build 和 npm start
在 Cline 的 MCP 设置文件中添加服务器配置（见 install_config）

claude_desktop_config.json

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_personal_access_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "linear": {
      "command": "node",
      "args": [
        "/path/to/linear-mcp/build/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "your_personal_access_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add linear -e LINEAR_API_KEY=your_personal_access_token -- node /path/to/linear-mcp/build/index.js

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Cline 的 MCP 设置中添加该服务器后重启，检查工具列表中是否出现 create_issue、search_issues 等 Linear 工具；也可以让客户端调用 get_team 来验证 API Key 是否生效。

常见排障

检查 API 密钥是否有效且未过期
确保 `.env` 文件正确配置且包含 `LINEAR_API_KEY`
验证构建是否成功：运行 `npm run build`
检查 Cline 配置中的路径是否正确指向 `build/index.js`
查看服务器日志以获取错误信息

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在 Linear 上创建一个标题为「修复登录页 Bug」的 issue，并关联到我的前端项目
搜索 Linear 中所有优先级高的未完成 issue
给我看一下「移动端」项目的详细信息，包括描述和关联的 issue
把这个 issue 标记为完成并添加一条评论说明原因

工具能力 11

create_issue 写入

创建问题，支持标题、描述、团队、项目等完整字段。

update_issue 写入

更新现有问题（优先级、描述等）。

delete_issue 破坏性

删除问题（支持单个或批量删除）。

search_issues 只读

搜索问题并支持过滤。

create_comment 写入

创建评论或线程评论。

get_project 只读

获取项目信息，包含富文本描述。

search_projects 只读

搜索项目，包含富文本描述。

create_project 写入

创建项目并关联问题。

展开其余 3 个工具

get_team 只读

获取团队信息（包含状态和工作流详情）。

bulk_create_issues 写入

批量创建问题。

bulk_delete_issues 破坏性

批量删除问题。

使用场景

在 AI 助手（如 Cline）中管理和查阅 Linear 问题

自动化创建、更新和删除问题

获取项目富文本描述

批量操作问题

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

这是一个为 Cline 设计的私有 MCP 服务器，用于访问 Linear 的 API。它提供了一系列工具来管理 Linear 的问题（issues）、项目和团队。支持 API Key 认证（推荐），OAuth 流程尚未实现。服务器实现了对 Linear 富文本描述字段（documentContent）的支持，确保项目描述完整显示。