💻

Linear

查询并管理 Linear 的 issues、projects 和团队工作流。

分类: 开发
难度: 中等

快速配置

选择适合您环境的设置。

最后验证: 2026-06-13
验证环境: Linear 官方远程 MCP（https://mcp.linear.app/sse），经 mcp-remote 走 OAuth
安装命令: npx -y mcp-remote https://mcp.linear.app/sse

本地配置

JSON
本地配置 json 
{
  "linear": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
  }
}

复制后下一步

先用配置检查器验证 Linear JSON，再回到 OpenClaw 运行验证提示词。

检查配置 提交配置审查

验证提示词

列出当前迭代中分配给我的 issues，并按状态分组。

成功时应看到

首次运行会弹出浏览器 OAuth 授权；之后即可看到按状态分组的待办 issues。

常见陷阱与修复

  • ⚠️ 注意: API token 权限、团队/项目/迭代（cycle）之间的映射关系。
  • 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
  • 🛡️ 如果可用，从只读权限开始，以安全地验证连接。

安全检查

  • 鉴权在浏览器里走 OAuth，配置文件中不存任何 API token。
  • 只授予 Linear 应用你实际需要的最小工作区权限。

常见错误

错误 原因 修复方法
Authentication required 首次 OAuth 授权未完成。 在浏览器完成 Linear 登录授权后重试。
command not found: npx 未安装 Node.js。 安装 Node.js 18+，使 npx 能运行 mcp-remote。
Connection closed / 401 OAuth 会话已过期。 重新运行以刷新 Linear 的 OAuth token。

示例提示词

连接后，尝试这些提示词以测试功能：

  • 列出分配给我、截止本周的 issues，并总结优先级。
  • 找出当前迭代中的 blockers，并给出解决方案建议。
  • 创建一个名为"Investigate build failure"的 issue，并指派给我。

探索相关服务器

Context7

把最新库文档直接带进编码提示词，避免模型使用过期 API。

GitHub（官方）

通过 openclaw 直接读取仓库、问题和打开 PR。

GitLab

读取 GitLab 的项目、Issue 和合并请求。