linear集成由webhooks、api密钥、导入cli和mcp适配器组成：①用pnpm import从jira/github迁移数据；②通过团队设置或curl配置webhook实现实时推送；③以mcp-linear为桥梁接入ai代理执行自然语言指令。
你需要把 Linear 项目数据从其他平台迁移进来，或让 Linear 自动响应外部事件（比如 GitHub PR 提交、Slack 消息、AI 代理指令），这时必须用到 Linear 的集成工具——它不是单一功能，而是由 Webhooks、API 密钥、导入 CLI 和 MCP 适配器组成的可组合能力集。
从 Jira/Trello/GitHub 迁移旧数据
Linear 提供了开箱即用的命令行导入工具，位于本地克隆仓库的 packages/import/ 目录下。你无需启动整个 Linear 应用，只需运行对应子命令。
进入 Linear 项目根目录后执行：
① 确保已安装 pnpm 并完成依赖构建：pnpm install && pnpm build
② 导入 Jira CSV：运行 pnpm import --file ./jira-export.csv --type jira，注意 CSV 文件必须包含 title、description、priority 列，缺失会导致部分 issue 创建失败。
③ 导入 GitHub Issues：执行 pnpm import --repo owner/repo --type github，该命令会自动读取 GitHub API token（需提前配置在环境变量 GITHUB_TOKEN 中），【未设置 token 将静默跳过所有 issue】。
导入完成后，终端会打印成功创建的 issue 数量和失败项摘要，失败日志默认写入 ./import-errors.log。
配置 Webhook 实现实时事件推送
当你需要 Linear 在 issue 创建、状态变更或评论发布时主动通知你的服务（如 Open SWE、自建 webhook 接收器），Webhook 是唯一可靠方式。
方法一：在 Linear 团队设置中手动添加
登录 Linear → 左下角点击团队名称 → Settings → Webhooks → New webhook
填写目标 URL（例如 https://your-app.com/api/webhooks/linear），Linear 会立即发送验证请求，你必须在 5 秒内返回 200 OK 及响应体 {"status":"ok"}，否则创建失败。
方法二：用 curl 批量注册（适合 CI/CD 自动化）
执行：curl -X POST https://api.linear.app/v1/webhooks -H "Authorization: Bearer <your_api_key>" -H "Content-Type: application/json" -d '{"url":"https://your-app.com/api/webhooks/linear","events":["issue.created","issue.updated"]}'</your_api_key>
注意：API key 必须拥有 【团队管理员权限】，普通成员 token 无法创建 webhook。
通过 MCP 协议接入 AI 代理
如果你正在构建 AI 自动化工作流（例如用 Claude Desktop 直接操作 Linear），mcp-linear 是目前最轻量、协议最规范的桥梁。
第一步：克隆并启动 mcp-linear 服务器
git clone https://gitcode.com/tacticlaunch/mcp-linear && cd mcp-linear && pnpm install && pnpm start
第二步：配置 Linear API key
在项目根目录创建 .env 文件，写入 LINEAR_API_KEY=your_actual_key_here，该 key 需从 Linear Settings → API → Personal API Keys 创建，命名建议含 “mcp” 便于识别。
第三步：在 AI 客户端中启用 MCP 连接
以 Cursor 为例：Settings → MCP → Add Server → Protocol 选 stdio → Command 填 pnpm start → Working Directory 选 mcp-linear 项目路径 → Save
这一步完成后，AI 就能自然理解“把‘登录页样式不一致’这个 bug 分配给前端组”这类指令，并自动调用 Linear API 执行，无需你写一行 HTTP 请求代码。
