Linear MCP Server

什么是 Linear MCP Server？

Linear MCP Server 是由 jerhadf 开发的社区版 linear mcp server，让 Claude 和其他 MCP 客户端通过 Linear API 搜索、创建、更新和评论 Linear issue。该项目现已弃用，作者推荐改用 Linear 官方的远程 MCP 服务器。

该项目是一个采用 MIT 许可证的 Node.js 包，在 npm 上以 linear-mcp-server 发布（最新版本 0.1.0），目前已不再维护。对于新的配置，Linear 在 https://mcp.linear.app/mcp 托管了官方服务器，文档见 linear.app/docs/mcp。本页同时介绍两者：此处收录的原始包，以及如今大多数人应当使用的官方 linear mcp 端点。

如何使用 Linear MCP Server？

推荐：Linear 官方远程 MCP 服务器

Linear 托管的服务器使用 Streamable HTTP，地址为 https://mcp.linear.app/mcp，并通过 OAuth 2.1 登录，因此大多数客户端无需安装任何东西，也无需粘贴 API 密钥。只读端点为 https://mcp.linear.app/mcp/readonly。旧的 https://mcp.linear.app/sse 端点（即已弃用 README 中指向的地址）现在只是遗留的备用方案。

Claude Code：

claude mcp add --transport http linear-server https://mcp.linear.app/mcp

然后在 Claude Code 会话中运行 /mcp 完成认证。

Codex：

codex mcp add linear --url https://mcp.linear.app/mcp

Claude（claude.ai 和 Claude Desktop）：在 Settings > Connectors 中添加 Linear connector。Cursor：在 Cursor 的 MCP tools 页面中安装 Linear。VS Code、Windsurf 以及其他不原生支持远程服务器的客户端可以使用 mcp-remote：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

旧版：jerhadf 的 linear-mcp-server 包

如果仍需要使用原始的本地服务器，你需要 Node.js，以及从 https://linear.app/YOUR-TEAM/settings/api 获取的 Linear API 密钥。

Claude Desktop

在 macOS 上，将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

README 还记录了通过 Smithery 自动安装的方式，也就是本 mcp.so 页面上显示的配置：

npx @smithery/cli install linear-mcp-server --client claude

Linear MCP Server 的主要功能

• 创建和更新 Linear issue，可设置标题、团队、markdown 描述、优先级（0-4）和状态。
• 按文本、团队、状态、负责人、标签和优先级搜索 issue，并可限制结果数量。
• 列出分配给某个用户的 issue，可选择包含已归档的 issue。
• 为 issue 添加 markdown 评论，可选自定义用户名和头像。
• 提供 MCP 资源：单个 issue、团队的 issue、用户被分配的 issue、组织信息以及当前用户。
• 通过 stdio 在本地运行，只需一个 LINEAR_API_KEY 环境变量。
• 已弃用：不会再有修复；Linear 官方远程服务器通过 OAuth 覆盖 issue、项目和评论。

Linear MCP Server 工具

这个已弃用的包提供五个工具，分为两组：

• Issue 管理：linear_create_issue 在某个团队中创建 issue（需要 title 和 teamId），linear_update_issue 按 issue ID 修改标题、描述、优先级或状态。
• 查找与讨论工作：linear_search_issues 按查询词、团队、状态、负责人、标签和优先级筛选 issue；linear_get_user_issues 返回分配给某个用户的 issue（默认是已认证用户）；linear_add_comment 在 issue 下发表评论。

它还提供 linear-issue:///{issueId}、linear-team:///{teamId}/issues 和 linear-viewer: 等资源 URI。Linear 官方 MCP 服务器有自己更丰富的工具集，可查找、创建和更新 issue、项目和评论。

Linear MCP Server 的使用场景

• 整理自己的待办：“Show me all my high-priority issues.”
• 根据对话提交 bug：“Based on what I've told you about this bug already, make a bug report for the authentication system.”
• 查找进行中的工作：“Find all in progress frontend tasks.”
• 汇总动态：“Give me a summary of recent updates on the issues for mobile app development.”
• 查看团队负载：“What's the current workload for the mobile team?”
• 使用官方服务器时，可以把站会记录转为 issue 评论，或把规划文档转为 Linear 项目，正如 Linear 示例提示词中所展示的那样。

Linear MCP Server 与替代方案对比

• Linear 官方 MCP 服务器与本包：托管服务器由 Linear 维护，无需本地安装，使用 OAuth（或 bearer token / API 密钥），提供只读端点，并在 Claude、Cursor、Codex 等客户端中原生可用。jerhadf 的 linear mcp server 是本地运行、仅支持 API 密钥且无人维护的。
• 其他项目管理工具：Jira 可参考 Jira MCP Server 或 Atlassian MCP；Asana 可参考 Asana MCP Server；ClickUp 可参考 ClickUp MCP Server。
• 代码托管：将 Linear 与 GitHub MCP Server 搭配使用，可以关联 issue 和 pull request。

Linear MCP Server 常见问题排查

• 包无法使用或缺少功能：该包已弃用。请按上面的客户端步骤迁移到 https://mcp.linear.app/mcp。
• 连接官方服务器时出现 internal server error：Linear 文档建议运行 rm -rf ~/.mcp-auth 清除已保存的认证信息后重试，必要时升级 Node.js。
• SSE 端点报错：https://mcp.linear.app/sse 是已弃用的备用端点，请改用 Streamable HTTP 端点。
• 在 Windows 的 WSL 下报错：Linear 文档给出的备用方案是通过 wsl 运行 mcp-remote，并使用 /sse 端点和 --transport sse-only。
• 工作区不对：每个 Linear 工作区都需要独立的认证上下文；使用 mcp-remote 时，为每个工作区设置不同的 MCP_REMOTE_CONFIG_DIR。