Mixpanel MCP Server

Integre análises do Mixpanel aos seus fluxos de trabalho de IA.

GitHub
5
Experimente este MCPPatrocinado

Documentação

Servidor MCP Mixpanel

Um servidor Model Context Protocol (MCP) para integrar análises do Mixpanel em fluxos de trabalho de IA. Este servidor permite que assistentes de IA como o Claude rastreiem eventos, visualizações de página, cadastros de usuários e atualizem perfis de usuários no Mixpanel.

Nota da versão 2.0.1: Os nomes das ferramentas agora incluem o prefixo mixpanel_ para evitar colisões de namespace com outros servidores MCP de análise.

Sumário

Recursos

  • Rastrear eventos personalizados no Mixpanel
  • Rastrear visualizações de página com informações de referência
  • Rastrear cadastros de usuários e criar perfis de usuários
  • Atualizar perfis de usuários existentes
  • Integração simples com o Claude Desktop e outros clientes MCP

Instalação

Pré-requisitos

  • Node.js 16 ou superior
  • Um token de projeto Mixpanel (obtenha um cadastrando-se em Mixpanel)

Instalação via NPM (Recomendada)

# Install globally
npm install -g mixpanel-mcp-server

# Or use directly with npx
npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN

Instalação Manual

# Clone the repository
git clone https://github.com/yourusername/mixpanel-mcp-server.git
cd mixpanel-mcp-server

# Install dependencies
npm install

# Run the server
node index.js --token YOUR_MIXPANEL_TOKEN

Início Rápido

Para começar a usar o servidor MCP Mixpanel com o Claude Desktop:

  1. Certifique-se de que o Claude Desktop está instalado na sua máquina (baixe em claude.ai/download)

  2. Crie ou edite o arquivo de configuração do Claude Desktop:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %AppData%\Claude\claude_desktop_config.json

  3. Adicione a configuração do servidor MCP Mixpanel:

{
  "mcpServers": {
    "mixpanel-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "mixpanel-mcp-server",
        "--token",
        "YOUR_MIXPANEL_TOKEN"
      ]
    }
  }
}
  1. Reinicie o Claude Desktop e comece a rastrear análises!

Uso Detalhado

Com o Claude Desktop

Após configurar o arquivo de configuração conforme mostrado na seção Início Rápido, você pode usar os recursos de análise do Mixpanel diretamente nas suas conversas com o Claude.

Exemplos de prompts que você pode usar:

  • "Rastreie um evento personalizado no Mixpanel chamado 'document_generated' para o usuário 'user123'"
  • "Rastreie uma visualização de página para a página inicial no Mixpanel"
  • "Crie um novo perfil de usuário no Mixpanel para João Silva com email joao@exemplo.com"
  • "Atualize as informações do perfil do usuário no Mixpanel para o usuário 'user123'"

O Claude usará a ferramenta MCP Mixpanel apropriada com base na sua solicitação.

Com Outros Clientes MCP

Este servidor usa o Model Context Protocol padrão e pode ser integrado com qualquer cliente MCP:

  1. Inicie o servidor:

    npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN

  2. Conecte seu cliente MCP ao servidor usando transporte stdio

  3. O cliente pode descobrir e usar as ferramentas disponíveis (mixpanel_track_event, mixpanel_track_pageview, mixpanel_track_signup, mixpanel_set_user_profile)

Referência de Ferramentas

O servidor MCP Mixpanel fornece as seguintes ferramentas:

mixpanel_track_event

Rastreia um evento personalizado no Mixpanel.

Parâmetros:

  • event_name (string, obrigatório): O nome do evento a ser rastreado
  • distinct_id (string, opcional): Identificador do usuário. Padrão: 'anonymous'
  • properties (objeto, opcional): Propriedades adicionais para rastrear com o evento

Exemplo:

{
  "event_name": "button_clicked",
  "distinct_id": "user123",
  "properties": {
    "button_id": "submit_form",
    "page": "checkout"
  }
}

mixpanel_track_pageview

Rastreia um evento de visualização de página no Mixpanel.

Parâmetros:

  • page_name (string, obrigatório): O nome da página visualizada
  • distinct_id (string, opcional): Identificador do usuário. Padrão: 'anonymous'
  • referrer (string, opcional): A página de referência

Exemplo:

{
  "page_name": "homepage",
  "distinct_id": "user123",
  "referrer": "google.com"
}

mixpanel_track_signup

Rastreia um evento de cadastro e cria um perfil de usuário no Mixpanel.

Parâmetros:

  • user_name (string, obrigatório): Nome completo do usuário
  • email (string, obrigatório): Endereço de e-mail do usuário
  • plan (string, opcional): Plano de cadastro. Padrão: 'free'

Exemplo:

{
  "user_name": "John Doe",
  "email": "john@example.com",
  "plan": "premium"
}

mixpanel_set_user_profile

Atualiza as propriedades do perfil de um usuário no Mixpanel.

Parâmetros:

  • distinct_id (string, obrigatório): Identificador do usuário
  • properties (objeto, obrigatório): Propriedades do perfil a serem definidas

Exemplo:

{
  "distinct_id": "user123",
  "properties": {
    "$name": "John Doe",
    "$email": "john@example.com",
    "plan": "premium",
    "company": "Acme Inc"
  }
}

Exemplos

Aqui estão alguns exemplos práticos de uso do servidor MCP Mixpanel com o Claude:

Rastreando um Clique em Botão

You: Can you track an event in Mixpanel when a user clicks the submit button?

Claude: I'll track that event for you. Let me use the Mixpanel analytics tool.

[Claude uses the mixpanel_track_event tool with appropriate parameters]

Claude: I've successfully tracked the 'button_clicked' event in Mixpanel with the properties you specified.

Criando um Perfil de Usuário

You: Create a new user profile in Mixpanel for Sarah Johnson who signed up with sarah@example.com on the premium plan.

Claude: I'll create that user profile in Mixpanel.

[Claude uses the mixpanel_track_signup tool with appropriate parameters]

Claude: I've successfully tracked the signup for Sarah Johnson and created a profile in Mixpanel with the premium plan.

Solução de Problemas

Problemas Comuns

  1. Servidor não iniciando:

    • Certifique-se de ter fornecido um token Mixpanel válido
    • Verifique se o Node.js está instalado e é versão 16 ou superior

  2. Claude Desktop não mostrando as ferramentas Mixpanel:

    • Verifique a sintaxe do seu arquivo claude_desktop_config.json
    • Certifique-se de ter reiniciado o Claude Desktop após editar a configuração
    • Verifique se o caminho para o servidor está correto

  3. Eventos não aparecendo no Mixpanel:

    • Verifique se o seu token Mixpanel está correto
    • Verifique as configurações do seu projeto Mixpanel para garantir que os dados estão sendo recebidos
    • Os eventos podem levar alguns minutos para aparecer na interface do Mixpanel

Modo de Depuração

Para executar o servidor em modo de depuração com registro mais detalhado:

npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN --debug

Notas de Segurança

  • Seu token Mixpanel é armazenado no arquivo de configuração do Claude Desktop. Certifique-se de que este arquivo tenha permissões apropriadas
  • Considere usar variáveis de ambiente para tokens sensíveis em ambientes de produção
  • Este servidor não implementa limitação de taxa - considere adicionar medidas de segurança adicionais para uso em produção
  • Os eventos são enviados diretamente para a API do Mixpanel - revise a política de privacidade do Mixpanel para práticas de tratamento de dados

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.