Automação de Segmento via Rube MCP

Automatize operações da plataforma de dados de clientes Segment com o toolkit Segment do Composio via Rube MCP.

Pré-requisitos

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

Fluxos de Trabalho Principais

1. Rastrear Eventos

Quando usar: O usuário deseja enviar dados de eventos para o Segment para destinos downstream

Sequência de ferramentas:

1. SEGMENT_TRACK - Enviar um único evento de rastreamento [Obrigatório]

Parâmetros chave:

• userId: Identificador do usuário (obrigatório se não houver anonymousId)
• anonymousId: Identificador anônimo (obrigatório se não houver userId)
• event: Nome do evento (ex: 'Pedido Concluído', 'Clique no Botão')
• properties: Objeto com propriedades específicas do evento
• timestamp: Timestamp no formato ISO 8601 (opcional; padrão é a hora do servidor)
• context: Objeto com metadados contextuais (IP, user agent, etc.)

Armadilhas:

• Pelo menos um de userId ou anonymousId é necessário
• O nome event é obrigatório e deve seguir convenções de nomenclatura consistentes
• Propriedades são objetos de formato livre; garanta um esquema consistente entre os eventos
• O timestamp deve estar no formato ISO 8601 (ex: '2024-01-15T10:30:00Z')
• Eventos são processados assincronamente; uma resposta de API bem-sucedida significa aceito, não entregue

2. Identificar Usuários

Quando usar: O usuário deseja associar características a um perfil de usuário no Segment

Sequência de ferramentas:

1. SEGMENT_IDENTIFY - Definir características e identidade do usuário [Obrigatório]

Parâmetros chave:

• userId: Identificador do usuário (obrigatório se não houver anonymousId)
• anonymousId: Identificador anônimo
• traits: Objeto com propriedades do usuário (email, nome, plano, etc.)
• timestamp: Timestamp no formato ISO 8601
• context: Metadados contextuais

Armadilhas:

• Pelo menos um de userId ou anonymousId é necessário
• Características são mescladas com características existentes, não substituídas
• Para remover uma característica, defina-a como null
• Chamadas de identificação devem ser feitas antes das chamadas de rastreamento para novos usuários
• Evite enviar PII em características, a menos que os destinos estejam configurados para isso

3. Operações em Lote

Quando usar: O usuário deseja enviar múltiplos eventos, identificações ou outras chamadas em uma única requisição

Sequência de ferramentas:

1. SEGMENT_BATCH - Enviar múltiplas chamadas do Segment em uma requisição [Obrigatório]

Parâmetros chave:

• batch: Array de objetos de mensagem, cada um com:
  • type: Tipo de mensagem ('track', 'identify', 'group', 'page', 'alias')
  • userId / anonymousId: Identificador do usuário
  • Campos adicionais baseados no tipo (evento, propriedades, características, etc.)

Armadilhas:

• Cada mensagem no lote deve ter um campo type válido
• O limite máximo de tamanho do lote se aplica; verifique o esquema para o limite atual
• Todas as mensagens em um lote são processadas independentemente; uma falha não afeta as outras
• Cada mensagem deve satisfazer independentemente os requisitos do seu tipo (ex: track precisa de nome do evento)
• Lote é a maneira mais eficiente de enviar múltiplas chamadas; prefira sobre chamadas individuais

4. Agrupar Usuários

Quando usar: O usuário deseja associar um usuário a uma empresa, equipe ou organização

Sequência de ferramentas:

1. SEGMENT_GROUP - Associar usuário a um grupo [Obrigatório]

Parâmetros chave:

• userId: Identificador do usuário (obrigatório se não houver anonymousId)
• anonymousId: Identificador anônimo
• groupId: Identificador do grupo/organização (obrigatório)
• traits: Objeto com propriedades do grupo (nome, setor, tamanho, plano)
• timestamp: Timestamp no formato ISO 8601

Armadilhas:

• groupId é obrigatório; ele identifica a empresa ou organização
• Características do grupo são mescladas com características existentes para aquele grupo
• Um usuário pode pertencer a múltiplos grupos
• Características do grupo atualizam o perfil do grupo, não o perfil do usuário

5. Rastrear Visualizações de Página

Quando usar: O usuário deseja registrar eventos de visualização de página no Segment

Sequência de ferramentas:

1. SEGMENT_PAGE - Enviar um evento de visualização de página [Obrigatório]

Parâmetros chave:

• userId: Identificador do usuário (obrigatório se não houver anonymousId)
• anonymousId: Identificador anônimo
• name: Nome da página (ex: 'Home', 'Preços', 'Dashboard')

…