Linear MCP — Сценарии использования, Установка & Живое демо

Name: Linear MCP Server
Author: linear

Зачем использовать

Ключевые функции

Official, remote-hosted — auth via mcp-remote OAuth, no token leaks
Full issue CRUD: create, update, assign, comment, move state
Query by cycle, team, assignee, label, project, or free-text
Respects your Linear workspace permissions — agent can't do what you can't

Живое демо

Как выглядит на практике

linear.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "linear",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/sse"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "linear": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.linear.app/sse"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add linear -- npx -y mcp-remote https://mcp.linear.app/sse

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Linear

How to triage a messy Linear backlog in 10 minutes

👤 Engineering managers, tech leads ⏱ ~15 min intermediate

Когда использовать: Monday morning. The backlog has 200+ untriaged issues and planning is in an hour.

Предварительные требования

Linear workspace access — OAuth through mcp-remote — first tool call opens browser to grant
Team slug (e.g. ENG) — Look at any issue identifier — the prefix is your team slug

Поток

Pull every untriaged issue for the team

List all ENG issues in state 'Triage' or with no priority set, created in the last 30 days. Return id, title, reporter, and description length.✓ Скопировано

→ Table of candidates with enough context to classify
Cluster by theme

Group these into 4-6 themes (bug / infra / onboarding / perf / etc.). For each cluster, propose a priority and suggested project.✓ Скопировано

→ Themed clusters with rationale
Apply the decisions

For each cluster, update the issues: set priority, add the matching label, and move to 'Backlog' state. Do NOT assign anyone.✓ Скопировано

→ N issues updated, confirmations logged

Итог: A planning-ready backlog, grouped and prioritized, with an audit trail of every change the agent made.

Подводные камни

Agent mass-assigns issues to the wrong people based on 'who wrote similar code' — Explicitly tell it NOT to assign — assignment is a human call and should stay that way
Free-tier Linear rate-limits you after ~1500 requests/h — Batch updates with issueBatchUpdate when available; otherwise keep triage runs under 500 issues

Сочетать с: sentry · github

Generate a weekly cycle status report from Linear

👤 Engineering managers, PMs ⏱ ~10 min beginner

Когда использовать: Friday afternoon, you need to write the weekly update for leadership.

Предварительные требования

Active cycle in Linear — Linear > your team > Cycles — note the current cycle number

Поток

Pull cycle stats

For ENG cycle 47, list all issues grouped by state. Include completed-this-week, in-progress, blocked, and at-risk (no update in 3+ days).✓ Скопировано

→ Breakdown with counts and issue titles
Diff against last week

Compare to last week's snapshot [paste prior JSON]. What shipped, what regressed to earlier states, what's newly blocked?✓ Скопировано

→ Delta with narrative
Draft the report

Write a 1-page Markdown report: wins, in-flight, blockers, help-needed. Keep it honest — leadership reads between the lines.✓ Скопировано

→ Report ready to paste into Slack or Notion

Итог: A polished cycle update in 10 minutes instead of 45.

Подводные камни

Completed issues without merged PRs look like progress but aren't — Combine with GitHub MCP — verify each 'Done' issue has a merged PR referenced

Сочетать с: github · notion

Auto-file Linear bugs from new Sentry issues

👤 On-call engineers ⏱ ~15 min intermediate

Когда использовать: You want real-time error spikes in Sentry to become tracked bugs without manual copy-paste.

Предварительные требования

Sentry MCP installed alongside Linear — See the sentry guide for setup
A dedicated Linear label like from-sentry — Linear > Settings > Labels — create once

Поток

Find new Sentry issues over threshold

Find Sentry issues first seen in the last 24h with >50 events in the web-prod project.✓ Скопировано

→ List with issue IDs and event counts
Check for duplicates in Linear

For each Sentry issue title, search Linear for existing issues with similar titles or containing the Sentry URL. Skip ones already filed.✓ Скопировано

→ Dedupe list — only genuinely new items
Create the Linear bugs

Create a Linear issue in ENG team for each new Sentry issue: title = Sentry title, description = stacktrace + link, priority = Urgent if >1000 events else High, label = from-sentry.✓ Скопировано

→ N issues created with links returned

Итог: A clean Linear bug intake that never drops a production error on the floor.

Подводные камни

Same Sentry issue gets filed twice because titles drift slightly — Use the Sentry issue short-id (e.g. WEB-3a91) in the Linear title and dedupe on that substring

Сочетать с: sentry

Nudge stale issues in the current cycle

👤 Tech leads, scrum masters ⏱ ~5 min beginner

Когда использовать: Mid-cycle check. Issues assigned for 5+ days with no state change are usually stuck.

Поток

Find the stale issues

List issues in the current ENG cycle that have been in 'In Progress' for 5+ days without a state change or comment.✓ Скопировано

→ List with assignee and days-stale
Post a gentle nudge comment

Add a comment on each: 'Quick check-in — still on track for this cycle, or do you need to break this down / get help?' Tag the assignee.✓ Скопировано

→ Comments posted, links returned
Escalate if ignored

In 48 hours, re-run. If still no update, DM me a list for 1:1 follow-up.✓ Скопировано

→ Escalation list for human follow-up

Итог: Unblocked work without being the nagging manager every day.

Подводные камни

Comment spam if you run this hourly — Check if the agent has already commented in the last 3 days before posting again

Scaffold a Linear project from a Notion spec

👤 PMs, tech leads starting a new initiative ⏱ ~20 min intermediate

Когда использовать: You have a written PRD and need to break it into trackable issues.

Предварительные требования

Notion MCP installed — See notion guide
The PRD page URL — Copy from Notion

Поток

Read and summarize the spec

Read the Notion PRD at <URL> and list every discrete deliverable as a one-line description.✓ Скопировано

→ 15-40 candidate issues
Review and refine

Group these into 3-5 milestones. Flag any that need design, API, or DB work as separate issues.✓ Скопировано

→ Structured issue tree
Create the Linear project and issues

Create a Linear project named '<Spec title>' in ENG team. Create each milestone as a parent issue, with children as sub-issues. Link back to the Notion page in each description.✓ Скопировано

→ Project URL + issue count

Итог: A fully-scaffolded Linear project in 20 minutes instead of 2 hours of manual ticket writing.

Подводные камни

Agent creates 80 issues when you wanted 20 — too granular — In step 2, explicitly cap: 'no more than 20 issues total, merge anything smaller than a day of work'

Сочетать с: notion

Комбинации

Сочетайте с другими MCP — эффект x10

linear + sentry

Turn production error spikes into tracked Linear bugs automatically

Find new Sentry web-prod issues from the last 24h with >50 events. For each, create a Linear bug in ENG team labeled 'from-sentry', priority High, with the stacktrace in the description.✓ Скопировано

linear + github

Auto-link PRs to Linear issues and close issues when PRs merge

For every open PR in my repo, find the Linear issue ID in the title or branch name and add a reference comment on the Linear issue with the PR URL.✓ Скопировано

linear + notion

Post weekly cycle digests to a Notion database

Generate this week's ENG cycle status and create a page in the Notion 'Engineering Weekly' database with the full report.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
list_issues	team?, assignee?, state?, label?, cycle?, query?, limit?	Primary search — filter the stream	1 API call
get_issue	id	Fetch full context for a single issue	1 API call
create_issue	teamId, title, description?, priority?, labelIds?, assigneeId?, projectId?	File a new issue	1 API call
update_issue	id, stateId?, priority?, assigneeId?, labelIds?, title?, description?	Change state, priority, or assignment	1 API call
create_comment	issueId, body	Post a nudge or status note on an issue	1 API call
list_projects	teamId?	Discover active projects in a team	1 API call
list_cycles	teamId	Find active or recent cycles for a team	1 API call
list_teams		Discover teams in the workspace	1 API call

Стоимость и лимиты

Во что обходится

Квота API: 1500 req/h for OAuth apps, 120 req/min burst — generous for any real workflow
Токенов на вызов: 300–1500 tokens per issue depending on description/comments
Деньги: Free — Linear MCP is included in any Linear plan
Совет: Use list_issues with specific filters instead of pulling everything then filtering — cuts token cost 10x on large backlogs

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: read write issues:create

Хранение учётных данных: OAuth via mcp-remote — tokens stored in ~/.mcp-auth/, refreshable without re-logging-in

Исходящий трафик: All calls to api.linear.app and mcp.linear.app

Никогда не давайте: admin

Устранение неполадок

Частые ошибки и исправления

OAuth browser popup doesn't open

Run npx -y mcp-remote https://mcp.linear.app/sse manually once — it'll print a URL you can paste into a browser

Проверить: After auth, re-run your agent; token cached in ~/.mcp-auth/

403 on update_issue

Your Linear role lacks write access to that team. Ask a workspace admin to promote you or scope the agent to a team you own.

Issues returned but comments are missing

Comments are a separate query — use get_issue with include-comments, or list comments separately with the issue ID.

Can't find an issue you know exists

Check the team filter — issues in other teams aren't returned unless you pass team=null or specify that team.

Альтернативы

Linear в сравнении

Альтернатива	Когда использовать	Компромисс
Jira MCP	Your org is on Jira, not Linear	Heavier API, more states/fields to reason about — agents do worse on Jira out of the box
GitHub Issues (via GitHub MCP)	You want issues tightly coupled to code without a separate tool	Lose cycles, projects, and workflow states — GitHub Issues is simpler but less structured

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills