Automação Vercel via Rube MCP

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

Pré-requisitos

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

Fluxos de Trabalho Principais

1. Monitorar e Inspecionar Deployments

Quando usar: O usuário deseja listar, inspecionar ou depurar deployments.

Sequência de ferramentas:

1. VERCEL_LIST_ALL_DEPLOYMENTS ou VERCEL_GET_DEPLOYMENTS - Listar deployments com filtros [Obrigatório]
2. VERCEL_GET_DEPLOYMENT ou VERCEL_GET_DEPLOYMENT_DETAILS - Obter informações específicas de deployment [Opcional]
3. VERCEL_GET_DEPLOYMENT_LOGS ou VERCEL_GET_RUNTIME_LOGS - Visualizar logs de build/runtime [Opcional]
4. VERCEL_GET_DEPLOYMENT_EVENTS - Obter linha do tempo de eventos de deployment [Opcional]
5. VERCEL_LIST_DEPLOYMENT_CHECKS - Visualizar resultados de verificação de deployment [Opcional]

Parâmetros chave:

• projectId: Filtrar deployments por projeto
• state: Filtrar por estado do deployment (ex: 'READY', 'ERROR', 'BUILDING')
• limit: Número de deployments a retornar
• target: Filtrar por ambiente ('production', 'preview')
• deploymentId ou idOrUrl: Identificador específico do deployment

Armadilhas:

• IDs e URLs de deployment são aceitos como identificadores na maioria dos endpoints
• Logs de build e logs de runtime são separados; use a ferramenta apropriada
• VERCEL_GET_DEPLOYMENT_LOGS retorna logs de build; VERCEL_GET_RUNTIME_LOGS retorna logs de função serverless
• Eventos de deployment incluem transições de status e são úteis para depurar problemas de tempo

2. Criar e Gerenciar Deployments

Quando usar: O usuário deseja acionar um novo deployment.

Sequência de ferramentas:

1. VERCEL_LIST_PROJECTS - Encontrar o projeto de destino [Pré-requisito]
2. VERCEL_CREATE_NEW_DEPLOYMENT - Acionar um novo deployment [Obrigatório]
3. VERCEL_GET_DEPLOYMENT - Monitorar o progresso do deployment [Opcional]

Parâmetros chave:

• name: Nome do projeto para o deployment
• target: Destino do deployment ('production' ou 'preview')
• gitSource: Fonte do repositório Git com informações de ref/branch
• files: Array de objetos de arquivo para deployments baseados em arquivos

Armadilhas:

• gitSource ou files devem ser fornecidos, não ambos
• Deployments baseados em Git exigem integração adequada do repositório
• Deployments de produção atualizam o alias de domínio de produção automaticamente
• A criação de deployment é assíncrona; consulte com GET_DEPLOYMENT para o status

3. Gerenciar Variáveis de Ambiente

Quando usar: O usuário deseja adicionar, listar ou remover variáveis de ambiente para um projeto.

Sequência de ferramentas:

1. VERCEL_LIST_PROJECTS - Encontrar o ID do projeto [Pré-requisito]
2. VERCEL_LIST_ENV_VARIABLES - Listar variáveis de ambiente existentes [Obrigatório]
3. VERCEL_ADD_ENVIRONMENT_VARIABLE - Adicionar uma nova variável de ambiente [Opcional]
4. VERCEL_DELETE_ENVIRONMENT_VARIABLE - Remover uma variável de ambiente [Opcional]

Parâmetros chave:

• projectId: Identificador do projeto de destino
• key: Nome da variável de ambiente
• value: Valor da variável de ambiente
• target: Array de ambientes ('production', 'preview', 'development')
• type: Tipo de variável ('plain', 'secret', 'encrypted', 'sensitive')

Armadilhas:

• Nomes de variáveis de ambiente devem ser únicos por ambiente de destino
• Variáveis type: 'secret' não podem ser lidas após a criação; apenas o ID é retornado
• Excluir uma variável de ambiente requer tanto projectId quanto o id da variável de ambiente (não o nome da chave)
• Alterações exigem um novo deployment para terem efeito

4. Gerenciar Domínios e DNS

Quando usar: O usuário deseja configurar domínios personalizados ou gerenciar registros DNS.

Sequência de ferramentas:

1. VERCEL_GET_DOMAIN - Verificar status e configuração do domínio [Obrigatório]
2. VERCEL_GET_DOMAIN_CONFIG - Obter detalhes de configuração de DNS/SSL [Opcional]
3. VERCEL_LIST_PROJECT_DOMAINS - Listar domínios anexados a um projeto [Opcional]
4. VERCEL_GET_DNS_RECORDS - Listar registros DNS para um domínio [Opcional]
5. VERCEL_CREATE_DNS_RECORD - Adicionar um novo registro DNS [Opcional]
6. VERCEL_UPDATE_DNS_RECORD - Modificar um registro DNS existente [Opcional]

…