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

图:本站根据 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/mcp | Streamable HTTP | 当前主流客户端(Claude Code、新版 Cursor、Codex、VS Code)首选地址 |
https://mcp.linear.app/sse | HTTP + SSE | 仅用于尚未支持 Streamable HTTP 的旧版本客户端兼容回退 |
| 只读限定配置 | Streamable HTTP | 只允许查询 Issue、Project 与评论,拦截创建或状态修改操作 |
关于这两种远程协议的底层区别,可先看 MCP 的 stdio、SSE 和 Streamable HTTP 有什么区别。不确定客户端版本时,一律优先填 https://mcp.linear.app/mcp。
二、在主流编程工具中接入 mcp.linear.app
1. Claude Code 配置方法
- 在终端运行命令注册远程 HTTP 服务器(加上
--scope user可对本机所有仓库生效):
bash
claude mcp add --transport http linear https://mcp.linear.app/mcp
- 进入
claude会话,输入/mcp查看已注册服务。 - 选中
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)与评论的工具:
- 按编号精准拉取上下文:直接对助手说「读取 Linear 里的
ENG-402号 Issue 详情和全部评论,结合当前仓库分析复现原因」; - 查当前迭代待办:输入「列出 Linear 当前 Cycle 里分配给我、状态为 Todo 或 In Progress 的所有任务,按优先级排序」;
- 拆解子任务与改状态:修完代码提交分支后,可让助手「在
ENG-402下留一条包含改动文件摘要的评论,并把状态更新为 In Review」。
建议团队协作时把建单和改状态工具设为「每次询问确认」,避免模型理解偏差把尚未合入主干的任务提前标成已完成(Done)。

图:本站根据 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,全程无需交出账号密码,支持开具增值税发票;实时价格与售后边界(封号不在质保范围)以对应商品页为准。
相关教程
- Claude Code MCP 配置教程:claude mcp add、配置文件位置与常用 MCP
- Cursor MCP 配置教程:mcp.json 写法、项目与全局位置、OAuth 与连接失败排查
- Codex 怎么配置 MCP:codex mcp add 命令、config.toml 写法与常见问题
- MCP 的 stdio、SSE 和 Streamable HTTP 有什么区别
参考资料
- 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
0 条评论
还没有评论,来抢沙发~