Automação do PostHog via Rube MCP

Automatize a análise de produtos e o gerenciamento de flags de recursos do PostHog através do toolkit PostHog do Composio via Rube MCP.

Pré-requisitos

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

Fluxos de Trabalho Principais

1. Capturar Eventos

Quando usar: O usuário deseja enviar dados de eventos para o PostHog para rastreamento de análise.

Sequência de ferramentas:

1. POSTHOG_CAPTURE_EVENT - Envia um ou mais eventos para o PostHog [Obrigatório]

Parâmetros principais:

• event: Nome do evento (ex: '$pageview', 'user_signed_up', 'purchase_completed')
• distinct_id: Identificador único do usuário (obrigatório)
• properties: Objeto com propriedades específicas do evento
• timestamp: Timestamp no formato ISO 8601 (opcional; padrão é a hora do servidor)

Armadilhas:

• distinct_id é obrigatório para cada evento; identifica o usuário/dispositivo
• Eventos do sistema PostHog usam o prefixo $ (ex: '$pageview', '$identify')
• Eventos personalizados NÃO devem usar o prefixo $
• Propriedades são de formato livre; mantenha esquemas consistentes entre os eventos
• Eventos são processados de forma assíncrona; o atraso na ingestão é geralmente de segundos

2. Listar e Filtrar Eventos

Quando usar: O usuário deseja navegar ou pesquisar eventos capturados.

Sequência de ferramentas:

1. POSTHOG_LIST_AND_FILTER_PROJECT_EVENTS - Consulta eventos com filtros [Obrigatório]

Parâmetros principais:

• project_id: ID do projeto PostHog (obrigatório)
• event: Filtra por nome do evento
• person_id: Filtra por ID da pessoa
• after: Eventos após este timestamp ISO 8601
• before: Eventos antes deste timestamp ISO 8601
• limit: Número máximo de eventos a serem retornados
• offset: Offset de paginação

Armadilhas:

• project_id é obrigatório; resolva primeiro via LIST_PROJECTS
• Filtros de data usam o formato ISO 8601 (ex: '2024-01-15T00:00:00Z')
• Grandes volumes de eventos exigem paginação; use offset e limit
• Os resultados são retornados em ordem cronológica reversa por padrão
• Propriedades de eventos são aninhadas; analise com cuidado

3. Gerenciar Flags de Recursos

Quando usar: O usuário deseja criar, visualizar ou gerenciar flags de recursos.

Sequência de ferramentas:

1. POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS - Lista flags de recursos existentes [Obrigatório]
2. POSTHOG_RETRIEVE_FEATURE_FLAG_DETAILS - Obtém a configuração detalhada da flag [Opcional]
3. POSTHOG_CREATE_FEATURE_FLAGS_FOR_PROJECT - Cria uma nova flag de recurso [Opcional]

Parâmetros principais:

• Para listar: project_id (obrigatório)
• Para detalhes: project_id, id (ID da flag de recurso)
• Para criar:
  • project_id: Projeto alvo
  • key: Chave da flag (ex: 'new-dashboard-beta')
  • name: Nome legível por humanos
  • filters: Regras de segmentação e percentual de rollout
  • active: Se a flag está habilitada

Armadilhas:

• A key da flag de recurso deve ser única dentro de um projeto
• Chaves de flag devem usar kebab-case (ex: 'my-feature-flag')
• filters definem grupos de segmentação com propriedades e percentuais de rollout
• Criar uma flag com active: true a habilita imediatamente para usuários correspondentes
• Mudanças nas flags entram em vigor em segundos devido ao mecanismo de polling do PostHog

4. Gerenciar Projetos

Quando usar: O usuário deseja listar ou inspecionar projetos e organizações do PostHog.

Sequência de ferramentas:

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

Parâmetros principais:

• organization_id: Identificador da organização (pode ser opcional dependendo da autenticação)
• limit: Número de resultados por página
• offset: Offset de paginação

Armadilhas:

• IDs de projeto são numéricos; usados como parâmetros na maioria dos outros endpoints
• O ID da organização pode ser necessário; verifique sua configuração do PostHog
• A paginação é baseada em offset; itere até que os resultados estejam vazios
• Configurações de projeto incluem chaves de API e detalhes de configuração

5. Perfil do Usuário e Autenticação

Quando usar: O usuário deseja verificar detalhes do usuário atual ou verificar o acesso à API.

Sequência de ferramentas:

1. POSTHOG_WHOAMI - Obtém informações do usuário da API atual [Opcional]

…