Automação de Renderização via Rube MCP

Automatize operações da plataforma Render Cloud através do toolkit Render da Composio via Rube MCP.

Pré-requisitos

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

Fluxos de Trabalho Principais

1. Listar e Navegar por Serviços

Quando usar: O usuário deseja encontrar ou inspecionar serviços Render (serviços web, sites estáticos, workers, jobs cron).

Sequência de ferramentas:

1. RENDER_LIST_SERVICES - Lista todos os serviços com filtros opcionais [Obrigatório]

Parâmetros chave:

• name: Filtra serviços por substring do nome.
• type: Filtra por tipo de serviço ('web_service', 'static_site', 'private_service', 'background_worker', 'cron_job').
• limit: Número máximo de resultados por página (padrão 20, máximo 100).
• cursor: Cursor de paginação da resposta anterior.

Armadilhas:

• Os tipos de serviço devem corresponder exatamente aos valores do enum: 'web_service', 'static_site', 'private_service', 'background_worker', 'cron_job'.
• A paginação usa uma abordagem baseada em cursor; siga cursor até que ele esteja ausente.
• O filtro de nome é baseado em substring, não em correspondência exata.
• IDs de serviço seguem o formato 'srv-xxxxxxxxxxxx'.
• O limite padrão é 20; defina um valor maior para listagem abrangente.

2. Disparar Implantações

Quando usar: O usuário deseja implantar ou reimplantar manualmente um serviço.

Sequência de ferramentas:

1. RENDER_LIST_SERVICES - Encontra o serviço a ser implantado [Pré-requisito].
2. RENDER_TRIGGER_DEPLOY - Dispara uma nova implantação [Obrigatório].
3. RENDER_RETRIEVE_DEPLOY - Monitora o progresso da implantação [Opcional].

Parâmetros chave:

• Para TRIGGER_DEPLOY:
  • serviceId: ID do serviço a ser implantado (obrigatório, formato: 'srv-xxxxxxxxxxxx').
  • clearCache: Define true para limpar o cache de build antes de implantar.
• Para RETRIEVE_DEPLOY:
  • serviceId: ID do serviço.
  • deployId: ID da implantação da resposta do gatilho (formato: 'dep-xxxxxxxxxxxx').

Armadilhas:

• serviceId é obrigatório; resolva primeiro via LIST_SERVICES.
• IDs de serviço começam com o prefixo 'srv-'.
• IDs de implantação começam com o prefixo 'dep-'.
• clearCache: true força um build limpo; leva mais tempo, mas resolve problemas relacionados ao cache.
• A implantação é assíncrona; use RETRIEVE_DEPLOY para consultar o status.
• Disparar uma implantação enquanto outra está em andamento pode colocar a nova em fila.

3. Monitorar Status de Implantação

Quando usar: O usuário deseja verificar o progresso ou o resultado de uma implantação.

Sequência de ferramentas:

1. RENDER_RETRIEVE_DEPLOY - Obtém detalhes e status da implantação [Obrigatório].

Parâmetros chave:

• serviceId: ID do serviço (obrigatório).
• deployId: ID da implantação (obrigatório).
• A resposta inclui status, createdAt, updatedAt, finishedAt, commit.

Armadilhas:

• Ambos serviceId e deployId são obrigatórios.
• Os status de implantação incluem: 'created', 'build_in_progress', 'update_in_progress', 'live', 'deactivated', 'build_failed', 'update_failed', 'canceled'.
• 'live' indica implantação bem-sucedida.
• 'build_failed' ou 'update_failed' indicam erros de implantação.
• Consulte em intervalos razoáveis (10-30 segundos) para evitar limites de taxa.

4. Gerenciar Projetos

Quando usar: O usuário deseja listar e organizar projetos Render.

Sequência de ferramentas:

1. RENDER_LIST_PROJECTS - Lista todos os projetos [Obrigatório].

Parâmetros chave:

• limit: Número máximo de resultados por página (máximo 100).
• cursor: Cursor de paginação da resposta anterior.

Armadilhas:

• Projetos agrupam serviços relacionados.
• A paginação usa uma abordagem baseada em cursor.
• IDs de projeto são usados para fins organizacionais.
• Nem todos os serviços podem ser atribuídos a um projeto.

Padrões Comuns

Resolução de ID

Nome do serviço -> ID do serviço:

1. Call RENDER_LIST_SERVICES with name=service_name
2. Find service by name in results
3. Extract id (format: 'srv-xxxxxxxxxxxx')

Pesquisa de implantação:

1. Store deployId from RENDER_TRIGGER_DEPLOY response
2. Call RENDER_RETRIEVE_DEPLOY with serviceId and deployId
3. Check status for completion

Padrão de Implantação e Monitoramento

1. RENDER_LIST_SERVICES -> encontrar serviço por nome -> obter serviceId

…