Importação do Jira

Suas issues do Jira,
trabalhadas pelo agente que você escolher

O sprint é planejado no Jira. Os tickets atribuídos a você estão lá, com as especificações, as capturas de tela e os critérios de aceitação. O que você quer é um agente em cada um deles, na sua própria máquina, na CLI que combina com a tarefa.

O AgentsRoom importa essas issues no backlog do projeto, com a descrição, o tipo, as etiquetas e os arquivos anexados. Cada uma vira um ticket que você entrega ao Claude Code, ao Codex, ao GitHub Copilot CLI, ao Cursor ou a outra CLI de agente, um agente por ticket. A importação só lê: nada é escrito de volta no Jira.

Do Jira para os seus agentes
Projetos do Jira
ACME
MOB
assignee = currentUser()
Backlog · TODO
ACME-412Claude Code
ACME-415Codex
MOB-88Cursor
Somente leitura: nada é escrito de volta

Dois projetos do Jira, uma consulta JQL, um agente por ticket: a importação lê o Jira e nunca escreve nele.

O Jira é onde muitas equipes planejam o trabalho: o backlog, o sprint, a issue que atribuíram a você hoje de manhã. Claude Code, Codex e as outras CLIs de agente são onde, cada vez mais, esse trabalho é feito. Entre os dois, o método de sempre é copiar e colar: o resumo num prompt, a descrição em seguida, as capturas de tela perdidas no caminho.

A importação do Jira faz essa etapa por você. Você conecta o seu site do Jira Cloud com o seu e-mail da Atlassian e um token de API, escolhe um projeto ou escreve uma consulta JQL, pré-visualiza as issues e importa. Elas chegam à coluna TODO do backlog do projeto como tickets comuns, com a descrição convertida para Markdown e os arquivos anexados baixados, e você inicia um agente em cada uma como em qualquer outro ticket.

Não é uma sincronização nos dois sentidos. O AgentsRoom só envia requisições de leitura ao Jira: nenhuma transição, nenhum comentário, nenhum campo alterado. Se você quer que um agente comente uma issue ou a mova para Done, é para isso que existe o próprio servidor MCP da Atlassian, e os dois funcionam juntos, como explicado abaixo.

O que a importação do Jira faz

Mais uma fonte para o backlog, ao lado do Linear, do GitHub Issues e do Notion.

Um projeto ou a sua própria JQL

Escolha um dos seus projetos na lista, com um campo de pesquisa quando há dezenas, e a consulta é preenchida para você. Ou escreva a JQL você mesmo: assignee = currentUser(), um sprint, um componente, uma etiqueta. Tudo o que o Jira consegue pesquisar, a importação consegue trazer.

Uma issue, pela chave

Só precisa da issue que acabaram de passar para você? Cole PROJ-123 ou o link do Jira com o botão de importação da coluna TODO. Ela chega sozinha, no topo da coluna, sem mexer na importação salva.

Descrições legíveis

O Jira guarda as descrições como documentos estruturados, não como texto. A importação as converte para Markdown (títulos, listas, blocos de código, tabelas, links), assim o agente lê a especificação como ela foi escrita, e não dados brutos.

Anexos que o agente consegue abrir

Os arquivos anexados à issue ficam atrás do seu login no Jira, então um link não serviria de nada para o agente. A importação os baixa no seu computador e os anexa ao ticket: capturas de tela, especificações em PDF, exportações.

Tipo e status que fazem sentido

Bug, Story, Task, Epic: os tipos de issue conhecidos viram o tipo do ticket, e o tipo do Jira fica como tag para manter o seu próprio vocabulário. O status segue a categoria que o Jira compartilha entre todos os fluxos de trabalho, então uma issue concluída chega como concluída.

Somente leitura, token na sua máquina

Só requisições de leitura chegam ao Jira. O token de API é criptografado no seu computador e nunca chega aos nossos servidores; só a consulta acompanha o projeto nas suas outras máquinas, onde você cola o token de novo.

Como funciona

Quatro passos. Os dois primeiros são feitos uma vez por máquina.

  1. 1

    Crie um token de API

    Na sua conta Atlassian, abra Segurança, depois Tokens de API, e crie um token. Use um token clássico: um token com escopo limitado pode fazer a lista de projetos voltar vazia.

  2. 2

    Conecte o seu site do Jira

    No backlog do projeto, clique em Importar tickets e escolha JIRA. Informe o endereço do seu site (só o nome da equipe já funciona), o seu e-mail da Atlassian e o token.

  3. 3

    Escolha e pré-visualize

    Escolha um projeto ou escreva uma consulta JQL e clique em Pré-visualizar. Pesquise a lista por chave ou por título, marque as issues que você quer e importe-as, até 500 de cada vez.

  4. 4

    Entregue cada ticket a um agente

    As issues agora são tickets em TODO, cada um com um link de volta para o Jira. Atribua um agente e um modelo, marque Programar num worktree separado para esta tarefa se quiser que ele tenha a própria branch, e arraste o ticket para In Progress. Atualizar sincroniza o quadro de novo mais tarde.

O que a Atlassian e as CLIs de agente já fazem por conta própria

A Atlassian tem um servidor MCP remoto oficial para Jira e Confluence, em https://mcp.atlassian.com/v2/mcp, com login OAuth. A Atlassian documenta claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp para o Claude Code, depois /mcp para fazer login, e codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp para o Codex. O agente então recebe ferramentas para pesquisar, ler, criar e atualizar issues de dentro da sessão.

O Jira também permite atribuir um item de trabalho a um agente pelo campo de responsável: os próprios agentes Rovo da Atlassian, e agentes conectados de outras plataformas, como o GitHub Copilot e o Cursor. O agente trabalha no item e informa o andamento ali, na plataforma que o executa, não num terminal do seu computador.

A importação do AgentsRoom atende a outra necessidade: as issues em um quadro, ao lado do resto dos seus tickets, com um agente por issue na sua própria máquina e na CLI que você escolher, incluindo as CLIs que não têm nenhuma integração com o Jira. Os dois não se excluem: importe as issues para planejar e executar o trabalho, e dê a um agente o servidor MCP da Atlassian quando ele precisar comentar ou mudar o status da issue por conta própria.

O que saber

  • Somente Jira Cloud. Jira Server e Data Center não são suportados.
  • Num sentido só: nada volta para o Jira, nem depois que o ticket é entregue aqui. Mude o status da issue você mesmo, ou dê ao agente o servidor MCP da Atlassian.
  • O token fica no computador que o conectou. Em outra máquina, o botão do quadro mostra Reconectar, com um selo JIRA não conectado, até você colar o token lá também.
  • Até 500 issues por importação, e até 10 arquivos anexados por issue, de 8 MB cada.
  • Prioridade, responsável, comentários, componentes, versões, link do épico e story points não são importados: o ticket leva o resumo, a descrição, o tipo, as etiquetas e os arquivos.
  • Conectar o Jira e montar a consulta são feitos no desktop. Pelo celular, você pode atualizar a importação ou trazer uma issue pela chave; as duas coisas rodam no seu computador, que precisa estar ligado.

Perguntas frequentes

É a mesma coisa que o servidor MCP da Atlassian?

Não. O servidor MCP da Atlassian dá a um agente ferramentas para ler e alterar o Jira de dentro da sessão, nas CLIs que suportam MCP. A importação do AgentsRoom traz as issues para o backlog do projeto antes que qualquer agente comece, para que você possa planejá-las, entregar cada uma a um agente diferente e acompanhá-las no quadro. Você pode usar os dois: a importação para organizar o trabalho, o servidor MCP para um agente que precise comentar ou fechar a sua issue.

O AgentsRoom atualiza a issue do Jira quando o agente termina?

Não. A importação só envia requisições de leitura: nenhuma transição, nenhum comentário, nenhum campo alterado. Quando o ticket é entregue aqui, você move a issue no Jira você mesmo, ou deixa um agente fazer isso pelo servidor MCP da Atlassian. Pedir só acesso de leitura é o que permite que a importação funcione com qualquer fluxo de trabalho, sejam quais forem as transições e condições.

Posso importar só as issues atribuídas a mim?

Sim, com JQL: assignee = currentUser() AND statusCategory != Done traz as suas issues abertas de todos os projetos que você consegue ver. Adicione project = ABC, um sprint ou uma etiqueta para restringir. A consulta fica salva com o projeto, então Atualizar a refaz mais tarde.

Posso trazer só a issue que acabaram de me atribuir?

Sim. Use o botão de importação da coluna TODO e cole a chave (PROJ-123) ou o link do Jira. Ela chega no topo de TODO sem mudar a importação salva, e pode ser atualizada sozinha mais tarde a partir do ticket.

O meu token de API do Jira sai do meu computador?

Não. Ele é guardado criptografado no computador que o conectou e nunca chega aos nossos servidores. Só a consulta de importação (o site e a JQL) fica salva na sua conta, para que a importação acompanhe o projeto nas suas outras máquinas, onde você cola o token de novo.

Quais CLIs de agente podem trabalhar numa issue do Jira importada?

Todas as 17 CLIs de agente que o AgentsRoom suporta (Claude, Codex, GitHub Copilot CLI, Cursor e outras 13). Uma issue importada é um ticket comum: roda no agente e no modelo que você atribuir a ela, no checkout compartilhado ou no próprio worktree git.

Funciona com Jira Server ou Data Center?

Hoje não. A importação conversa com a API REST do Jira Cloud usando um token de API da Atlassian, que o Jira Server e o Data Center não oferecem da mesma forma. Quem usa Jira auto-hospedado ainda pode dar a um agente um servidor MCP do Jira que suporte a sua instalação.

Você também pode gostar

Leve as suas issues do Jira aos seus agentes

Baixe o AgentsRoom, abra o seu repositório como projeto, clique em Importar tickets no backlog dele e escolha JIRA.

GrátisBaixar AgentsRoom

App complementar: acompanhe seus agentes em qualquer lugar

Use Claude, Codex, Antigravity CLI ou outro provedor de IA.

Instalar a extensão
Chrome Web Store

Envie bugs e pedidos direto para o seu backlog público.

Multi-projetos
Multi-provedor
Multi-agentes
Status ao vivo
Diff e commit
App mobile
Preview ao vivo
Equipes de agentes
Testes no navegador
Dev guiada por backlog
Biblioteca de prompts
Biblioteca de skills
Ver todas as funcionalidades