Como conectar o Linear a um agente de IA passo a passo

· DoubleX

Resposta rápida

Para conectar o Linear a um agente de IA, ligue o conector na tela Conectores, autorize sua conta, escolha quais ações o agente pode executar (só leitura ou também alteração) e faça um pedido de teste. No DoubleX Agentes, o histórico da tarefa mostra tudo o que o agente fez no Linear.

Times de produto e engenharia gastam tempo repetindo as mesmas tarefas no Linear: abrir issues a partir de conversas, atualizar status, organizar ciclos. Conectar o Linear a um agente de IA resolve parte disso, mas só vale a pena se você controlar o que o agente pode ler e alterar. Este guia mostra o caminho completo, do conector ao primeiro pedido de teste.

O que o agente consegue fazer no Linear com o conector?#

Com o conector do Linear, o agente consegue criar e atualizar issues, projetos e ciclos. Conector é um sistema ligado à plataforma, cujas ferramentas os agentes passam a usar. Na prática, o agente consulta o que existe no Linear e, se você permitir, também altera.

TarefaComo o agente ajudaAção no Linear
Triagem de bugsLê uma lista de problemas e cria uma issue para cada umCriar issues
Atualização de statusMove issues conforme o que você informaAtualizar issues
Resumo do cicloLê as issues do ciclo e escreve um resumoConsultar ciclos
Organização de projetosLista o que está parado em um projetoConsultar projetos

Para ideias de rotinas mais avançadas, veja o guia Linear com agente de IA: o que automatizar em issues e ciclos.

O que preparar antes de conectar (conta, time e permissões)?#

Antes de conectar, tenha em mãos uma conta no Linear com acesso ao workspace e aos times que o agente vai usar, e decida quem vai poder usar a conexão. O agente age com as permissões da conta que autorizou, então ele não enxerga nada além do que essa conta enxerga.

Faça esta checagem rápida:

  • Você tem acesso ao workspace do Linear que quer usar?
  • Sua conta vê os times e projetos certos?
  • A conexão será só sua, do time ou da empresa?
  • O agente deve apenas ler ou também criar e alterar issues?

Como conectar o Linear na tela Conectores?#

Você conecta o Linear na tela Conectores, escolhendo o Linear na lista e autorizando o acesso com a sua conta. Depois disso, o agente que você escolher passa a poder usar as ferramentas dele.

  1. Entre no DoubleX Agentes e abra a tela Conectores.
  2. Procure o Linear e inicie a conexão.
  3. Autorize o acesso com a sua conta do Linear.
  4. Defina se a conexão é pessoal, do time ou da empresa.
  5. Abra a tela Agentes, escolha o agente (ou crie um novo, ou use o diagnóstico para montar uma equipe de agentes) e ative o Linear nele.
  6. Escolha as ações permitidas, como explicado na próxima seção.

Se você prefere automatizar pela API, a documentação de Conectores descreve como gerenciar essas conexões.

Como escolher quais ações o agente pode executar (leitura x alteração)?#

Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Ações que alteram dados podem ficar desligadas, deixando o agente apenas em modo de leitura.

ModoO que o agente fazQuando usar
Só leituraConsulta issues, projetos e ciclosPrimeiros testes, resumos e relatórios
Leitura e alteraçãoTambém cria e atualiza issuesTriagem e atualização de status, depois de validar

Além disso, antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o passo a passo do que fez. Você mantém a decisão final.

Como fazer o primeiro pedido de teste e conferir o histórico na tela Tarefas?#

Faça um pedido simples de leitura e depois abra a tela Tarefas para ver o que o agente fez. Cada pedido vira uma tarefa com histórico completo: o pedido, cada ferramenta usada e o resultado.

Pedidos que você pode copiar:

  • "Liste as issues abertas do ciclo atual e agrupe por responsável."
  • "Resuma em cinco linhas o que está parado no projeto de lançamento."
  • "Quais issues foram criadas nesta semana no time de produto?"
  • "Crie uma issue com o título 'Revisar tela de login' e me mostre antes de salvar."

Depois do pedido, abra Tarefas e confira quem pediu, quais ferramentas do Linear foram chamadas e o resultado. Se algo saiu diferente do esperado, ajuste as instruções do agente ou as ações permitidas e teste de novo.

Quando o teste de leitura funcionar, você pode agendar a rotina com um gatilho, por exemplo um resumo toda segunda de manhã. A rotina roda com as permissões de quem a criou. Veja mais em Gatilhos.

Como compartilhar a conexão com o time ou deixá-la só pessoal?#

Uma conexão pode ser pessoal, do time ou da empresa. A pessoal só vale para quem a criou; as outras permitem que mais gente use agentes com o Linear sem autorizar de novo.

Tipo de conexãoQuem usaIndicada para
PessoalSó vocêTestes e uso individual
Do timePessoas do timeRotinas de uma área, como produto ou engenharia
Da empresaToda a empresaUso amplo, com permissões bem definidas

A empresa também controla papéis (dono, administrador e membro) e o compartilhamento por pessoa, time ou empresa. Para entender a base da plataforma, consulte a Introdução.

Perguntas frequentes#

Preciso programar para conectar o Linear?#

Não. Você liga o conector na tela Conectores, autoriza a conta e descreve o que precisa com suas próprias palavras. Quem quiser ir além pode usar a API REST, a CLI ou o servidor MCP.

O agente pode alterar issues sem eu saber?#

Ele só altera se a ação estiver permitida. Mesmo assim, antes de alterar algo nos sistemas, o agente pede confirmação, e tudo fica registrado no histórico da tarefa.

Posso deixar o agente só com leitura no Linear?#

Sim. Em cada sistema você escolhe quais ações o agente pode executar, e as que alteram dados podem ficar desligadas.

Onde vejo o que o agente fez no Linear?#

Na tela Tarefas. Cada tarefa mostra o pedido, as ferramentas usadas e o resultado, com quem pediu e quando.

O conteúdo do Linear é usado para treinar modelos?#

Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores de IA que não usam o que recebem para treinamento.

Dá para começar sem pagar?#

Criar a conta e fazer o primeiro diagnóstico é grátis, sem cartão. Para os passos do início, veja o Início rápido.

Guias relacionados

Mais guias de Linear