Automação do Amplitude via Rube MCP

Automatize a análise de produtos do Amplitude através do toolkit Amplitude do Composio via Rube MCP.

Pré-requisitos

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

Fluxos de Trabalho Principais

1. Enviar Eventos

Quando usar: O usuário deseja rastrear eventos ou enviar dados de eventos para o Amplitude

Sequência de ferramentas:

1. AMPLITUDE_SEND_EVENTS - Enviar um ou mais eventos para o Amplitude [Obrigatório]

Parâmetros chave:

• events: Matriz de objetos de evento, cada um contendo:
  • event_type: Nome do evento (por exemplo, 'page_view', 'purchase')
  • user_id: Identificador único do usuário (obrigatório se não houver device_id)
  • device_id: Identificador do dispositivo (obrigatório se não houver user_id)
  • event_properties: Objeto com propriedades personalizadas do evento
  • user_properties: Objeto com propriedades do usuário a serem definidas
  • time: Timestamp do evento em milissegundos desde a época

Armadilhas:

• Pelo menos um de user_id ou device_id é necessário por evento
• event_type é necessário para cada evento; não pode estar vazio
• time deve estar em milissegundos (época de 13 dígitos), não em segundos
• O limite de lote se aplica; verifique o esquema para o número máximo de eventos por solicitação
• Os eventos são processados assincronamente; uma resposta de API bem-sucedida não significa que os dados sejam imediatamente consultáveis

2. Obter Atividade do Usuário

Quando usar: O usuário deseja visualizar o histórico de eventos para um usuário específico

Sequência de ferramentas:

1. AMPLITUDE_FIND_USER - Encontrar usuário por ID ou propriedade [Pré-requisito]
2. AMPLITUDE_GET_USER_ACTIVITY - Recuperar o fluxo de eventos do usuário [Obrigatório]

Parâmetros chave:

• user: ID interno do usuário do Amplitude (de FIND_USER)
• offset: Deslocamento de paginação para a lista de eventos
• limit: Número máximo de eventos a serem retornados

Armadilhas:

• O parâmetro user requer o ID interno do usuário do Amplitude, NÃO o user_id da sua aplicação
• É necessário chamar FIND_USER primeiro para resolver seu user_id para o ID interno do Amplitude
• A atividade é retornada em ordem cronológica reversa por padrão
• Históricos de atividade grandes exigem paginação via offset

3. Encontrar e Identificar Usuários

Quando usar: O usuário deseja procurar usuários ou definir propriedades de usuário

Sequência de ferramentas:

1. AMPLITUDE_FIND_USER - Pesquisar um usuário por vários identificadores [Obrigatório]
2. AMPLITUDE_IDENTIFY - Definir ou atualizar propriedades do usuário [Opcional]

Parâmetros chave:

• Para FIND_USER:
  • user: Termo de pesquisa (user_id, email ou ID do Amplitude)
• Para IDENTIFY:
  • user_id: Identificador do usuário da sua aplicação
  • device_id: Identificador do dispositivo (alternativa ao user_id)
  • user_properties: Objeto com operações $set, $unset, $add, $append

Armadilhas:

• FIND_USER pesquisa por user_id, device_id e ID do Amplitude
• IDENTIFY usa operações especiais de propriedade ($set, $unset, $add, $append)
• $set substitui valores existentes; $setOnce define apenas se ainda não estiver definido
• Pelo menos um de user_id ou device_id é necessário para IDENTIFY
• As alterações nas propriedades do usuário são eventualmente consistentes; não imediatas

4. Gerenciar Coortes

Quando usar: O usuário deseja listar coortes, visualizar detalhes de coortes ou atualizar a associação de coortes

Sequência de ferramentas:

1. AMPLITUDE_LIST_COHORTS - Listar todas as coortes salvas [Obrigatório]
2. AMPLITUDE_GET_COHORT - Obter informações detalhadas da coorte [Opcional]
3. AMPLITUDE_UPDATE_COHORT_MEMBERSHIP - Adicionar/remover usuários de uma coorte [Opcional]
4. AMPLITUDE_CHECK_COHORT_STATUS - Verificar o status da operação assíncrona da coorte [Opcional]

Parâmetros chave:

• Para LIST_COHORTS: Nenhum parâmetro obrigatório
• Para GET_COHORT: cohort_id (dos resultados da lista)
• Para UPDATE_COHORT_MEMBERSHIP:
  • cohort_id: ID da coorte de destino
  • memberships: Objeto com matrizes add e/ou remove de IDs de usuário
• Para CHECK_COHORT_STATUS: request_id da resposta de atualização

Armadilhas:

• IDs de coorte são necessários para todas as operações específicas de coorte
• UPDATE_COHORT_MEMBERSHIP é assíncrono; use CHECK_COHORT_STATUS para verificar

…