Linear 官方 MCP Server 怎么配:连 mcp.linear.app 查 Issue、建任务、更新状态与授权排错

Linear 官方提供远程 MCP 服务器 https://mcp.linear.app/mcp。本文按官方文档整理在 Claude Code、Cursor 与 Codex 里的 OAuth 配置、只读模式 URL、Issue 读写用法与授权排错。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 免费账号 账号

结论先说

  1. Linear 官方远程 MCP 标准地址是 https://mcp.linear.app/mcp,采用 Streamable HTTP 协议与动态 OAuth 2.1 认证,无需在本地运行 Node 服务或手填个人 API Key。
  2. 支持独立只读入口:如果只想让 AI 查需求、读评论而不允许改单或建单,可将连接地址改为只读路径(如官方提供的 /readonly 变体)或在客户端里关闭写类工具自动放行。
  3. 本配置与「在 Linear 里把 Issue 委派给云端 Agent」是两套机制:远程 MCP 是让你在本地编辑器里主动读写 Linear,而不是在 Linear 界面里 @ 机器人自动提 PR。
  4. 授权权限严格跟随当前登录的 Linear 账号:你看不到的私有团队(Private Team)Issue,AI 通过 MCP 同样无法读取。
  5. 主力模型订阅与账号配套入口:跑通 MCP 工具链与多文件智能体编码依赖稳定的底层大模型配额,国内免境外卡自助开通可见本站 Claude Code 订阅页、ChatGPT Plus 充值页 与 AI 会员充值总览。

Linear 官方远程 MCP 配置步骤与端点选择

图:本站根据 Linear 官方文档:MCP server 整理的示意图

本文根据 Linear 官方文档《MCP server》及 Claude Code、Cursor 官方 MCP 文档整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Linear 或 Anthropic 官方网站。

适用于谁

  • 想在本地 IDE 或终端编码工具里直接查询 Linear Issue、新建缺陷单、改状态或加评论的研发人员;
  • 不想使用第三方非官方脚本管理 API Key,希望直接接入 mcp.linear.app 官方托管服务的团队;
  • 配置 Linear MCP 后遇到 /sse 与 /mcp 混淆、OAuth 跳不过去或找不到团队项目的人。

一、选对端点:/mcp、/sse 与只读模式

在社区旧帖里经常能看到不同的 Linear 地址写法,按 Linear 官方现行说明区分如下:

端点地址传输方式适用情况
https://mcp.linear.app/mcpStreamable HTTP当前主流客户端(Claude Code、新版 Cursor、Codex、VS Code)首选地址
https://mcp.linear.app/sseHTTP + SSE仅用于尚未支持 Streamable HTTP 的旧版本客户端兼容回退
只读限定配置Streamable HTTP只允许查询 Issue、Project 与评论,拦截创建或状态修改操作

关于这两种远程协议的底层区别,可先看 MCP 的 stdio、SSE 和 Streamable HTTP 有什么区别。不确定客户端版本时,一律优先填 https://mcp.linear.app/mcp。

二、在主流编程工具中接入 mcp.linear.app

1. Claude Code 配置方法

  1. 在终端运行命令注册远程 HTTP 服务器(加上 --scope user 可对本机所有仓库生效):
bash
claude mcp add --transport http linear https://mcp.linear.app/mcp
  1. 进入 claude 会话,输入 /mcp 查看已注册服务。
  2. 选中 linear 发起浏览器 OAuth 登录,在 Linear 授权页确认目标工作区并点击允许(Authorize)。详细命令参数见 Claude Code MCP 配置教程。

日常让 Claude Code 一边拉取 Linear 缺陷描述、一边定位代码并跑测试,对上下文额度的消耗比较集中;若需升级订阅档位,可参考本站 Claude Code 充值页。

2. Cursor 与桌面客户端配置方法

打开项目级 .cursor/mcp.json 或全局 ~/.cursor/mcp.json,写入:

json
{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/mcp"
    }
  }
}

保存后打开设置(Settings)> Cursor Settings > 工具与 MCP(Tools & MCP),点击 linear 右侧的登录按钮完成网页授权。若遇到配置文件路径或语法报错,见 Cursor MCP 配置教程。

3. Codex CLI 配置方法

在 ~/.codex/config.toml 中添加:

toml
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

随后在终端执行 codex mcp login linear 完成浏览器认证即可。更多 config.toml 字段说明可查阅 Codex 怎么配置 MCP。

编程订阅与高配额省心方案:在 Cursor、Claude Code 或 Codex 里挂载外部工具做长链路开发时,固定月费订阅通常比纯按量 API 更易控成本。本站支持支付宝、微信支付与 AlipayHK 免密自助兑换 Claude Pro、Claude Max 与 ChatGPT Pro,团队协作亦可定制 ChatGPT Business 团队版。

三、查 Issue、建任务与更新状态的常用做法

连上 Linear 官方 MCP 后,客户端会自动加载管理 Issue、项目(Projects)、周期(Cycles)与评论的工具:

  1. 按编号精准拉取上下文:直接对助手说「读取 Linear 里的 ENG-402 号 Issue 详情和全部评论,结合当前仓库分析复现原因」;
  2. 查当前迭代待办:输入「列出 Linear 当前 Cycle 里分配给我、状态为 Todo 或 In Progress 的所有任务,按优先级排序」;
  3. 拆解子任务与改状态:修完代码提交分支后,可让助手「在 ENG-402 下留一条包含改动文件摘要的评论,并把状态更新为 In Review」。

建议团队协作时把建单和改状态工具设为「每次询问确认」,避免模型理解偏差把尚未合入主干的任务提前标成已完成(Done)。

Linear 官方 MCP 授权与工具调用异常排查

图:本站根据 Linear 官方文档:MCP server 整理的示意图

四、常见授权报错与连接排错

  • 浏览器点同意后客户端仍报 Unauthorized 或 401:常见于曾连接过旧版 /sse 端点导致本地缓存了失效的客户端凭证。先在客户端移除 linear 配置,重新添加 /mcp 地址后再触发一次 /mcp 登录。
  • 提示工作区限制第三方应用(Admin approval required):如果公司 Linear 工作区开启了集成审批开关,普通成员授权后会进入待审核队列,需要工作区管理员在 Linear 设置(Settings)> 安全或已授权应用中放行。
  • 非交互式环境(如 CI 脚本)无法弹窗登录:远程 OAuth 面向本地交互客户端;若在无浏览器的流水线中运行,可按 Linear 文档改在请求头传入个人 API Key 或 OAuth Access Token(Authorization: Bearer <TOKEN>)。

常见问题

问:配了 mcp.linear.app 和 GitHub Issue MCP 会冲突吗?

答:不会冲突,但同时挂载过多 MCP 会占用模型初始上下文。若团队用 Linear 管需求、用 GitHub 管 PR,可按需启停;GitHub 侧做法见 Claude Code 管理 GitHub issue。

问:一个浏览器登了多个 Linear 工作区怎么切换?

答:OAuth 授权页顶部可以选择要绑定的具体 Linear 工作区。如果想换到另一个工作区,先在客户端断开重连并在授权页重新勾选对应组织。

问:怎么彻底断开并收回 AI 工具对 Linear 的权限?

答:打开 Linear 应用的设置(Settings)> 账号(Account)> 安全与访问(Security & access),在已授权应用列表里找到对应的 MCP 客户端并点击撤销(Revoke)。

问:配置好开发环境后,国内没有外币卡怎么开通 Claude 或 ChatGPT 编程订阅?

答:可在 本站充值中心 自助选购卡密开通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程无需交出账号密码,支持开具增值税发票;实时价格与售后边界(封号不在质保范围)以对应商品页为准。

相关教程

参考资料

  • Linear 官方文档:MCP server — https://linear.app/docs/mcp
  • Claude Code 官方文档:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
  • Cursor 官方文档:Model Context Protocol (MCP) — https://cursor.com/docs/context/mcp

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~