Sobre o projeto

O Google Analytics 4 (GA4) MCP Server é um servidor Model Context Protocol que fornece a agentes de IA acesso direto e pronto para análise às propriedades GA4. Elimina o trabalho manual de manipulação de dados ao oferecer descoberta de esquema, agregação de métricas no lado do servidor e padrões seguros prontos para uso. O servidor pode ser instalado por meio de um instalador universal de uma linha que configura automaticamente clientes MCP populares como Claude Desktop, Cursor, Claude Code, VS Code (Cline/Roo Code/Continue), Zed e Windsurf. Também está disponível como pacote Python no PyPI e como pacote npm sob o escopo `@surendranb`. Ferramentas disponíveis incluem execução de relatórios multidimensionais GA4 com totais automatizados, listagem de contas e propriedades, busca de esquemas completos de dimensões e métricas, consulta de usuários ativos em tempo real e contagens de eventos, e pesquisa de habilidades analíticas integradas. Habilidades dinâmicas são carregadas do GitHub e cobrem diagnóstico de tráfego, aquisição de canais, análise de e-commerce e análise de referência de IA (rastreamento de tráfego de ChatGPT, Claude, Perplexity e Gemini). A autenticação requer um arquivo JSON de conta de serviço do Google e um ID de propriedade GA4, configurados por meio de variáveis de ambiente ou arquivos de configuração específicos do cliente. O pacote coleta telemetria anônima, sem PII, por padrão, que pode ser desativada via `DO_NOT_TRACK=1` ou `MCP_TELEMETRY_OPT_OUT=1`. Licença: MIT.