Automação do Mixpanel via Rube MCP

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

Pré-requisitos

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

Fluxos de Trabalho Principais

1. Agregar Dados de Eventos

Quando usar: O usuário deseja contar eventos, obter totais ou rastrear tendências de eventos ao longo do tempo

Sequência de ferramentas:

1. MIXPANEL_GET_ALL_PROJECTS - Listar projetos para obter o ID do projeto [Pré-requisito]
2. MIXPANEL_AGGREGATE_EVENT_COUNTS - Obter contagens e agregações de eventos [Obrigatório]

Parâmetros chave:

• event: Nome do evento ou array de nomes de eventos para agregar
• from_date / to_date: Intervalo de datas no formato 'AAAA-MM-DD'
• unit: Granularidade de tempo ('minute', 'hour', 'day', 'week', 'month')
• type: Tipo de agregação ('general', 'unique', 'average')
• where: Expressão de filtro para propriedades de eventos

Armadilhas:

• O formato da data deve ser 'AAAA-MM-DD'; outros formatos causam erros
• Nomes de eventos diferenciam maiúsculas de minúsculas; use nomes exatos do seu projeto Mixpanel
• O filtro where usa a sintaxe de expressão do Mixpanel (por exemplo, properties["country"] == "US")
• O intervalo de datas máximo pode ser limitado dependendo do seu plano Mixpanel

2. Executar Consultas de Segmentação

Quando usar: O usuário deseja detalhar eventos por propriedades para análise detalhada

Sequência de ferramentas:

1. MIXPANEL_QUERY_SEGMENTATION - Executar análise de segmentação [Obrigatório]

Parâmetros chave:

• event: Nome do evento para segmentar
• from_date / to_date: Intervalo de datas no formato 'AAAA-MM-DD'
• on: Propriedade para segmentar (por exemplo, properties["country"])
• unit: Granularidade de tempo
• type: Tipo de contagem ('general', 'unique', 'average')
• where: Expressão de filtro
• limit: Número máximo de segmentos a retornar

Armadilhas:

• O parâmetro on usa a sintaxe de expressão de propriedade do Mixpanel
• Referências de propriedade devem usar o formato properties["prop_name"]
• A segmentação em propriedades de alta cardinalidade retorna resultados limitados; use limit
• Os resultados são agrupados pela propriedade de segmentação e unidade de tempo

3. Analisar Funis

Quando usar: O usuário deseja rastrear funis de conversão e identificar pontos de abandono

Sequência de ferramentas:

1. MIXPANEL_LIST_FUNNELS - Listar funis salvos para encontrar o ID do funil [Pré-requisito]
2. MIXPANEL_QUERY_FUNNEL - Executar análise de funil [Obrigatório]

Parâmetros chave:

• funnel_id: ID do funil salvo para consultar
• from_date / to_date: Intervalo de datas
• unit: Granularidade de tempo
• where: Expressão de filtro
• on: Propriedade para segmentar o funil
• length: Janela de conversão em dias

Armadilhas:

• funnel_id é obrigatório; resolva primeiro via LIST_FUNNELS
• Funis devem ser criados na UI do Mixpanel primeiro; a API apenas consulta funis existentes
• A janela de conversão (length) tem valores padrão variáveis; defina explicitamente para precisão
• Intervalos de datas grandes com segmentação podem produzir respostas muito grandes

4. Gerenciar Perfis de Usuário

Quando usar: O usuário deseja consultar ou atualizar perfis de usuário no Mixpanel

Sequência de ferramentas:

1. MIXPANEL_QUERY_PROFILES - Pesquisar e filtrar perfis de usuário [Obrigatório]
2. MIXPANEL_PROFILE_BATCH_UPDATE - Atualizar múltiplos perfis de usuário [Opcional]

Parâmetros chave:

• where: Expressão de filtro para propriedades de perfil (por exemplo, properties["plan"] == "premium")
• output_properties: Array de nomes de propriedades a serem incluídos nos resultados
• page: Número da página para paginação
• session_id: ID da sessão para paginação consistente (da primeira resposta)
• Para atualização em lote: array de atualizações de perfil com $distinct_id e operações de propriedade

Armadilhas:

• Consultas de perfil retornam resultados paginados; use session_id da primeira resposta para paginação consistente
• where usa a sintaxe de expressão do Mixpanel para propriedades de perfil
• BATCH_UPDATE aplica operações ($set, $unset, $add, $append) aos perfis
• A atualização em lote tem um número máximo de perfis por solicitação; divida atualizações maiores
• Nomes de propriedades de perfil diferenciam maiúsculas de minúsculas

5. Gerenciar Coortes

…