您的 AI 智能体已经能编写代码、处理邮件和管理基础设施。但在项目管理方面,它们却是盲目的 — 无法看到待办列表、创建 issue 或更新项目状态,只能依赖手动复制粘贴。
Linear MCP 解决了这个问题。 它为任何兼容 MCP 的 AI 智能体提供对您 Linear 工作区的完整、结构化访问。
它能做什么
Linear MCP 通过 Model Context Protocol 暴露 Linear 的整个项目管理接口。AI 智能体可以:
核心工作管理
- Issue — 创建(单条或批量)、更新、检索、删除、管理父子层级,以及创建 issue 关联
- 项目 — 创建、更新、删除、检索、随项目一起创建,并与倡议关联
- 评论 — 创建线程回复、更新、删除、解决 / 取消解决线程
- 里程碑 — 完整 CRUD,以及批量创建和检索
工作流与发现
- 团队、用户、工作流状态、标签和周期
- 自由文本检索,带可选筛选器(团队、项目、经办人、状态、优先级、周期)
- 精确 issue 标识符解析(例如
ENG-431),并回退至排名检索
集成与高级接口
- 附件、webhook、组合实体(倡议、客户)
- 智能体会话和智能体活动
- 运行时能力发现和实时诊断
架构
AI Agent (Claude / Codex / OpenClaw / Cline)
-> MCP transport (stdio or HTTP)
-> Linear MCP server
-> Linear GraphQL API
Linear MCP 在处理程序分发之前会在运行时强制执行工具 schema。格式错误的有效载荷会在 MCP 边界处以结构化验证错误失败 — 而不是深藏在 Linear 的 API 内部。
受保护的契约 — 关键 issue 工作流(单条创建、批量创建、检索)使用经过审计的原始 GraphQL 操作而非 SDK mutation,防止 SDK 回归问题影响您的智能体。运行 npm run verify:linear-api-contracts 可在本地审计。
结构化遥测 — 每个工具请求都会发出 stderr 遥测,包含工具名称、传输方式、持续时间和经过脱敏的失败元数据,用于故障排查。
身份认证
API 密钥(最简单):
LINEAR_API_KEY=your_personal_access_token
OAuth(用于共享或远程部署):
- 使用您的
clientId、clientSecret和redirectUri调用linear_auth - 打开返回的授权 URL
- 使用
code和state调用linear_auth_callback
在流式模式下,每个 MCP 会话都会获得自己独立的认证上下文。
快速开始
# Install from npm
npx @kkaminsk/linear-mcp
# Or clone and build
git clone https://github.com/kkaminsk/linear-mcp.git
cd linear-mcp && npm install && npm run build
# Run with API key
LINEAR_API_KEY=your_key npm start
MCP 客户端配置:
{
"mcpServers": {
"linear": {
"command": "node",
"args": ["/path/to/linear-mcp/build/index.js"],
"env": {
"LINEAR_API_KEY": "your_personal_access_token"
}
}
}
}
适用对象
- 开发团队 — AI 智能体可作为其工作流的一部分进行 issue 分拣、创建和更新
- 工程管理者 — 自动化项目状态更新、里程碑跟踪和待办列表整理
- DevOps 与 SRE 团队 — AI 智能体创建事故、关联 issue 并跟踪解决进度
- AI 智能体构建者 — 任何需要结构化访问项目管理的 MCP 客户端
GitHub: github.com/kkaminsk/linear-mcp
npm: @kkaminsk/linear-mcp