Jira Automation

Automação do Jira via Rube MCP

Automatize operações do Jira através do toolkit Jira do Composio via Rube MCP.

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do Jira via RUBE_MANAGE_CONNECTIONS com toolkit jira
• Sempre chamar RUBE_SEARCH_TOOLS primeiro para obter esquemas atuais de ferramentas

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como servidor MCP na configuração do seu cliente. Nenhuma chave de API necessária — basta adicionar o endpoint e funcionará.

1. Verifique se Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com toolkit jira
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Jira
4. Confirme que o status da conexão mostra ATIVA antes de executar qualquer workflow

Workflows Principais

1. Pesquisar e Filtrar Issues

Quando usar: O usuário quer encontrar issues usando JQL ou navegar issues do projeto

Sequência de ferramentas:

1. JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST - Pesquisar com query JQL [Obrigatório]
2. JIRA_GET_ISSUE - Obter detalhes completos de uma issue específica [Opcional]

Parâmetros principais:

• jql: String de query JQL (ex: project = PROJ AND status = "In Progress")
• maxResults: Máximo de resultados por página (padrão 50, máximo 100)
• startAt: Offset de paginação
• fields: Array de nomes de campos a retornar
• issueIdOrKey: Chave de issue como 'PROJ-123' para GET_ISSUE

Armadilhas:

• Nomes de campos JQL são case-sensitive e devem corresponder à configuração do Jira
• Campos personalizados usam IDs como customfield_10001, não nomes de exibição
• Resultados são paginados; verifique total vs startAt + maxResults para continuar

2. Criar e Editar Issues

Quando usar: O usuário quer criar novas issues ou atualizar as existentes

Sequência de ferramentas:

1. JIRA_GET_ALL_PROJECTS - Listar projetos para encontrar chave do projeto [Pré-requisito]
2. JIRA_GET_FIELDS - Obter campos disponíveis e seus IDs [Pré-requisito]
3. JIRA_CREATE_ISSUE - Criar uma nova issue [Obrigatório]
4. JIRA_EDIT_ISSUE - Atualizar campos em uma issue existente [Opcional]
5. JIRA_ASSIGN_ISSUE - Atribuir issue a um usuário [Opcional]

Parâmetros principais:

• project: Chave do projeto (ex: 'PROJ')
• issuetype: Nome do tipo de issue (ex: 'Bug', 'Story', 'Task')
• summary: Título da issue
• description: Descrição da issue (Atlassian Document Format ou texto simples)
• issueIdOrKey: Chave de issue para edições

Armadilhas:

• Tipos de issue e campos obrigatórios variam por projeto; use GET_FIELDS para verificar
• Campos personalizados requerem IDs de campo exatos, não nomes de exibição
• Descrição pode precisar de Atlassian Document Format (ADF) para conteúdo rico

3. Gerenciar Sprints e Boards

Quando usar: O usuário quer trabalhar com boards ágeis, sprints e backlogs

Sequência de ferramentas:

1. JIRA_LIST_BOARDS - Listar todos os boards [Pré-requisito]
2. JIRA_LIST_SPRINTS - Listar sprints para um board [Obrigatório]
3. JIRA_MOVE_ISSUE_TO_SPRINT - Mover issue para um sprint [Opcional]
4. JIRA_CREATE_SPRINT - Criar um novo sprint [Opcional]

Parâmetros principais:

• boardId: ID do board de LIST_BOARDS
• sprintId: ID do sprint para operações de movimento
• name: Nome do sprint para criação
• startDate/endDate: Datas do sprint em formato ISO

Armadilhas:

• Boards e sprints são específicos do Jira Software (não Jira Core)
• Apenas um sprint pode estar ativo por vez por board

4. Gerenciar Comentários

Quando usar: O usuário quer adicionar ou visualizar comentários em issues

Sequência de ferramentas:

1. JIRA_LIST_ISSUE_COMMENTS - Listar comentários existentes [Opcional]
2. JIRA_ADD_COMMENT - Adicionar comentário a uma issue [Obrigatório]

Parâmetros principais:

• issueIdOrKey: Chave de issue como 'PROJ-123'
• body: Corpo do comentário (suporta ADF para texto formatado)

Armadilhas:

• Comentários suportam ADF (Atlassian Document Format) para formatação
• Menções usam IDs de conta, não nomes de usuário

5. Gerenciar Projetos e Usuários

Quando usar: O usuário quer listar projetos, encontrar usuários ou gerenciar funções de projeto

Sequência de ferramentas:

1. JIRA_GET_ALL_PROJECTS - Listar todos os projetos [Opcional]
2. JIRA_GET_PROJECT - Obter detalhes do projeto [Opcional]
3. JIRA_FIND_USERS / JIRA_GET_ALL_USERS - Pesquisar usuários [Opcional]
4. JIRA_GET_PROJECT_ROLES - Listar funções do projeto [Opcional]
5. JIRA_ADD_USERS_TO_PROJECT_ROLE - Adicionar usuário a função [Opcional]

Parâmetros principais:

• projectIdOrKey: Chave do projeto
• query: Texto de pesquisa para FIND_USERS
• roleId: ID da função para operações de função

Armadilhas:

• Operações de usuário usam IDs de conta (não email ou nome de exibição)
• Funções de projeto diferem de permissões globais

Padrões Comuns

Sintaxe JQL

Operadores comuns:

• project = "PROJ" - Filtrar por projeto
• status = "In Progress" - Filtrar por status
• assignee = currentUser() - Issues do usuário atual
• created >= -7d - Criado nos últimos 7 dias
• labels = "bug" - Filtrar por label
• priority = High - Filtrar por prioridade
• ORDER BY created DESC - Ordenar resultados

Combinadores:

• AND - Ambas as condições
• OR - Uma ou outra condição
• NOT - Negar condição

Paginação

• Use parâmetros startAt e maxResults
• Verifique total na resposta para determinar páginas restantes
• Continue até startAt + maxResults >= total

Armadilhas Conhecidas

Nomes de Campos:

• Campos personalizados usam IDs como customfield_10001
• Use JIRA_GET_FIELDS para descobrir IDs e nomes de campos
• Nomes de campos em JQL podem diferir de nomes de campos de API

Autenticação:

• Jira Cloud usa IDs de conta, não nomes de usuário
• URL do site deve estar configurada corretamente na conexão

Referência Rápida

Quando Usar

Esta skill é aplicável para executar o workflow ou ações descritas na visão geral.