Automação do GitLab via Rube MCP

Automatize operações do GitLab, incluindo gerenciamento de projetos, rastreamento de issues, fluxos de trabalho de merge requests, monitoramento de pipelines CI/CD, gerenciamento de branches e administração de usuários através do toolkit GitLab da Composio.

Pré-requisitos

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

Configuração

Obter 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 toolkit gitlab
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do GitLab
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Gerenciar Issues

Quando usar: O usuário deseja criar, atualizar, listar ou pesquisar issues em um projeto do GitLab

Sequência de ferramentas:

1. GITLAB_GET_PROJECTS - Encontre o projeto de destino e obtenha seu ID [Pré-requisito]
2. GITLAB_LIST_PROJECT_ISSUES - Liste e filtre issues de um projeto [Obrigatório]
3. GITLAB_CREATE_PROJECT_ISSUE - Crie uma nova issue [Obrigatório para criação]
4. GITLAB_UPDATE_PROJECT_ISSUE - Atualize uma issue existente (título, rótulos, estado, atribuídos) [Obrigatório para atualização]
5. GITLAB_LIST_PROJECT_USERS - Encontre IDs de usuário para atribuição [Opcional]

Parâmetros chave:

• id: ID do projeto (inteiro) ou caminho codificado em URL (ex: "my-group/my-project")
• title: Título da issue (obrigatório para criação)
• description: Texto do corpo da issue (máximo de 1.048.576 caracteres)
• labels: Nomes de rótulos separados por vírgula (ex: "bug,critical")
• add_labels / remove_labels: Adicione ou remova rótulos sem substituir todos
• state: Filtre por "all", "opened" ou "closed"
• state_event: "close" ou "reopen" para alterar o estado da issue
• assignee_ids: Array de IDs de usuário; use [0] para desatribuir todos
• issue_iid: ID interno da issue dentro do projeto (obrigatório para atualizações)
• milestone: Filtre por título de marco
• search: Pesquise no título e na descrição
• scope: "created_by_me", "assigned_to_me" ou "all"
• page / per_page: Paginação (padrão per_page: 20)

Armadilhas:

• id aceita ID de projeto inteiro ou caminho codificado em URL; IDs incorretos geram erros 4xx
• issue_iid é o ID interno do projeto (mostrado como #42), diferente do ID global da issue
• Rótulos no campo labels substituem TODOS os rótulos existentes; use add_labels/remove_labels para alterações incrementais
• Definir assignee_ids como um array vazio NÃO desatribui; use [0] em vez disso
• O campo updated_at requer direitos de administrador ou proprietário de projeto/grupo

2. Gerenciar Merge Requests

Quando usar: O usuário deseja listar, filtrar ou revisar merge requests em um projeto

Sequência de ferramentas:

1. GITLAB_GET_PROJECT - Obtenha detalhes do projeto e verifique o acesso [Pré-requisito]
2. GITLAB_GET_PROJECT_MERGE_REQUESTS - Liste e filtre merge requests [Obrigatório]
3. GITLAB_GET_REPOSITORY_BRANCHES - Verifique branches de origem/destino [Opcional]
4. GITLAB_LIST_ALL_PROJECT_MEMBERS - Encontre revisores/atribuídos [Opcional]

Parâmetros chave:

• id: ID do projeto ou caminho codificado em URL
• state: "opened", "closed", "locked", "merged" ou "all"
• scope: "created_by_me" (padrão), "assigned_to_me" ou "all"
• source_branch / target_branch: Filtre por nomes de branch
• author_id / author_username: Filtre por autor do MR
• assignee_id: Filtre por atribuído (use None para não atribuídos, Any para atribuídos)
• reviewer_id / reviewer_username: Filtre por revisor
• labels: Filtro de rótulos separados por vírgula
• search: Pesquise no título e na descrição
• wip: "yes" para MRs em rascunho, "no" para não rascunhos
• order_by: "created_at" (padrão), "title", "merged_at", "updated_at"
• view: "simple" para campos mínimos
• iids[]: Filtre por IDs internos específicos de MR

Armadilhas:

• O padrão scope é "created_by_me", que limita os resultados; use "all" para listagens completas
• author_id e author_username são mutuamente exclusivos
• reviewer_id e reviewer_username são mutuamente exclusivos
• O filtro approved requer o flag de recurso mr_approved_filter (desabilitado por padrão)
• Históricos grandes de MR podem ser confusos; use filtros e valores moderados de per_page

3. Gerenciar Projetos e Repositórios

…