什么是 Linear MCP 服务器?
Linear MCP 服务器是一个轻量级服务器,充当 AI 应用程序(如 Claude Desktop)和 Linear 问题跟踪 API 之间的桥梁。它遵循模型上下文协议,提供 Linear 功能,如问题创建、更新、评论和搜索,这些功能可被大型语言模型轻松访问。这简化了工作流程,自动化了项目管理,增强了通过 AI 与 Linear 的无缝集成的生产力。
如何配置
- 访问你的 Linear 团队的 API 设置页面以获取 Linear API 密钥。
- 针对 Claude Desktop 的集成,在你的
claude_desktop_config.json
中添加以下配置(位于 MacOS 的~/Library/Application Support/Claude/
):
{
"mcpServers": {
"linear": {
"command": "npx",
"args": [
"-y",
"linear-mcp-server"
],
"env": {
"LINEAR_API_KEY": "你的_linear_api_key_here"
}
}
}
}
- 或者,可以通过 Smithery 自动安装:
npx @smithery/cli install linear-mcp-server --client claude
- 确保通过环境变量安全地提供
LINEAR_API_KEY
,如配置所示。
如何使用
配置并启动服务器后:
- 使用你的 AI 应用程序(例如 Claude Desktop)通过自然语言查询 Linear。应用程序将自动发现通过 MCP 提供的可用 Linear 工具和资源。
- 示例操作包括创建新问题、更新问题状态、按关键字或优先级搜索任务、检索已分配的问题或添加评论。
- 使用 "显示我所有高优先级的问题" 或 "创建一个关于登录失败的错误报告" 的提示将触发相应的 MCP 工具调用。
- 开发者可以直接使用 MCP 端点,如
tools/call
,调用 Linear 功能,或使用tools/list
浏览可用选项。
主要特点
- 通过模型上下文协议实现 AI 应用与 Linear 之间的无缝连接。
- 无需自定义集成编码;所有主要问题操作都作为标准化工具提供。
- 预定义工具用于问题创建、更新、搜索、用户查询和评论。
- 支持安全的本地环境配置,确保 API 密钥安全存放在你的基础设施内。
- 资源端点支持直接检索或聚合 Linear 实体,如问题和团队任务列表。
- 开源(MIT 许可证),支持修改和自托管。
使用案例
- 自动化从自然语言的错误报告或功能请求中创建、分类和跟踪工程工单。
- 在站会上快速显示分配的任务或高优先级问题。
- 使 AI 代理能够直接在 Linear 内监控、总结和更新正在进行的工作进展。
- 使用自然语言快速过滤按团队、负责人、标签或自定义标准的任务搜索。
- 在对话工作流中给 Linear 问题添加评论或澄清。
- 分析不同团队或用户的工作负载和积压分配。
常见问题
问1: 线性 MCP 服务器还在维护吗?
答1: 不,这个项目已经弃用。有关最新的官方线性 MCP 集成,请参考 https://linear.app/changelog/2025-05-01-mcp 或 https://mcp.linear.app/sse。
问2: 我可以将 Linear MCP 服务器与 Claude Desktop 以外的其他 LLM 工具一起使用吗?
答2: 可以,你可以在任何兼容模型上下文协议的主机上使用它,尽管提供的配置示例专门针对 Claude Desktop。
问3: 我需要编写代码才能与 Linear MCP 服务器互动吗?
答3: 不一定。如果你的 AI 应用支持 MCP,你可以通过自然语言与 Linear 互动。如果愿意,开发者可以直接调用工具端点。
问4: 我该将 Linear API 密钥存储在哪里?
答4: 请将 API 密钥存储在环境变量或应用程序的配置文件中,如所示。请勿公开分享或暴露它。
问5: 如果我的 API 密钥过期或被撤销,会发生什么?
答5: MCP 服务器将失去对 Linear 的访问,所有工具调用将失败,直到提供有效的 API 密钥。