Linear MCP — Project Management for Claude Code & Cursor

简介

Linear 官方 MCP server 把 Linear API 暴露成 Model Context Protocol 工具 —— 搜 issue、创建/更新/评论、管理 cycle 和 project、关联 GitHub PR。配一次，所有 MCP 宿主（Claude Code / Cursor / Codex CLI / Cline）都能管你的 Linear workspace。适合不想离开 AI 编码工具就处理 / 创建 / 更新 Linear issue 的工程团队。兼容任何 MCP 宿主。装机时间 3 分钟。

MCP 配置

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

第一次用 Linear 工具时浏览器打开做 Linear OAuth 授权。token 本地存。

暴露的工具

常见 prompt

> Show me all P0 issues assigned to me, sorted by created date

> Create a Linear issue: "Auth flow drops state on redirect" in #web team,
  priority urgent, assign to @me, attach the failing test from this file

> Comment on ENG-1234: "Reproduced — root cause is missing CSRF token. PR up tonight."

鉴权和限速

• OAuth token 有跟你 Linear 账号一样的 scope —— 你能读啥就读啥，能写啥就写啥
• 限速：每用户每小时 1000 请求（Linear 标准 API 限制）
• 团队共享用法不要用 OAuth，去 Settings → API 生成限定 scope 的 Linear personal API key

FAQ

Q: Linear MCP 免费吗？ A: 免费 —— MCP server 免费且官方。你只需要 Linear 账号（Linear ≤10 用户有免费档）。MCP 包装 Linear 已有 API，不另外计费。

Q: 支持 Linear 的 webhook 吗？ A: 不支持 —— webhook 是服务器到服务器的。Linear MCP 是客户端驱动的动作（你的 AI agent 读写）。事件驱动工作流另外配 Linear webhook 路由到 Inngest / Trigger.dev。

Q: 我的 agent 只能看到我有权限的 issue 吗？ A: 对 —— OAuth scope 跟你的账号匹配。MCP 不能提权访问你看不到的 issue。要更细粒度控制就在 Linear 设置生成限定 scope 的 API key。