/ 目录 / 演练场 / Linear MCP (tacticlaunch)
● 社区 tacticlaunch 🔑 需要你的密钥

Linear MCP (tacticlaunch)

作者 tacticlaunch · tacticlaunch/mcp-linear

在终端里驱动 Linear——创建 issue、移动工单、发布更新、跑报告,完全不需要打开 linear.app。

tacticlaunch 的 Linear MCP 将 Linear GraphQL API 封装成 MCP tool。可以创建和更新 issue、变更状态、关联 PR、查询团队和项目、发表评论。使用 PAT 认证,单条 npx 命令启动。适合习惯用自然语言思考、而不是鼠标点击的工程师。

为什么要用

核心特性

实时演示

实际使用效果

linear-mcp-tacticlaunch.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "linear-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "linear-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "linear-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "linear-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "linear-mcp-tacticlaunch",
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "linear-mcp-tacticlaunch": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@tacticlaunch/mcp-linear"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add linear-mcp-tacticlaunch -- npx -y @tacticlaunch/mcp-linear

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Linear MCP (tacticlaunch)

完成一个功能,全程不打开 Linear 一次

👤 讨厌频繁切换上下文的开发者 ⏱ ~10 min beginner

何时使用: 你正在专注写代码,不想因为更新工单而打断节奏。

前置条件
  • Linear PAT — linear.app → Settings → API → Personal API keys
步骤
  1. 认领任务
    Use Linear MCP. Show me my open issues in 'In Progress'. Pick the highest-priority one and mark it 'In Review' — I'm done.✓ 已复制
    → issue 已列出,状态已更新
  2. 添加评论
    Add a comment: 'PR #1234 ready for review. Tests pass, perf benchmarks linked.' Link the PR.✓ 已复制
    → 评论已发布,含 PR 链接
  3. 规划下一步
    What's next in my queue? Group by project.✓ 已复制
    → 按项目分组的 issue 列表

结果: 保持良好的项目管理习惯,全程不离开终端。

注意事项
  • 状态名不匹配(如 'In Review' vs 'Review') — 先让 Claude 列出该团队的工作流状态
搭配使用: github

从 Linear 活动自动生成周报

👤 需要撰写每周更新的个人贡献者 ⏱ ~5 min beginner

何时使用: 周五下午——你完全记不清这周都做了什么。

步骤
  1. 拉取数据
    Pull all issues I closed or commented on this week. Group by project.✓ 已复制
    → 按项目分组的活动日志
  2. 起草
    Write a 5-bullet update — Done / In Progress / Blocked. Keep it concise.✓ 已复制
    → 精简的 5 条要点总结

结果: 30 秒生成周报,而不是花 30 分钟回忆。

注意事项
  • 遗漏了只在 PR 里体现的工作 — 结合 github MCP 捕获 PR 活动
搭配使用: github

将一批 bug 报告分诊导入 Linear

👤 on-call / 分诊值班人员 ⏱ ~30 min intermediate

何时使用: 客户支持发来了 30 个 bug,需要打标签、定优先级、分配负责人。

步骤
  1. 批量导入
    Read /tmp/bugs.md. Each bullet is a bug. Create a Linear issue per bullet with the right team and project.✓ 已复制
    → 创建了 N 个 issue,返回对应 ID
  2. 设定优先级
    Read each issue's description and set priority (urgent/high/medium/low) based on user impact.✓ 已复制
    → 优先级已设置

结果: 收件箱清零;Linear 中已有分诊好的工作。

注意事项
  • 创建了重复 issue — 创建前先搜索标题相似的 issue
搭配使用: filesystem

组合

与其他 MCP 搭配,撬动十倍杠杆

linear-mcp-tacticlaunch + github

自动将 PR 与 Linear issue 关联;合并时关闭 issue

When PR #1234 merges, find the linked LIN-456 and mark it Done.✓ 已复制
linear-mcp-tacticlaunch + filesystem

从 Markdown bug 文件批量导入

Read /tmp/bugs.md and create one Linear issue per bullet.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
list_issues team?, assignee?, status?, project?, limit? 查找待处理的工作 1 GraphQL call
create_issue title, description?, team, project?, assignee?, priority? 记录新 bug 或新任务 1 mutation
update_issue id, status?, assignee?, priority?, title?, description? 推动工单在工作流中流转 1 mutation
add_comment issue_id, body 状态更新、关联 PR 链接 1 mutation
list_projects team? 项目级报告 1 query
list_teams (none) 跨团队查询 1 query

成本与限制

运行它的成本

API 配额
受 Linear 套餐限制——Free 版 250 成员,Plus 及以上提升速率限制
每次调用 Token 数
200-2000
费用
免费(MCP 本身)
提示
尽量过滤条件;一次大 list_issues 比几百次单独 get 便宜得多

安全

权限、密钥、影响范围

最小权限: Personal API token — workspace member scope
凭据存储: LINEAR_API_TOKEN 环境变量
数据出站: 仅到 api.linear.app
切勿授予: Workspace admin tokens to agents

故障排查

常见错误与修复

401 Unauthorized

token 缺失或已撤销;在 linear.app/settings/api 重新生成

验证: curl -H 'Authorization: <token>' https://api.linear.app/graphql
Status not found

工作流状态是按团队设置的;先列出该团队的状态

Rate limited (429)

降速重试;尽量批量操作

替代方案

Linear MCP (tacticlaunch) 对比其他方案

替代方案何时用它替代权衡
Linear official MCP需要 OAuth + 官方支持部分 fork 的功能覆盖更少
GitHub issues团队主要在 GitHub 上工作模型不同——没有 Linear 的项目和迭代周期概念

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills