Linear MCP — Casos de uso, Instalar & Demo ao vivo

Name: Linear MCP Server
Author: linear

Por que usar

Principais recursos

Oficial, hospedado remotamente — autenticação via mcp-remote OAuth, sem vazamento de token
Questão CRUD completa: criar, atualizar, atribuir, comentar, mover estado
Consulta por ciclo, equipe, responsável, rótulo, projeto ou texto livre
Respeita as permissões do seu espaço de trabalho Linear – o agente não pode fazer o que você não pode

Demo ao vivo

Como fica na prática

linear.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/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"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Linear

Como fazer a triagem de um backlog linear confuso em 10 minutos

👤 Gerentes de engenharia, líderes de tecnologia ⏱ ~15 min intermediate

Quando usar: Segunda de manhã. O backlog tem mais de 200 problemas não triados e o planejamento é feito em uma hora.

Pré-requisitos

Acesso linear ao espaço de trabalho — OAuth por meio de mcp-remote — a primeira chamada de ferramenta abre o navegador para conceder
Slug de equipe (por exemplo, ENG) — Observe qualquer identificador de problema – o prefixo é o slug da sua equipe

Fluxo

Puxe todos os problemas não triados para a equipe

Listar todos os problemas de ENG em estado ‘Triagem’ ou sem prioridade definida, criados nos últimos 30 dias. Retornar id, título, repórter e comprimento da descrição.✓ Copiado

→ Tabela de candidatos com contexto suficiente para classificar
Agrupar por tema

Agrupe-os em 4 a 6 temas (bug/infra/onboarding/perf/etc.). Para cada cluster, propor uma prioridade e um projeto sugerido.✓ Copiado

→ Clusters temáticos com justificativa
Aplicar as decisões

Para cada cluster, atualize os problemas: defina a prioridade, adicione o rótulo correspondente e passe para o estado 'Backlog'. NÃO atribua ninguém.✓ Copiado

→ N problemas atualizados, confirmações registradas

Resultado: Um backlog pronto para planejamento, agrupado e priorizado, com uma trilha de auditoria de cada alteração feita pelo agente.

Armadilhas

O agente atribui problemas em massa às pessoas erradas com base em “quem escreveu código semelhante” — Diga explicitamente para NÃO atribuir - a atribuição é uma chamada humana e deve continuar assim
A taxa linear de nível gratuito limita você após aproximadamente 1.500 solicitações/h — Atualizações em lote com issueBatchUpdate quando disponível; caso contrário, mantenha a triagem abaixo de 500 problemas

Combine com: sentry · github

Gere um relatório semanal de status do ciclo do Linear

👤 Gerentes de engenharia, PMs ⏱ ~10 min beginner

Quando usar: Sexta-feira à tarde, você precisa escrever a atualização semanal para liderança.

Pré-requisitos

Ciclo ativo em Linear — Linear > sua equipe > Ciclos — anote o número do ciclo atual

Fluxo

Estatísticas do ciclo pull

Para o ciclo 47 da ENG, liste todos os problemas agrupados por estado. Incluir concluído esta semana, em andamento, bloqueado e em risco (sem atualização em mais de 3 dias).✓ Copiado

→ Divisão com contagens e títulos de emissão
Diferença em relação à semana passada

Compare com o instantâneo da semana passada [colar JSON anterior]. O que foi enviado, o que regrediu aos estados anteriores, o que foi recentemente bloqueado?✓ Copiado

→ Delta com narrativa
Elabore o relatório

Escreva um relatório Markdown de 1 página: vitórias, em andamento, bloqueadores, ajuda necessária. Seja honesto – a liderança lê nas entrelinhas.✓ Copiado

→ Relatório pronto para colar no Slack ou Notion

Resultado: Uma atualização de ciclo aprimorada em 10 minutos em vez de 45.

Armadilhas

Problemas concluídos sem PRs mesclados parecem progresso, mas não são — Combine com GitHub MCP - verifique se cada problema 'Concluído' tem um PR mesclado referenciado

Combine com: github · notion

Arquivar automaticamente bugs lineares de novos problemas do Sentry

👤 Engenheiros de plantão ⏱ ~15 min intermediate

Quando usar: Você deseja que picos de erros em tempo real no Sentry se tornem bugs rastreados sem copiar e colar manualmente.

Pré-requisitos

Sentry MCP instalado junto com Linear — Consulte o guia do sentinela para configuração
Um rótulo Linear dedicado como from-sentry — Linear > Configurações > Etiquetas — crie uma vez

Fluxo

Encontre novos problemas do Sentry acima do limite

Encontre problemas do Sentry vistos pela primeira vez nas últimas 24h com mais de 50 eventos no projeto de produção web.✓ Copiado

→ Lista com IDs de problemas e contagens de eventos
Verifique se há duplicatas em Linear

Para cada título de problema do Sentry, pesquise Linear por problemas existentes com títulos semelhantes ou contendo o URL do Sentry. Ignore os já arquivados.✓ Copiado

→ Lista de desduplicação — apenas itens genuinamente novos
Crie os bugs lineares

Crie um problema linear na equipe ENG para cada novo problema do Sentry: título = título do Sentry, descrição = stacktrace + link, prioridade = Urgente se >1000 eventos else High, label = from-sentry.✓ Copiado

→ N problemas criados com links retornados

Resultado: Uma entrada de bugs linear limpa que nunca deixa cair um erro de produção no chão.

Armadilhas

O mesmo problema do Sentry é arquivado duas vezes porque os títulos variam ligeiramente — Use o ID abreviado do problema do Sentry (por exemplo, WEB-3a91) no título Linear e desduplicar nessa substring

Combine com: sentry

Evitar problemas obsoletos no ciclo atual

👤 Líderes de tecnologia, scrum masters ⏱ ~5 min beginner

Quando usar: Verificação no meio do ciclo. Problemas atribuídos por mais de 5 dias sem alteração de estado geralmente ficam paralisados.

Fluxo

Encontre os problemas obsoletos

Liste os problemas no ciclo ENG atual que estão em 'Em andamento' há mais de 5 dias sem alteração de estado ou comentário.✓ Copiado

→ Lista com cessionário e dias obsoletos
Poste um comentário gentil

Adicione um comentário sobre cada um: 'Check-in rápido - ainda no caminho certo para este ciclo ou você precisa analisar isso / obter ajuda?' Marque o responsável.✓ Copiado

→ Comentários postados, links retornados
Escalar se for ignorado

Em 48 horas, execute novamente. Se ainda não houver atualização, envie-me uma lista por DM para acompanhamento 1: 1.✓ Copiado

→ Lista de escalonamento para acompanhamento humano

Resultado: Trabalho desbloqueado sem ser o gerente chato todos os dias.

Armadilhas

Comente spam se você executar isso de hora em hora — Verifique se o agente já comentou nos últimos 3 dias antes de postar novamente

Crie um projeto linear a partir de uma especificação do Notion

👤 PMs e líderes de tecnologia iniciando uma nova iniciativa ⏱ ~20 min intermediate

Quando usar: Você tem um PRD escrito e precisa dividi-lo em questões rastreáveis.

Pré-requisitos

Noção MCP instalada — Veja o guia de noções
O URL da página PRD — Copiar da noção

Fluxo

Leia e resuma as especificações

Leia o Notion PRD em <URL> e liste cada entrega discreta como uma descrição de uma linha.✓ Copiado

→ 15-40 questões candidatas
Revise e refine

Agrupe-os em 3 a 5 marcos. Sinalize qualquer trabalho que precise de design, API ou banco de dados como problemas separados.✓ Copiado

→ Árvore de problemas estruturada
Crie o projeto Linear e os problemas

Crie um projeto linear chamado '<Spec title>' na equipe ENG. Crie cada marco como um problema pai, com os filhos como subproblemas. Link de volta para a página Notion em cada descrição.✓ Copiado

→ URL do projeto + contagem de problemas

Resultado: Um projeto Linear totalmente estruturado em 20 minutos, em vez de 2 horas de escrita manual de tickets.

Armadilhas

O agente cria 80 problemas quando você queria 20 – muito granular — Na etapa 2, limite explicitamente: 'não mais que 20 edições no total, mescle qualquer coisa menor que um dia de trabalho'

Combine com: notion

Combinações

Combine com outros MCPs para 10× de alavancagem

linear + sentry

Transforme picos de erros de produção em bugs lineares rastreados automaticamente

Encontre novos problemas de produção da web do Sentry das últimas 24h com mais de 50 eventos. Para cada um, crie um bug linear na equipe ENG denominado 'from-sentry', prioridade alta, com o stacktrace na descrição.✓ Copiado

linear + github

Vincule PRs automaticamente a problemas lineares e feche problemas quando os PRs se fundirem

Para cada PR aberto em meu repositório, encontre o ID do problema Linear no título ou nome da filial e adicione um comentário de referência sobre o problema Linear com o URL do PR.✓ Copiado

linear + notion

Publicar resumos do ciclo semanal em um banco de dados Notion

Gere o status do ciclo ENG desta semana e crie uma página no banco de dados Notion 'Engineering Weekly' com o relatório completo.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_issues	team?, assignee?, state?, label?, cycle?, query?, limit?	Pesquisa primária – filtre o stream	1 API call
get_issue	id	Busque o contexto completo para um único problema	1 API call
create_issue	teamId, title, description?, priority?, labelIds?, assigneeId?, projectId?	Registrar um novo problema	1 API call
update_issue	id, stateId?, priority?, assigneeId?, labelIds?, title?, description?	Alterar estado, prioridade ou atribuição	1 API call
create_comment	issueId, body	Publique uma sugestão ou nota de status sobre um problema	1 API call
list_projects	teamId?	Descubra projetos ativos em uma equipe	1 API call
list_cycles	teamId	Encontre ciclos ativos ou recentes para uma equipe	1 API call
list_teams		Descubra equipes no espaço de trabalho	1 API call

Custo e limites

O que custa rodar

Cota de API: 1.500 req/h para aplicativos OAuth, 120 req/min burst – generoso para qualquer fluxo de trabalho real
Tokens por chamada: 300–1500 tokens por edição, dependendo da descrição/comentários
Monetário: Gratuito – Linear MCP está incluído em qualquer plano Linear
Dica: Use list_issues com filtros específicos em vez de extrair tudo e depois filtrar - reduz o custo do token em 10x em grandes pendências

Segurança

Permissões, segredos, alcance

Escopos mínimos: read write issues:create

Armazenamento de credenciais: OAuth via mcp-remote — tokens armazenados em ~/.mcp-auth/, atualizáveis sem fazer login novamente

Saída de dados: Todas as chamadas para api.linear.app e mcp.linear.app

Nunca conceda: admin

Solução de problemas

Erros comuns e correções

OAuth browser popup doesn't open

Execute npx -y mcp-remote https://mcp.linear.app/sse manualmente uma vez - ele imprimirá um URL que você pode colar em um navegador

Verificar: After auth, re-run your agent; token cached in ~/.mcp-auth/

403 on update_issue

Sua função Linear não tem acesso de gravação para essa equipe. Peça a um administrador do espaço de trabalho para promovê-lo ou inclua o agente em uma equipe sua.

Issues returned but comments are missing

Os comentários são uma consulta separada - use get_issue com comentários incluídos ou liste os comentários separadamente com o ID do problema.

Can't find an issue you know exists

Verifique o filtro da equipe — os problemas em outras equipes não serão retornados, a menos que você passe team=null ou especifique essa equipe.

Alternativas

Linear vs. outros

Alternativa	Quando usar	Troca
Jira MCP	Sua organização está no Jira, não no 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

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills