Automação do Jira via Rube MCP

Automatize operações do Jira através do kit de ferramentas Jira da Composio via Rube MCP.

Pré-requisitos

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

Configuração

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

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas 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 se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Pesquisar e Filtrar Issues

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

Sequência de ferramentas:

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

Parâmetros chave:

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

Armadilhas:

• Os nomes dos campos JQL diferenciam maiúsculas de minúsculas e devem corresponder à configuração do Jira
• Campos personalizados usam IDs como customfield_10001, não nomes de exibição
• Os resultados são paginados; verifique total vs startAt + maxResults para continuar

2. Criar e Editar Issues

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

Sequência de ferramentas:

1. JIRA_GET_ALL_PROJECTS - Listar projetos para encontrar a 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 chave:

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

Armadilhas:

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

3. Gerenciar Sprints e Boards

Quando usar: O usuário deseja trabalhar com quadros ágeis, sprints e backlogs

Sequência de ferramentas:

1. JIRA_LIST_BOARDS - Listar todos os quadros [Pré-requisito]
2. JIRA_LIST_SPRINTS - Listar sprints de um quadro [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 chave:

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

Armadilhas:

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

4. Gerenciar Comentários

Quando usar: O usuário deseja 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 um comentário a uma issue [Obrigatório]

Parâmetros chave:

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

Armadilhas:

• Comentários suportam ADF (Formato de Documento Atlassian) 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 deseja 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 de projeto [Opcional]
5. JIRA_ADD_USERS_TO_PROJECT_ROLE - Adicionar usuário a uma função [Opcional]

Parâmetros chave:

• 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 e-mail ou nome de exibição)
• Funções de projeto diferem de permissões globais

Padrões Comuns

Sintaxe JQL

Operadores comuns:

…