Automação do Bitbucket via Rube MCP

Automatize operações do Bitbucket, incluindo gerenciamento de repositórios, fluxos de trabalho de pull request, operações de branch, rastreamento de issues e administração de workspaces através do toolkit Bitbucket da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Bitbucket via RUBE_MANAGE_CONNECTIONS com o toolkit bitbucket
• 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 bitbucket
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Bitbucket
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Gerenciar Pull Requests

Quando usar: O usuário deseja criar, revisar ou inspecionar pull requests

Sequência de ferramentas:

1. BITBUCKET_LIST_WORKSPACES - Descobrir workspaces acessíveis [Pré-requisito]
2. BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE - Encontrar o repositório de destino [Pré-requisito]
3. BITBUCKET_LIST_BRANCHES - Verificar se as branches de origem e destino existem [Pré-requisito]
4. BITBUCKET_CREATE_PULL_REQUEST - Criar um novo PR com título, branch de origem e revisores opcionais [Obrigatório]
5. BITBUCKET_LIST_PULL_REQUESTS - Listar PRs filtrados por estado (ABERTO, MESCLADO, RECUSADO) [Opcional]
6. BITBUCKET_GET_PULL_REQUEST - Obter detalhes completos de um PR específico por ID [Opcional]
7. BITBUCKET_GET_PULL_REQUEST_DIFF - Buscar diff unificado para revisão de código [Opcional]
8. BITBUCKET_GET_PULL_REQUEST_DIFFSTAT - Obter arquivos alterados com linhas adicionadas/removidas [Opcional]

Parâmetros chave:

• workspace: Slug ou UUID do workspace (obrigatório para todas as operações)
• repo_slug: Nome do repositório amigável para URL
• source_branch: Branch com alterações a serem mescladas
• destination_branch: Branch de destino (usa a branch principal do repositório como padrão se omitido)
• reviewers: Lista de objetos com o campo uuid para atribuição de revisores
• state: Filtro para LIST_PULL_REQUESTS - OPEN, MERGED ou DECLINED
• max_chars: Limite de truncamento para GET_PULL_REQUEST_DIFF para lidar com diffs grandes

Armadilhas:

• reviewers espera um array de objetos com a chave uuid, NÃO nomes de usuário: [{"uuid": "{...}"}]
• O formato do UUID deve incluir chaves: {123e4567-e89b-12d3-a456-426614174000}
• destination_branch usa como padrão a branch principal do repositório se omitido, o que pode não ser main
• pull_request_id é um inteiro para operações GET/DIFF, mas retorna como parte da listagem de PR
• Diffs grandes podem sobrecarregar o contexto; sempre defina max_chars (por exemplo, 50000) em GET_PULL_REQUEST_DIFF

2. Gerenciar Repositórios e Workspaces

Quando usar: O usuário deseja listar, criar ou excluir repositórios ou explorar workspaces

Sequência de ferramentas:

1. BITBUCKET_LIST_WORKSPACES - Listar todos os workspaces acessíveis [Obrigatório]
2. BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE - Listar repos com filtragem BBQL opcional [Obrigatório]
3. BITBUCKET_CREATE_REPOSITORY - Criar um novo repo com configurações de linguagem, privacidade e projeto [Opcional]
4. BITBUCKET_DELETE_REPOSITORY - Excluir permanentemente um repositório (irreversível) [Opcional]
5. BITBUCKET_LIST_WORKSPACE_MEMBERS - Listar membros para atribuição de revisores ou verificações de acesso [Opcional]

Parâmetros chave:

• workspace: Slug do workspace (encontrado via LIST_WORKSPACES)
• repo_slug: Nome amigável para URL para criar/excluir
• q: Filtro de consulta BBQL (por exemplo, name~"api", project.key="PROJ", is_private=true)
• role: Filtrar repos por função do usuário: member, contributor, admin, owner
• sort: Campo de ordenação com prefixo - opcional para decrescente (por exemplo, -updated_on)
• is_private: Booleano para visibilidade do repositório (usa como padrão true)
• project_key: Chave do projeto Bitbucket; omitir para usar o projeto mais antigo do workspace

Armadilhas:

• BITBUCKET_DELETE_REPOSITORY é irreversível e não afeta forks
• Valores de string BBQL DEVEM ser colocados entre aspas duplas: name~"my-repo" e não name~my-repo
• repository NÃO é um campo BBQL válido; use name em vez disso
• A paginação padrão é de 10 resultados; defina pagelen explicitamente para listagens completas
• CREATE_REPOSITORY usa como padrão privado; defina is_private: false para repositórios públicos

3. Gerenciar Issues

Quando usar: O usuário deseja criar, atualizar, listar ou comentar em issues de repositório

Sequência de ferramentas:

…