Linear MCP: como conectar sua equipe à IA

Endereço do servidor e autenticação

Use https://mcp.linear.app/mcp com Streamable HTTP, uma conexão web com o servidor hospedado. A configuração interativa usa OAuth 2.1 com registro dinâmico de clientes, que cuida do registro do cliente e da autorização do usuário. Outra opção é enviar um token OAuth ou uma chave de API do Linear em Authorization: Bearer <yourtoken>. Configuração do Linear MCP

Pense no MCP como um balcão de atendimento compartilhado. O assistente solicita uma operação pelo nome, como localizar uma issue ou salvar uma alteração. O servidor do Linear executa a operação se a conexão tiver permissão para isso. O prompt informa a intenção; ele não concede permissões extras.

Essas são formas diferentes de restringir uma conexão. Um prompt dizendo “não edite” é uma instrução para o assistente; um endpoint ou uma credencial somente de leitura limita o que ele consegue fazer. Opções de acesso do Linear

Como conectar o Linear MCP ao cliente da sua equipe

Claude e Claude Code

No Claude pelo navegador ou pelo aplicativo para desktop, abra Settings → Connectors e conecte o Linear. Esse é o caminho indicado na página de integração do Linear com o Claude.

No Claude Code:

1. Execute claude mcp add --transport http linear-server https://mcp.linear.app/mcp no terminal.
2. Abra uma sessão do Claude Code.
3. Execute /mcp e conclua a autenticação.

Tanto o comando quanto a etapa seguinte constam nas instruções do Linear para o Claude.

Cursor

O guia principal do Linear oferece um link de instalação e orienta a procurar o Linear na página de ferramentas MCP do Cursor. Use a opção de instalação na seção do Linear sobre o Cursor.

A página específica da integração com o Cursor também apresenta este caminho manual:

1. Pressione Ctrl/Cmd + Shift + J para abrir as configurações do Cursor.
2. Selecione MCP.
3. Selecione Add new global MCP server.
4. Adicione esta configuração:

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

Essa configuração usa mcp-remote, uma ponte entre o cliente e o servidor hospedado. É a configuração publicada na página de integração do Linear com o Cursor.

CLI e extensão do Codex para IDE

Segundo o Linear, a CLI e a extensão para IDE compartilham a configuração de MCP.

1. Execute codex mcp add linear --url https://mcp.linear.app/mcp.
2. Siga a solicitação de login no Linear descrita no guia de configuração.
3. Se optar pela configuração manual, o Linear orienta a autenticar com codex mcp login linear depois de editar ~/.codex/config.toml.

Antes de copiar uma configuração, observe uma divergência entre as páginas da documentação:

Na página específica da integração, a entrada manual do servidor é [mcp_servers.linear], com url = "https://mcp.linear.app/mcp". As configurações estão reproduzidas como foram publicadas, mas essas opções conflitantes não devem ser tratadas como um pré-requisito atual e universal. Integração do Linear com o Codex, guia principal de MCP

Use os comandos de adição e login indicados acima. O guia atual de MCP da OpenAI documenta a configuração de servidores HTTP e o comando codex mcp login <server-name> sem exigir nenhuma dessas opções. Documentação oficial de MCP da OpenAI

ChatGPT

Siga o procedimento que o Linear documenta:

1. Abra as configurações de conectores do ChatGPT pelo link na página de integração do Linear com o ChatGPT.
2. Conecte o Linear.
3. Na pesquisa aprofundada, adicione o Linear como fonte.

O Linear descreve essa conexão como uma forma de consultar issues, projetos e discussões, preservando as permissões que cada usuário já possui. A documentação não descreve criação ou atualização de issues por essa configuração. Use-a para pesquisa e resumos; para os exemplos de edição abaixo, escolha um cliente MCP com suporte documentado a escrita. Essa distinção diz respeito àquela conexão específica, e não a toda e qualquer integração com o ChatGPT.

Quais ferramentas o Linear documenta

A distinção mais útil é entre buscar contexto e salvar alterações. A tabela abaixo traz os identificadores exatos da lista de ferramentas mais usadas publicada pelo Linear, junto com a função de cada uma. Essa lista aparece na página de integração com o Slack, na seção sobre conectar o mesmo servidor Linear MCP ao Slackbot. Lista de ferramentas do Linear

O histórico de atualizações do Linear também cita list_cycles, list_issue_labels, list_comments, save_project e save_document. Ele documenta detalhes dos ciclos, consulta paginada de etiquetas e comentários, alterações em projetos e criação ou mudança do vínculo hierárquico de documentos em iniciativas ou ciclos. Esse é um inventário publicado de ferramentas relevantes; não significa que todos os clientes exponham um catálogo idêntico e de tamanho fixo. Ferramentas de ciclos e etiquetas, ferramentas de comentários, ferramentas de projetos e documentos

Exemplos antigos podem usar create_issue e update_issue separadamente. O Linear reuniu as duas operações em save_issue. Leve isso em conta ao copiar prompts antigos ou desenvolver algo que dependa dos nomes das ferramentas. Mudança nas ferramentas do Linear

O que a conexão pode acessar e o que o administrador controla

Trate a conexão como uma via autorizada de acesso aos dados do workspace. Na terminologia OAuth do Linear, read significa “acesso de leitura à conta do usuário” e write, “acesso de escrita à conta do usuário”. No modo padrão, em que o aplicativo atua como o usuário, os recursos são criados em nome da pessoa que autorizou o aplicativo. Permissões OAuth do Linear

Para chaves de API, o Linear usa a expressão “acesso completo aos dados que seu usuário pode acessar”, com a opção de restringir permissões e equipes. Por isso, uma chave restrita é substancialmente diferente de uma chave pessoal com autorização ampla. Permissões das chaves de API

Os controles dependem da forma de autenticação da conexão:

O Linear descreve o objetivo das aprovações de aplicativos como controlar “quais aplicativos podem acessar o workspace e seus dados”. Os membros podem solicitar aprovação durante a instalação. Os controles de chaves se aplicam à autenticação por chave de API; não substituem a gestão das conexões de aplicativos via OAuth. Aprovação de aplicativos, Administração de APIs

Nos clientes Anthropic compatíveis, workspaces Enterprise com Okta SAML podem usar autorização gerenciada pela empresa. Segundo o Linear, isso “aplica as permissões que os usuários já têm no Linear”. Os administradores gerenciam o acesso pelo Okta, sem exigir uma autorização separada do usuário para cada conexão. Autorização gerenciada pela empresa

Para um fluxo voltado apenas a relatórios de status, escolha acesso somente de leitura. Para triagem e criação de issues, conceda as permissões de escrita necessárias e mostre as alterações propostas antes de aplicá-las. Essa etapa de revisão é uma recomendação de fluxo de trabalho; não significa que todos os clientes exijam aprovação da mesma forma.

Três fluxos de trabalho que valem a pena

Comece pelos relatórios de ciclo, que podem funcionar sem permissões de escrita. A triagem vem em seguida, quando a análise das novas demandas é repetitiva. Já a conversão de especificações compensa quando uma liderança gasta tempo transformando decisões já tomadas em tickets.

Os exemplos abaixo são fictícios e mostram os fluxos em detalhes. Eles ilustram prompts e entregas esperadas; não são resultados de um teste com uma conta conectada.

Transforme a triagem de novas issues em uma proposta para revisão

Uma liderança de engenharia poderia pedir ao assistente que analisasse os relatos recebidos, buscasse issues semelhantes já existentes e apresentasse as alterações propostas em conjunto. O ganho está em reduzir buscas repetidas e edições de propriedades, mantendo com a liderança a decisão sobre responsáveis e prioridades.

Exemplo de entrada: Um novo relato, “Botão de exportação trava”, informa que o navegador para de responder durante uma exportação com filtros. Uma issue existente, “Exportação com filtros nunca termina”, descreve a mesma tela. Outro relato, “Convites não chegam”, não traz logs de entrega nem passos para reproduzir o problema.

Prompt:

Uma proposta útil:

Após a revisão, a liderança poderia autorizar apenas as alterações de etiquetas e responsáveis que foram acordadas, usando save_issue e mantendo os relatos ambíguos como estão. O assistente deve retornar os links das issues afetadas e um registro dos campos alterados. As operações de consulta e gravação constam na lista de ferramentas do Linear.

Antes de desenvolver um sistema próprio de triagem, compare a proposta com o Triage Intelligence. O Linear já oferece sugestões de propriedades e detecção de duplicatas ou relações entre issues. Uma orquestração personalizada via MCP faz mais sentido quando a decisão exige contexto ou regras que vão além do fluxo nativo. Triage Intelligence

Transforme uma especificação em issues sem inventar requisitos

Um fundador poderia partir de um escopo de funcionalidade aprovado, gerar rascunhos de issues e, depois da revisão, criar o trabalho no Linear. O ganho é a consistência: cada ticket registra o requisito que lhe deu origem, e as decisões pendentes continuam visíveis.

Exemplo de especificação: “Administradores do workspace podem convidar membros por e-mail. Os convidados aceitam por um link enviado por e-mail. Administradores podem revogar convites pendentes. Alterações de cobrança e convites em massa estão fora do escopo.”

Prompt:

Divisão proposta em issues:

Perguntas em aberto: O que acontece quando o e-mail já pertence a um membro? O convite expira? O que a pessoa convidada deve ver depois da revogação? Essas perguntas permanecem em aberto até que a pessoa responsável pelo produto decida.

Com a proposta aprovada, o assistente poderia criar a issue principal e as sub-issues, retornar suas URLs e indicar qualquer item que não conseguiu criar. A criação de sub-issues é uma capacidade documentada do MCP. Atualizações do MCP do Linear

O assistente faz a transcrição. As decisões de produto continuam com a pessoa responsável pelo produto.

Prepare o relatório semanal a partir do ciclo

Uma liderança poderia transformar o trabalho do ciclo em um rascunho de status com links que sustentem cada afirmação. O ganho está em encurtar o caminho entre atualizações espalhadas pelas issues e um relatório que possa ser conferido.

Um relatório semanal e um resumo de ciclo podem abranger períodos diferentes. Especifique a equipe, o ciclo e o período do relatório para que “concluído neste ciclo” não vire “concluído nesta semana” sem que ninguém perceba.

Exemplo de material de origem: “E-mail de convite” foi marcado como Done durante o período do relatório. “Aceitar convite” continua em In Progress. Um comentário em “Revogar convite” informa que a implementação aguarda uma decisão de produto sobre a experiência de quem acessa um link revogado.

Prompt:

Exemplo de rascunho:

Em um rascunho real, cada frase deve trazer a URL da issue correspondente. O exemplo deixa de fora, de propósito, qualquer percentual de conclusão ou afirmação de lançamento. A consulta a ciclos, issues e comentários fornece os elementos necessários para esse fluxo. Ferramentas de ciclos e issues, consulta a comentários

Outros usos depois que esses fluxos estiverem consolidados

A criação de comentários faz parte das capacidades documentadas do servidor, enquanto as ferramentas de projeto fornecem contexto para a passagem de trabalho. Capacidades do servidor, ferramentas de projeto

A conta do retorno também inclui o tempo de revisão

O custo afetado é o da coordenação de engenharia. Antes do MCP, a liderança pesquisa, copia, concilia informações e escreve. Com um assistente conectado, ainda precisa delimitar o pedido, revisar o resultado e corrigir erros.

Use este cálculo para descobrir se a adoção compensa, com os seus próprios custos:

Valor líquido = (tempo de preparação manual − tempo de preparação assistida, revisão e correção) × custo total por hora de trabalho − custos adicionais com o aplicativo cliente e a operação.

Um relatório bem apresentado que leva mais tempo para conferir não economizou tempo da equipe. Mantenha o mesmo escopo de relatório ao comparar os fluxos e contabilize o retrabalho causado por edições incorretas. A meta útil é reduzir o esforço de coordenação por resultado aceito.

Para escolher uma assinatura, veja os preços do Linear. Se a ferramenta de gestão de trabalho ainda não foi definida, a comparação Linear vs Jira ajuda nessa decisão. Nosso guia dos melhores servidores MCP apresenta outras conexões relacionadas.

O que vale a pena desenvolver com essa conexão

Um serviço que prepara rascunhos de status do ciclo é a oportunidade mais promissora para começar. Uma liderança de engenharia poderia pagar por um relatório consistente, que respeite os limites de cada equipe, separe trabalho concluído de trabalho em aberto e traga evidências das issues. A menor versão útil salvaria a definição do relatório, buscaria os dados relevantes do ciclo e produziria um rascunho editável. Agendamento, novas tentativas em caso de falha e entrega ficariam a cargo da sua aplicação.

O desafio é a diferenciação: um prompt genérico de resumo é fácil de reproduzir. O potencial produto está nas regras de relatório da empresa, na rastreabilidade das fontes e no processo de revisão. Antes de criar uma assinatura independente, confirme que essas dificuldades se repetem nas equipes.

Uma fila personalizada de revisão de triagem é uma oportunidade mais específica. Uma liderança de plataforma ou de engenharia de suporte poderia pagar para combinar o contexto das issues do Linear com suas próprias regras de encaminhamento e informações de suporte com autorização de acesso separada. A menor versão mostraria as alterações de campos propostas, as evidências e uma ação para aprovar ou pular; depois, aplicaria as mudanças aceitas.

O desafio é a concorrência direta com o Triage Intelligence nativo do Linear. Só desenvolva essa solução se o contexto ou as regras adicionais mudarem uma decisão que o sistema nativo não consiga tratar adequadamente para aquela equipe. Essas são hipóteses de produto, não resultados comprovados de clientes.

Quais são os limites da conexão?

O MCP dá ao assistente acesso a operações; não resolve requisitos ambíguos nem torna confiáveis os dados incompletos de uma issue. Um ticket marcado como Done pode sustentar uma afirmação sobre o status daquele ticket. Sozinho, não comprova que a funcionalidade chegou ao cliente.

Da mesma forma, autorizar o acesso ao Linear não autoriza o acesso a todos os documentos, repositórios ou sistemas de suporte mencionados em uma issue. Se a solução precisar dessas fontes, planeje separadamente como acessá-las e consultar seus dados.

Para novas configurações, use /mcp. O Linear classifica /sse como uma alternativa obsoleta. O antigo servidor comunitário de jerhadf também informa expressamente que foi descontinuado e não recebe mais manutenção, e direciona os usuários ao servidor oficial do Linear. Orientações atuais sobre endpoints

Para colocar em prática na segunda-feira: peça à liderança de engenharia que defina a equipe, o ciclo e o período de um rascunho de status com acesso somente de leitura. Confira as afirmações nas issues vinculadas e compare o esforço de preparação com o processo atual. Avance para operações de escrita quando a equipe tiver uma rotina clara de revisão.

Se você quer implementar esses fluxos com as regras da sua equipe, desenvolvemos automações com IA.