Jira

Com a integração do Cursor com o Jira, você pode usar agentes na nuvem para trabalhar em itens de trabalho do Jira, atribuindo-os ao Cursor ou mencionando @Cursor no Jira.

Introdução

Requisitos

Antes de instalar a integração do Jira, verifique se você tem:

• Jira Commercial Cloud com o Rovo habilitado
• Acesso de administrador ao site do Jira onde deseja instalar o app
• Acesso de administrador do Cursor à equipe que deseja conectar
• GitHub, GitLab, Azure DevOps ou Bitbucket conectado ao Cursor para acesso ao repositório e pull requests

Instalação

1. Como administrador do Cursor, acesse Integrações do Cursor

2. Clique em Conectar ao lado do Jira

3. Acesse a página do app Cursor no Atlassian Marketplace

4. Clique em Obter agora

5. Selecione o site do Jira em que deseja instalar o Cursor e clique em Revisar

6. Revise o app e clique em Obter agora

7. Após a conclusão da instalação, você será direcionado à página de configuração do app Cursor para Jira. Aguarde alguns minutos para que a Atlassian nos notifique sobre a instalação e clique no botão Conectar ao Cursor.

8. Conecte o site do Jira à sua equipe do Cursor

   • Se quiser habilitar a autenticação no nível do usuário (que oferece aos membros da equipe mais visibilidade e controle sobre seus agentes) em vez de executar agentes com uma conta de serviço, ative a opção Exigir autenticação individual.

9. Conclua as configurações restantes do agente em nuvem no Cursor:

   • Conecte o GitHub, GitLab, Azure DevOps ou Bitbucket
   • Habilite a precificação baseada em uso
   • Confirme as configurações de privacidade
   • Escolha um repositório, modelo e branch base padrão (nas configurações de agente na nuvem no dashboard do Cursor)

10. Volte ao Jira e comece a usar o Cursor em um item de trabalho

    • Se você habilitou a autenticação no nível do usuário, cada usuário precisará concluir configurações adicionais abaixo

Modo de autenticação

Você pode escolher como o Jira autentica os agentes em nuvem no painel de administração da integração do Cursor com o Jira ativando a opção Exigir autenticação individual.

Para conectar cada usuário:

1. Inicie um agente em um item de trabalho do Jira
2. Será exibido um aviso para conectar a conta
3. Siga o link para conectar a conta do Jira a uma conta do Cursor associada à equipe
4. Conclua as configurações restantes do agente em nuvem no Cursor:
   • Conecte o GitHub, GitLab, Azure DevOps ou Bitbucket caso ainda não tenha conectado um provedor de repositório
   • Escolha um repositório padrão, um modelo e uma branch base (nas configurações de agente na nuvem em Minhas configurações no dashboard do Cursor)

Como usar

Abra um item de trabalho no Jira e atribua-o ao Cursor ou mencione @Cursor em um comentário. O Cursor usa o título, a descrição, os comentários e as configurações disponíveis do repositório para iniciar um agente em nuvem.

Você pode pedir ao Cursor para corrigir bugs, adicionar funcionalidades, atualizar testes ou investigar uma tarefa descrita no item de trabalho.

Delegar itens de trabalho

Atribua um item de trabalho do Jira ao Cursor quando o ticket já descrever claramente a tarefa.

1. Abra o item de trabalho do Jira
2. Clique no campo de responsável
3. Selecione Cursor
4. Revise o agente em nuvem iniciado a partir do item de trabalho

Mencione o Cursor

Mencione @Cursor em um comentário no Jira quando quiser adicionar instruções específicas. Você pode incluir um repositório, uma branch ou um modelo no mesmo comentário.

Exemplos:

• @Cursor investigue esta regressão
• @Cursor repo=acme/backend branch=release corrija isso antes do corte da release
• @Cursor model=gpt-5.6-sol e atualize os testes relacionados

Instruções de acompanhamento

Abra o chat do Rovo a partir do item de trabalho do Jira para continuar a conversa com o Cursor.

Atualizações de status e repasse

Quando um agente em nuvem é iniciado, o Jira mostra o status do agente no item de trabalho. O Cursor publica atualizações de progresso enquanto trabalha e retorna um resumo quando a tarefa é concluída.

Se o Cursor abrir um pull request, a atualização de conclusão inclui um link para o PR para revisão.

Configuração

Gerencie as configurações padrão e as opções de privacidade no Dashboard -> agentes na nuvem, em Configurações da equipe ou Minhas configurações.

Configurações

Modelo padrão

Usado quando nenhum modelo é especificado no item de trabalho ou comentário do Jira. Consulte as configurações para ver as opções disponíveis.

Seleção de repositório

O Cursor seleciona o repositório com base em:

1. Valores explícitos: valores de repo, branch ou model no comentário ou item de trabalho do Jira
2. Conteúdo do item de trabalho: nomes de repositórios, serviços ou palavras-chave no título, na descrição e nos comentários
3. Regras de roteamento: mapeamentos personalizados de palavras-chave para repositórios
4. Atividade recente do agente: repositórios que você usou recentemente
5. Repositório padrão: usado como alternativa quando nenhuma correspondência é encontrada

Para usar um repositório específico, inclua-o no comentário. Por exemplo: @Cursor repo=acme/mobile-app fix the login bug. A conta de serviço da sua equipe ou sua conta de usuário, dependendo do modo ativado, deve ter acesso a este repositório. Caso contrário, não será possível iniciar um Cloud Agent.

Branch de base

Branch inicial do agente em nuvem. Deixe em branco para usar a branch padrão do repositório (recomendado).

Prefixo da branch

Prefixo para nomes de branches criadas por agentes na nuvem.

Opções

Personalize o comportamento do agente em nuvem ao usar menções com @Cursor usando estas opções:

Regras de roteamento

As regras de roteamento permitem definir palavras-chave que mapeiam automaticamente para repositórios específicos. Quando um item de trabalho ou comentário do Jira contém determinadas palavras-chave, o Cursor roteia o agente em nuvem para o repositório associado.

Com as regras de roteamento, você informa ao agente quais projetos, itens de trabalho, palavras-chave e outros dados determinam quais repositórios serão usados para cada item de trabalho.

Configurar regras de roteamento

1. Acesse Dashboard -> agentes na nuvem
2. Localize a seção Regras de roteamento
3. Adicione mapeamentos de palavras-chave para repositórios

Exemplos de regras

Com essas regras configuradas:

• Um item de trabalho com o título Fix the frontend nav bug é roteado para acme/web-app
• Um comentário com o texto @Cursor update the mobile onboarding flow é roteado para acme/mobile-app
• Um comentário com o texto @Cursor add rate limiting to the api é roteado para acme/backend-services

Como funciona o roteamento

O Cursor avalia os itens de trabalho e os comentários do Jira nesta ordem:

1. Valores explícitos: valores de repo, branch ou model no comentário ou no item de trabalho do Jira
2. Conteúdo do item de trabalho: nomes de repositórios, nomes de serviços ou palavras-chave no título, na descrição e nos comentários
3. Regras de roteamento: mapeamentos personalizados de palavras-chave para repositórios
4. Atividade recente do agente: repositórios usados recentemente
5. Repositório padrão: usado quando nenhuma correspondência é encontrada

Privacidade

Os agentes na nuvem oferecem suporte ao Privacy Mode.

Saiba mais sobre o Privacy Mode ou gerencie suas configurações de privacidade.

Permissões

Durante a instalação, o Jira mostra as permissões solicitadas pelo app Cursor. O Cursor usa essas permissões para:

• Identificar o usuário do Jira que inicia ou gerencia um agente em nuvem
• Ler campos, descrições, comentários e contexto relacionado de itens de trabalho
• Publicar atualizações de status, resumos de conclusão e links de pull requests
• Receber eventos quando itens de trabalho são atribuídos ao Cursor ou mencionam @Cursor

Revise a solicitação de permissões no Atlassian Marketplace antes de instalar o app.

Perguntas frequentes

Quais sites do Jira são compatíveis?

A integração do Cursor com o Jira oferece suporte a sites da nuvem comercial da Atlassian com o Rovo habilitado. As instâncias HIPAA, FedRAMP e Government Cloud da Atlassian não são compatíveis.

Preciso ativar o faturamento por uso?

Sim. Os agentes na nuvem exigem faturamento por uso. Ative o faturamento por uso ao concluir a configuração do agente em nuvem no Cursor.

Quem pode instalar a integração com o Jira?

Um usuário que seja administrador do Jira e da equipe do Cursor precisará realizar a configuração inicial.

Os usuários precisam conectar suas próprias contas do Cursor?

Depende do modo de autenticação escolhido. A autenticação com conta de serviço executa todos os agentes na nuvem usando uma conta de serviço e as configurações da equipe. A autenticação no nível do usuário conecta cada usuário do Jira ao Cursor, permite que localizem no dashboard do Cursor os agentes na nuvem em execução no Jira e usa as configurações de cada usuário para roteamento, modelos, repositórios e valores padrão.

O que mais precisa ser configurado antes que o Cursor possa criar PRs?

Conecte o GitHub, GitLab, Azure DevOps ou Bitbucket ao Cursor e verifique se as configurações do agente em nuvem incluem os repositórios, modelos e branches de base que sua equipe deseja usar.

Como os usuários continuam uma conversa com o Cursor?

Abra o chat do Rovo a partir do item de trabalho do Jira para continuar a conversa com o Cursor. Como alternativa, abra o agente na nuvem no Cursor e continue a conversa por lá.

Aviso

O Cursor pode cometer erros. Revise o código e as respostas.

Política de Privacidade

Para saber como o Cursor coleta, usa e protege seus dados, consulte nossa Política de Privacidade.