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.
| Tarefa | Como o agente ajuda | Ação no Linear |
|---|---|---|
| Triagem de bugs | Lê uma lista de problemas e cria uma issue para cada um | Criar issues |
| Atualização de status | Move issues conforme o que você informa | Atualizar issues |
| Resumo do ciclo | Lê as issues do ciclo e escreve um resumo | Consultar ciclos |
| Organização de projetos | Lista o que está parado em um projeto | Consultar 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.
- Entre no DoubleX Agentes e abra a tela Conectores.
- Procure o Linear e inicie a conexão.
- Autorize o acesso com a sua conta do Linear.
- Defina se a conexão é pessoal, do time ou da empresa.
- 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.
- 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.
| Modo | O que o agente faz | Quando usar |
|---|---|---|
| Só leitura | Consulta issues, projetos e ciclos | Primeiros testes, resumos e relatórios |
| Leitura e alteração | Também cria e atualiza issues | Triagem 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ão | Quem usa | Indicada para |
|---|---|---|
| Pessoal | Só você | Testes e uso individual |
| Do time | Pessoas do time | Rotinas de uma área, como produto ou engenharia |
| Da empresa | Toda a empresa | Uso 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
- Como conectar o Box a um agente de IA passo a passoVeja como conectar o Box a um agente de IA: do cadastro ao primeiro pedido, com permissões, modo só leitura e histórico para controlar o acesso aos arquivos.
- Como conectar o Jam a um agente de IA passo a passoVeja como conectar o Jam a um agente de IA no DoubleX Agentes: escolha o tipo de conexão, limite permissões e teste com um relatório de bug.