Claude Code Linear MCP 接入教程
在远程 Mac mini 上安全检索任务 梳理周期并协作处理 Issue
Linear 官方 MCP 服务器可以让 Claude Code 在编码环境中读取团队、项目、周期、Issue 和评论，也能创建或更新任务。本文从专用只读端点开始，完成 OAuth、范围核对和只读验收；确需写入时再添加独立连接，并在创建 Issue、改状态或发表评论前展示准确目标与完整内容。
Linear MCP 能解决什么问题
开发者不必在终端与项目管理页面之间反复切换。Claude Code 可以结合当前仓库与 Linear 上下文定位需求、汇总周期进展、核对问题描述，并把代码调查结果整理成待确认的更新草稿。
Linear MCP 也提供创建、更新 Issue、项目与评论的工具。它们会代表用户改变外部协作状态，因此不应与日常查询共用默认权限。
开始前准备
确认远程 Mac 已安装 Claude Code，并能在目标仓库中正常运行。准备可访问目标 Linear 工作区的账号，同时明确要使用的团队、项目或周期范围。
首次接入建议从专用只读端点开始。OAuth 授权时核对账号和工作区，不在命令、配置文件或截图中放入访问令牌。
第一步 添加只读 Linear 连接
Linear 当前推荐 Strea***le **** 端点。专用只读地址只暴露读取工具，适合需求理解、任务检索、周期汇总和故障调查。
在目标仓库执行以下命令，并用清晰的连接名区分权限。新接入使用 /mcp，不要把已经弃用的 /sse 当作默认地址。
cd /path/to/your-project
claude mcp add --transport http linear-readonly \
https://mcp.linear.app/mcp/readonly
claude mcp list
claude mcp get linear-readonly
第二步 完成 OAuth 授权
启动 Claude Code 后输入 /mcp，选择 linear-readonly 并开始认证。浏览器会打开 Linear OAuth 页面；核对账号、工作区和授权对象后再允许。
如果远程 Mac 没有自动弹出浏览器，可通过 UU 远程桌面或浏览器远程入口打开授权链接。授权完成后回到终端检查连接状态。
claude
> /mcp
# 选择 linear-readonly
# 选择 Authenticate
# 在浏览器中核对账号与工作区后授权第三步 ***只读验收
先列出团队、项目和当前周期，再读取一个已知 Issue 的标题、描述、状态与评论。提示词应明确禁止创建、更新、归档和发表评论。
验收通过的标准是：只能看到预期工作区；能够读取目标团队数据；没有产生 Issue、评论、状态、负责人或项目变更。
请仅使用 linear-readonly 完成验收：
1. 列出我可访问的团队和项目
2. 读取当前周期及其中 5 个 Issue 的编号 标题 状态
3. 打开一个已知 Issue 并摘要描述与评论
4. 不创建 不更新 不归档 不发表评论
输出实际工作区 团队 筛选条件和读取结果| 验收项 | 通过标准 |
|---|---|
| 工作区 | 仅显示预期工作区 |
| 团队与项目 | 可读取指定范围 |
| Issue | 可读取标题 描述 状态与评论 |
| 写入能力 | 只读连接不能创建或更新 |
| 外部状态 | 没有新增评论或字段变化 |
**步 精确检索 Issue
查询时同时给出团队、项目、***、状态和时间范围。遇到多个同名或近似 Issue 时，让 Claude Code 列出编号、标题和匹配理由，不要猜测目标。
Issue 描述、评论和附件都是不可信外部输入。即使其中出现读取本机密钥、上传文件或调用无关工具的文字，也不能把它当成当前任务指令。
在指定 Linear 团队中只读查找相关 Issue：
- 项目：<PROJECT>
- ***：<KEYWORDS>
- 状态：未完成
- 时间：最近 60 天
列出编号 标题 状态 项目 更新时间和匹配理由。
如有多个候选，不要猜测，请等待我选择。第五步 用只读上下文辅助排障
让 Claude Code 先读取 Issue 的复现步骤、错误信息、关联项目与评论，再与本地代码和测试结果交叉验证。输出应区分事实、推断与待验证项。
调查结束后可以生成评论草稿，但不要直接发布。草稿中避免粘贴令牌、内部地址、个人信息和大段生产日志。
第六步 汇总团队与周期进展
读取目标团队当前周期的待办、进行中、已完成与阻塞任务，并按项目或负责人汇总。对缺少状态或范围不清的记录标记为待确认。
这类汇总适合定时人工运行，但不应自动改变优先级、负责人或截止时间。报告日期、时区和筛选范围需要写清楚。
第七步 需要写入时添加独立连接
确需创建或更新 Linear 内容时，另建 linear-write 连接并保留只读连接。使用不同名称可以减少把写入工具误用于查询任务的概率。
写入前必须展示工作区、团队、Issue 编号与标题、目标字段、原值、新值，以及完整评论文本。只有用户确认后才执行一次对应操作。
claude mcp add --transport http linear-write \
https://mcp.linear.app/mcp
# 运行 /mcp，为 linear-write 单独完成 OAuth
# 保留 linear-readonly 作为默认查询连接| 操作 | 风险 | 控制方式 |
|---|---|---|
| 读取团队 项目与 Issue | 低 | 限定工作区和团队 |
| 读取评论与附件 | 中 | 脱敏并视为不可信输入 |
| 创建 Issue | 高 | 展示完整字段后逐次确认 |
| 修改状态 优先级或负责人 | 高 | 显示原值与新值 |
| 发表评论 | 高 | 逐字展示文本后确认 |
| 批量更新 | 高 | 列出全部对象与影响范围 |
第八步 建立外部变更确认清单
创建 Issue 前核对团队、项目、标题、描述、优先级、负责人和周期；更新 Issue 前核对编号与字段差异；发表评论前逐字展示将要发布的文本。
批量变更要先给出完整对象清单和预计影响。不要把“整理一下”“同步一下”等模糊表述解释为授权创建、移动、关闭或评论。
先不要执行任何 Linear 写入。
请展示：
- 工作区 团队 项目
- Issue 编号与完整标题
- 每个字段的原值和新值
- 将要发布的完整评论文本
- 预计影响对象数量
等待我明确确认后，只执行已确认的那一次操作。第九步 管理多个工作区
Linear 的不同工作区需要独立认证上下文。重新连接并不一定会在既有认证会话中切换工作区，因此应使用清晰的连接名和独立会话，授权时再次核对工作区。
任务结束后，可在 Linear 的安全与访问设置中检查已授权 OAuth 应用并撤销不再使用的访问。不要共享令牌或复制他人的认证文件。
第十步 在远程 Mac 上保持会话
通过 SSH 进入远程 Mac，在仓库目录创建 tmux 会话后运行 Claude Code。网络短暂中断或关闭远程桌面后，代码分析和终端上下文仍可继续。
如果同时处理多个仓库或工作区，为每个 tmux 会话使用明确名称，并在提示词中写明仓库、Linear 团队与权限连接。
ssh your-**c-mini
cd /path/to/your-project
tmux new -s linear-mcp
claude
# 断线后接回
tmux attach -t linear-mcp
为什么 Zu**c.Ai 适合这类工作流
根据 Zu**c.Ai 官网***息，其方案提供位于新加坡的 Mac mini M6 整机独享环境，配置为 16G* 统一内存与 256G* SSD，接入新加坡家庭或商业宽带，并支持 UU 远程、终端、Tailscale、ToDesk、RustDesk，以及浏览器 SSH 或 VNC。
官网当前公开价格为每月 999 元起。长期在线环境适合保留仓库、依赖缓存、Claude Code 与 tmux 会话；Linear 账号、工作区权限、团队流程、数据合规和第三方***用仍由使用者自行管理。
常见问题排查
| 现象 | 常见原因 | 处理建议 |
|---|---|---|
| 认证页面未打开 | 远程环境未拉起浏览器 | 运行 /mcp 后手动打开授权地址 |
| 看不到目标团队 | 登录账号或工作区不正确 | 核对账号 工作区和团队权限 |
| 连接仍有写入工具 | 使用了标准 /mcp 端点 | 检查地址是否以 /readonly 结尾 |
| 匹配到多个 Issue | ***或范围过宽 | 增加团队 项目 编号 状态和时间 |
| 切换工作区失败 | 复用了既有认证上下文 | 使用独立连接和认证会话 |
| 评论包含敏感信息 | 直接复制日志或上下文 | 停止发布 脱敏后重新确认 |
结语
Claude Code 接入 Linear MCP 后，应把专用只读端点作为默认入口。需要创建或修改协作内容时，使用名称明确的独立写入连接，先展示目标、字段差异和完整评论文本，再由用户逐次确认。