Automação do CircleCI via Rube MCP

Automatize operações de CI/CD do CircleCI através do toolkit CircleCI da Composio via Rube MCP.

Pré-requisitos

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

Fluxos de Trabalho Principais

1. Disparar um Pipeline

Quando usar: O usuário deseja iniciar uma nova execução de pipeline de CI/CD

Sequência de ferramentas:

1. CIRCLECI_TRIGGER_PIPELINE - Dispara um novo pipeline em um projeto [Obrigatório]
2. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - Monitora os fluxos de trabalho resultantes [Opcional]

Parâmetros chave:

• project_slug: Identificador do projeto no formato gh/org/repo ou bb/org/repo
• branch: Branch Git para executar o pipeline
• tag: Tag Git para executar o pipeline (mutuamente exclusiva com branch)
• parameters: Pares chave-valor de parâmetros do pipeline

Armadilhas:

• O formato de project_slug é {vcs}/{org}/{repo} (por exemplo, gh/myorg/myrepo)
• branch e tag são mutuamente exclusivos; fornecer ambos causa um erro
• Os parâmetros do pipeline devem corresponder aos definidos em .circleci/config.yml
• O disparo retorna um ID de pipeline; os fluxos de trabalho iniciam assincronamente

2. Monitorar Pipelines e Fluxos de Trabalho

Quando usar: O usuário deseja verificar o status de pipelines ou fluxos de trabalho

Sequência de ferramentas:

1. CIRCLECI_LIST_PIPELINES_FOR_PROJECT - Lista pipelines recentes para um projeto [Obrigatório]
2. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - Lista fluxos de trabalho dentro de um pipeline [Obrigatório]
3. CIRCLECI_GET_PIPELINE_CONFIG - Visualiza a configuração do pipeline utilizada [Opcional]

Parâmetros chave:

• project_slug: Identificador do projeto no formato {vcs}/{org}/{repo}
• pipeline_id: UUID de um pipeline específico
• branch: Filtra pipelines por nome de branch
• page_token: Cursor de paginação para a próxima página de resultados

Armadilhas:

• IDs de pipeline são UUIDs, não IDs numéricos
• Fluxos de trabalho herdam o ID do pipeline; um único pipeline pode ter múltiplos fluxos de trabalho
• Estados de fluxo de trabalho incluem: success, running, not_run, failed, error, failing, on_hold, canceled, unauthorized
• page_token é retornado nas respostas para paginação; continue até que esteja ausente

3. Inspecionar Detalhes do Job

Quando usar: O usuário deseja detalhar os detalhes de execução de um job específico

Sequência de ferramentas:

1. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - Encontra o fluxo de trabalho que contém o job [Pré-requisito]
2. CIRCLECI_GET_JOB_DETAILS - Obtém informações detalhadas do job [Obrigatório]

Parâmetros chave:

• project_slug: Identificador do projeto
• job_number: Número numérico do job (não UUID)

Armadilhas:

• Números de job são inteiros, não UUIDs (ao contrário dos IDs de pipeline e fluxo de trabalho)
• Detalhes do job incluem tipo de executor, paralelismo, horários de início/fim e status
• Status de job: success, running, not_run, failed, retried, timedout, infrastructure_fail, canceled

4. Recuperar Artefatos de Build

Quando usar: O usuário deseja baixar ou listar artefatos produzidos por um job

Sequência de ferramentas:

1. CIRCLECI_GET_JOB_DETAILS - Confirma que o job foi concluído com sucesso [Pré-requisito]
2. CIRCLECI_GET_JOB_ARTIFACTS - Lista todos os artefatos do job [Obrigatório]

Parâmetros chave:

• project_slug: Identificador do projeto
• job_number: Número numérico do job

Armadilhas:

• Artefatos só estão disponíveis após a conclusão do job
• Cada artefato tem um path e url para download
• URLs de artefatos podem exigir cabeçalhos de autenticação para download
• Artefatos grandes podem ter limites de tamanho de download

5. Revisar Resultados de Teste

Quando usar: O usuário deseja verificar os resultados de testes para um job específico

Sequência de ferramentas:

1. CIRCLECI_GET_JOB_DETAILS - Verifica se o job executou testes [Pré-requisito]
2. CIRCLECI_GET_TEST_METADATA - Recupera resultados e metadados de teste [Obrigatório]

Parâmetros chave:

• project_slug: Identificador do projeto
• job_number: Número numérico do job

Armadilhas:

• Metadados de teste exigem que o job tenha carregado resultados de teste (formato JUnit XML)
• Se nenhum resultado de teste foi carregado, a resposta estará vazia

…