线性 MCP 服务器
该服务器通过 MCP 提供与 Linear 问题跟踪系统的集成，允许 LLM 与 Linear 问题进行交互。
安装
自动安装
要通过Smithery自动为 Claude Desktop 安装 Linear MCP 服务器：
手动安装
创建或获取 Linear 个人 API 密钥： https://linear.app/settings/account/security
将服务器配置添加到 Claude Desktop：
MacOS：
~/Library/Application Support/Claude/claude_desktop_config.json
Related MCP server: Linear MCP Server
成分
工具
用户相关工具
linear_get_viewer：获取有关经过身份验证的用户的信息无需输入
返回用户个人资料信息，包括 ID、姓名、电子邮件和活动状态
linear_get_user_issues：获取分配给用户的问题可选输入：
userId(字符串)：用户 ID（对于已验证的用户可省略）includeArchived（布尔值）：包括存档问题limit（数字，默认值：50）：最大结果数
linear_get_user_teams：获取与用户关联的团队可选输入：
userId(字符串)：获取团队的用户 ID（对于经过身份验证的用户则省略）includeArchived（布尔值）：包括存档的团队limit（数字，默认值：50）：返回的最大团队数量
返回用户所属团队的列表
linear_get_user_projects：获取与用户关联的项目可选输入：
userId（字符串）：获取项目的用户 ID（对于经过身份验证的用户则省略）includeArchived（布尔值）：包括存档项目limit（数字，默认值：50）：返回的最大项目数status（字符串）：按项目状态过滤（例如“已完成”、“进行中”）
返回用户作为领导或成员的项目列表
团队相关工具
linear_get_teams：获取组织中的团队可选输入：
includeArchived（布尔值）：包括存档的团队limit（数字，默认值：50）：返回的最大团队数量
linear_get_team：获取特定团队的详细信息必需输入：
teamId（字符串）：获取详细信息的团队 ID
返回团队信息，包括名称、密钥、成员和设置
linear_get_team_issues：获取特定团队的问题必需输入：
teamId（字符串）：获取问题的团队 ID
可选输入：
includeArchived（布尔值）：包括存档问题limit（数字，默认值：50）：返回的最大问题数status（字符串）：按问题状态过滤priority（数字）：按优先级过滤assigneeId（字符串）：按受让人过滤
项目相关工具
linear_get_projects：获取组织中的项目可选输入：
teamId（字符串）：按团队过滤项目includeArchived（布尔值）：包括存档项目limit（数字，默认值：50）：返回的最大项目数status（字符串）：按项目状态过滤
linear_get_project：获取有关特定项目的详细信息必需输入：
projectId（字符串）：获取详细信息的项目 ID
返回详细的项目信息，包括进度、状态、团队、负责人和日期
linear_get_project_issues：获取特定项目的问题
必需输入：
projectId（字符串）：获取问题的项目 ID
可选输入：
includeArchived（布尔值）：包括存档问题limit（数字，默认值：50）：返回的最大问题数status（字符串）：按问题状态过滤priority（数字）：按优先级过滤
问题相关工具
linear_create_issue：创建一个新的线性问题
必需输入：
title（字符串）：问题标题teamId（字符串）：创建问题的团队 ID
可选输入：
description（字符串）：问题描述（支持 markdown）priority（数字，0-4）：优先级（1=紧急，4=低）status（字符串）：初始状态名称
linear_update_issue：更新现有问题
必需输入：
id（字符串）：要更新的问题 ID
可选输入：
title（字符串）：新标题description（字符串）：新描述priority（数字，0-4）：新的优先级status（字符串）：新状态名称
linear_search_issues：使用灵活过滤来搜索问题
可选输入：
query（字符串）：在标题/描述中搜索的文本teamId（字符串）：按团队过滤status（字符串）：按状态过滤assigneeId（字符串）：按受让人过滤labels（string[]）：按标签过滤priority（数字）：按优先级过滤limit（数字，默认值：10）：最大结果数
linear_add_comment：向问题添加评论
必需输入：
issueId（字符串）：需要评论的问题 IDbody（字符串）：评论文本（支持 markdown）
可选输入：
createAsUser（字符串）：自定义用户名displayIconUrl(string): 自定义头像URL
标签管理工具
linear_get_labels：获取组织中的标签
可选输入：
teamId（字符串）：按团队过滤标签includeArchived（布尔值）：包含存档标签limit（数字，默认值：50）：返回的最大标签数
linear_create_label：创建新标签
必需输入：
name（字符串）：标签名称teamId（字符串）：要创建标签的团队 ID
可选输入：
color（字符串）：颜色十六进制代码（例如“#FF0000”）description（字符串）：标签描述
linear_update_label：更新现有标签
必需输入：
id（字符串）：要更新的标签ID
可选输入：
name（字符串）：新标签名称color（字符串）：新的颜色十六进制代码description（字符串）：新描述
附件管理工具
linear_add_attachment：向问题添加附件
必需输入：
issueId（字符串）：要添加附件的问题 IDurl（字符串）：附件的 URLtitle（字符串）：附件的标题
可选输入：
subtitle（字符串）：附件的字幕icon（字符串）：附件的图标 URL
linear_get_attachments：获取问题的附件
必需输入：
issueId(string): 获取附件的问题 ID
问题关系工具
linear_link_issues：创建问题之间的关系
必需输入：
issueId（字符串）：源问题 IDrelatedIssueId（字符串）：目标问题IDtype（字符串）：关系类型（例如，“blocks”、“related”、“duplicate”）
linear_get_issue_relations：获取问题的关系
必需输入：
issueId（字符串）：获取关系的问题 ID
可选输入：
type（字符串）：按关系类型过滤
里程碑管理工具
linear_get_milestones：获取项目的里程碑
可选输入：
projectId（字符串）：按项目过滤里程碑includeArchived（布尔值）：包括已存档的里程碑limit（数字，默认值：50）：返回的最大里程碑数量
linear_create_milestone：创建一个新的里程碑
必需输入：
name（字符串）：里程碑名称projectId（字符串）：创建里程碑的项目 IDtargetDate（字符串）：目标完成日期（ISO 格式）
可选输入：
description（字符串）：里程碑描述sortOrder（数字）：里程碑列表中的位置
linear_update_milestone：更新现有里程碑
必需输入：
id（字符串）：要更新的里程碑 ID
可选输入：
name（字符串）：新里程碑名称targetDate（字符串）：新的目标日期description（字符串）：新描述status（字符串）：新状态（例如，“计划”、“进行中”、“已完成”）
资源
linear-issue:///{issueId}：查看单个问题的详细信息返回问题信息，包括标题、描述、评论和元数据
linear-team:///{teamId}：查看团队详细信息返回团队信息，包括名称、密钥、描述和成员
linear-team:///{teamId}/issues：查看团队问题返回特定团队的所有问题及其状态和优先级信息
linear-project:///{projectId}：查看项目详情返回项目信息，包括名称、描述、进度、状态、负责人、团队和时间表
linear-project:///{projectId}/issues：查看项目问题返回特定项目的所有问题及其状态和分配信息
linear-project:///{projectId}/milestones：查看项目里程碑返回特定项目的所有里程碑以及进度和状态信息
linear-user:///{userId}/assigned：查看用户分配的问题返回分配给特定用户的问题以及项目和团队上下文
linear-organization:：查看组织信息返回组织级信息，包括名称和设置
linear-viewer:：查看当前用户上下文返回有关已验证用户的信息
linear-viewer:///teams：查看经过身份验证的用户的团队返回当前用户所属的所有团队
linear-viewer:///projects：查看经过身份验证的用户的项目返回当前用户参与的所有项目（作为领导或成员）
linear-viewer:///assigned：查看分配给经过身份验证的用户的问题返回分配给当前用户的所有问题以及项目和团队上下文
linear-label:///{labelId}：查看标签详情返回标签信息，包括名称、颜色和相关问题
使用示例
以下是您可以使用 Claude Desktop 与 Linear 进行交互的示例提示：
问题管理
“为身份验证系统创建新的错误报告”→使用
linear_create_issue创建具有适当详细信息的新问题“将工单 FRONT-123 的优先级更新为紧急”→使用
linear_update_issue修改现有问题的优先级“向登录页面错误添加一条评论，解释根本原因”→使用
linear_add_comment向现有问题添加信息
查找和过滤问题
“显示我所有高优先级问题”→使用
linear_get_user_issues或linear-viewer:///assigned查找分配给您的高优先级问题“查找所有正在进行的前端任务”→使用
linear_search_issues来定位状态为“正在进行”的前端相关问题“目前分配给 Sarah 的问题有哪些？” → 使用
linear_get_user_issues和 Sarah 的 ID 查看她的分配情况
团队和项目管理
“我是哪些团队的成员？” → 使用
linear_get_user_teams或linear-viewer:///teams列出经过身份验证的用户所属的所有团队“显示我正在领导或参与的项目”→使用
linear_get_user_projects或linear-viewer:///projects获取与当前用户相关的所有项目“移动应用项目目前进展如何？” → 使用
linear_get_project获取项目详细信息，包括进度“列出前端团队的所有活跃项目”→结合
linear_get_team查找团队 ID，并使用linear_get_projects与团队过滤器查找活跃项目
状态和工作量分析
“请提供计费系统问题的最新更新摘要”→使用
linear_search_issues识别相关问题，然后使用linear-issue:///{issueId}获取问题详细信息“移动团队目前的工作量是多少？” → 使用
linear-team:///{teamId}/issues或linear_get_team_issues来分析整个团队的问题分布情况“显示我在组织中的角色和职责”→使用
linear_get_viewer和linear-viewer:///teams来分析团队成员和角色
标签和分类
“为高优先级安全问题创建‘安全’标签”→使用
linear_create_label创建具有适当设置的新标签“前端团队有哪些可用的标签？” → 使用
linear_get_labels和前端团队 ID 查看可用的分类“将‘需要文档’标签应用于所有 API 问题”→使用
linear_search_issues查找与 API 相关的问题，然后使用linear_update_issue更新每个问题
里程碑管理
“为 Beta 版本创建里程碑”→使用
linear_create_milestone设置项目里程碑和目标日期“移动应用项目中即将实现哪些里程碑？” → 使用
linear_get_milestones和项目 ID 查看计划交付点“将 API v2 里程碑的状态更新为已完成”→使用
linear_update_milestone更改里程碑状态
问题关系
“将问题 FRONT-123 标记为阻塞 API-456”→使用
linear_link_issues在问题之间创建阻塞关系“这个错误阻止了哪些问题？” → 使用
linear_get_issue_relations查找依赖项“显示与身份验证系统相关的所有问题”→使用带有适当过滤器的
linear_search_issues，然后使用linear_get_issue_relations探索关系
发展
安装依赖项：
在
.env中配置 Linear API 密钥：
构建服务器：
对于使用自动重建的开发：
执照
此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。