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

Name: Linear MCP (tacticlaunch) MCP Server
Author: tacticlaunch

Por que usar

Principais recursos

CRUD completo em issues, comentários, projetos, times
Transições de status por nome (sem precisar caçar UUIDs)
Filtrar issues por responsável, projeto, label, status
Leituras de projeto + roadmap para planejamento de sprint
PAT em variável de ambiente — sem processo OAuth

Demo ao vivo

Como fica na prática

linear-mcp-tacticlaunch.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-mcp-tacticlaunch": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "your_linear_api_token"
      }
    }
  }
}

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

~/.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 usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

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"
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "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"
      }
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "linear-mcp-tacticlaunch",
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "linear-mcp-tacticlaunch": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@tacticlaunch/mcp-linear"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

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

Casos de uso

Usos do mundo real: Linear MCP (tacticlaunch)

Entregar uma feature sem abrir o Linear uma vez sequer

👤 Devs que odeiam troca de contexto ⏱ ~10 min beginner

Quando usar: Você está focado codificando e não quer quebrar o fluxo para atualizar tickets.

Pré-requisitos

PAT do Linear — linear.app → Settings → API → Personal API keys

Fluxo

Pegar trabalho

Use o MCP do Linear. Mostre minhas issues abertas em 'In Progress'. Pegue a de maior prioridade e marque-a como 'In Review' — terminei.✓ Copiado

→ Issue listada, status atualizado
Comentar

Adicione um comentário: 'PR #1234 pronto para revisão. Testes passando, benchmarks de performance vinculados.' Vincule o PR.✓ Copiado

→ Comentário publicado com link do PR
Planejar próximo

O que vem a seguir na minha fila? Agrupe por projeto.✓ Copiado

→ Lista de issues agrupada

Resultado: Higiene de gestão de projeto sem sair do terminal.

Armadilhas

Nome de status não corresponde (ex.: 'In Review' vs 'Review') — Peça ao Claude para listar primeiro os estados do workflow do time

Combine com: github

Gerar automaticamente sua atualização semanal a partir da atividade no Linear

👤 ICs escrevendo atualizações semanais ⏱ ~5 min beginner

Quando usar: Sexta à tarde — você não lembra o que fez nesta semana.

Fluxo

Buscar

Busque todas as issues que fechei ou comentei esta semana. Agrupe por projeto.✓ Copiado

→ Log de atividade agrupado
Rascunhar

Escreva uma atualização de 5 tópicos — Concluído / Em Progresso / Bloqueado. Seja conciso.✓ Copiado

→ Resumo enxuto de 5 tópicos

Resultado: Documento de standup gerado em 30 segundos, não em 30 minutos.

Armadilhas

Trabalho apenas em PR faltando — Combine com o MCP do github para capturar atividade de PR

Combine com: github

Triagem de uma enxurrada de relatórios de bug para o Linear

👤 On-call / rotação de triagem ⏱ ~30 min intermediate

Quando usar: O suporte ao cliente enviou 30 bugs. Eles precisam de label, prioridade e responsável.

Fluxo

Importação em massa

Leia /tmp/bugs.md. Cada item é um bug. Crie uma issue no Linear por item com o time e projeto corretos.✓ Copiado

→ N issues criadas, IDs retornados
Priorizar

Leia a descrição de cada issue e defina a prioridade (urgente/alta/média/baixa) com base no impacto para o usuário.✓ Copiado

→ Prioridades aplicadas

Resultado: Caixa de entrada zerada; Linear tem trabalho triado.

Armadilhas

Issues duplicadas — Pesquise por títulos similares antes de criar

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

linear-mcp-tacticlaunch + github

Vincular automaticamente PRs a issues do Linear; fechar issues no merge

Quando o PR #1234 for mergeado, encontre o LIN-456 vinculado e marque-o como Concluído.✓ Copiado

linear-mcp-tacticlaunch + filesystem

Importação em massa a partir de um arquivo markdown de bugs

Leia /tmp/bugs.md e crie uma issue no Linear por item.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_issues	team?, assignee?, status?, project?, limit?	Encontrar trabalho a fazer	1 chamada GraphQL
create_issue	title, description?, team, project?, assignee?, priority?	Registrar um novo bug ou tarefa	1 mutation
update_issue	id, status?, assignee?, priority?, title?, description?	Mover tickets pelo workflow	1 mutation
add_comment	issue_id, body	Atualizações de status, links de PR	1 mutation
list_projects	team?	Relatórios em nível de projeto	1 query
list_teams	(nenhum)	Queries entre times	1 query

Custo e limites

O que custa rodar

Cota de API: Limites do plano Linear — plano Free 250 membros, Plus e acima aumentam os limites de taxa
Tokens por chamada: 200–2000
Monetário: Gratuito (o próprio MCP)
Dica: Filtre agressivamente; um list_issues grande é mais barato que centenas de gets individuais

Segurança

Permissões, segredos, alcance

Escopos mínimos: Token de API pessoal — escopo de membro do workspace

Armazenamento de credenciais: Variável de ambiente LINEAR_API_TOKEN

Saída de dados: Apenas api.linear.app

Nunca conceda: Tokens de admin do workspace para agentes

O PAT herda todas as suas permissões do workspace — rotacione se seu laptop for comprometido

Solução de problemas

Erros comuns e correções

401 Unauthorized

Token ausente ou revogado; regenere em linear.app/settings/api

Verificar: curl -H 'Authorization: <token>' https://api.linear.app/graphql

Status não encontrado

Os estados de workflow são por time; liste os estados daquele time primeiro

Rate limited (429)

Aguarde; agrupe operações onde possível

Alternativas

Linear MCP (tacticlaunch) vs. outros

Alternativa	Quando usar	Troca
MCP oficial do Linear	Você quer OAuth + suporte first-party	Menor superfície de features em alguns forks
GitHub issues	Seu time vive no GitHub	Modelo diferente — sem projetos/ciclos como o Linear

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills