Google Analytics MCP Server

Uma interface estruturada para interagir com as APIs do Google Analytics, simplificando tarefas como consultar relatórios e gerenciar propriedades.

GitHub
6
Experimente este MCPPatrocinado

Documentação

Servidor MCP do Google Analytics

O GA-MCP (Painel de Controle de Gerenciamento do Google Analytics) é um pacote Node.js leve que fornece aos desenvolvedores uma interface estruturada para interagir com as APIs do Google Analytics. Ele simplifica tarefas comuns do GA, como consultar relatórios de análise, gerenciar propriedades, públicos e muito mais—tornando-o ideal para analistas de dados, desenvolvedores e equipes de marketing que buscam automatizar relatórios e fluxos de trabalho de análise. Padrão MCP.

Recursos

  • Buscar e analisar dados de desempenho do GA (sessões, usuários, visualizações de página, conversões)
  • Gerenciar propriedades, fluxos de dados e eventos de conversão
  • Consultar dimensões e métricas personalizadas
  • Acessar hierarquias de contas e configurações de propriedades
  • Exportar dados para painéis ou análises adicionais
  • Autenticação OAuth2 com tokens de acesso e atualização
  • Leve, seguro e altamente configurável

Ferramentas MCP

  • get_reports: Obter dados de relatórios de análise para métricas e dimensões especificadas
  • list_accounts: Listar todas as contas do Google Analytics
  • list_properties: Listar propriedades de uma conta do Google Analytics
  • list_data_streams: Listar fluxos de dados de uma propriedade
  • list_custom_dimensions: Listar dimensões personalizadas de uma propriedade
  • list_custom_metrics: Listar métricas personalizadas de uma propriedade
  • list_conversion_events: Listar eventos de conversão de uma propriedade

Primeiros Passos

Pré-requisitos

  • Node.js v18 ou posterior
  • Credenciais OAuth2 do Google (ID do Cliente e Segredo do Cliente)
  • Tokens de acesso e atualização válidos do Google Analytics

Configuração de Autenticação

  1. Criar Credenciais OAuth2:

    • Acesse o Console do Google Cloud

    • Crie ou selecione um projeto

    • Ative a API do Google Analytics

    • Vá para "Credenciais" → "Criar Credenciais" → "IDs de Cliente OAuth 2.0"

    • Configure a tela de consentimento e escolha o tipo de aplicativo apropriado:

      Opção A: Aplicativo Web (Recomendado)

      • Selecione "Aplicativo web"
      • Adicione http://localhost:3000/auth/callback em "URIs de redirecionamento autorizados"

      Opção B: Aplicativo de Desktop

      • Selecione "Aplicativo de desktop"
      • Nenhuma configuração de URI de redirecionamento necessária (usa fluxo fora de banda)

  2. Gerar Tokens de Acesso e Atualização:

    • Use o script auxiliar incluído: npm run oauth-helper
    • Ou use o Playground OAuth2 do Google com suas credenciais de cliente
    • Ou implemente seu próprio fluxo OAuth2

Fluxo de Configuração Rápida

# 1. Set up environment file
npm run setup-env

# 2. Edit .env with your OAuth2 Client ID and Secret (from step 1 above)

# 3. Generate tokens
npm run oauth-helper

# 4. Copy the generated tokens to your .env file

# 5. Build and start
npm run build
node dist/index.js

Instalação

Clone este repositório e instale as dependências:

pnpm install
# or
npm install

Build

pnpm build
# or
npm run build

Configuração de Variáveis de Ambiente

Opção 1: Usando arquivo .env (Recomendado)

Configure seu arquivo de ambiente:

npm run setup-env
# This creates .env from the template
# Edit .env file with your actual credentials

Opção 2: Usando comandos de exportação

Defina as seguintes variáveis de ambiente:

export GOOGLE_CLIENT_ID=your_oauth2_client_id
export GOOGLE_CLIENT_SECRET=your_oauth2_client_secret
export GOOGLE_ACCESS_TOKEN=your_access_token
export GOOGLE_REFRESH_TOKEN=your_refresh_token

Iniciar

Inicie o servidor MCP:

node dist/index.js

Integrar com o Cursor

Para usar este servidor MCP com o Cursor, adicione um arquivo .cursor/mcp.json à raiz do seu projeto:

{
  "mcpServers": {
    "ga-mcp": {
      "command": "npx",
      "args": ["-y", "ga-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_oauth2_client_id",
        "GOOGLE_CLIENT_SECRET": "your_oauth2_client_secret",
        "GOOGLE_ACCESS_TOKEN": "your_access_token",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Integrar com o VSCode

Para usar este servidor MCP com o VSCode, adicione um arquivo .vscode/mcp.json à raiz do seu projeto:

{
  "servers": {
    "ga-mcp": {
      "command": "npx",
      "args": ["-y", "ga-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_oauth2_client_id",
        "GOOGLE_CLIENT_SECRET": "your_oauth2_client_secret",
        "GOOGLE_ACCESS_TOKEN": "your_access_token",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Esta configuração permite que o VSCode reconheça e gerencie automaticamente o servidor MCP do Google Analytics.

Esta configuração permite que o Cursor reconheça e gerencie automaticamente o servidor MCP do Google Analytics.

Atualização de Token

O servidor MCP lida automaticamente com a atualização de tokens usando o token de atualização fornecido. Se o token de acesso expirar, ele será atualizado automaticamente durante as chamadas de API.

Solução de Problemas

"O URI de redirecionamento... só pode ser usado por um ID de Cliente para aplicativo nativo"

Este erro ocorre quando você tem um cliente OAuth de Aplicativo web, mas está usando o URI de redirecionamento fora de banda. Soluções:

Solução 1: Usar Aplicativo Web (Recomendado)

  1. No Console do Google Cloud, edite seu cliente OAuth
  2. Adicione http://localhost:3000/auth/callback em "URIs de redirecionamento autorizados"
  3. Mantenha GOOGLE_REDIRECT_URI=http://localhost:3000/auth/callback no seu arquivo .env

Solução 2: Alternar para Aplicativo de Desktop

  1. Crie um novo cliente OAuth e selecione "Aplicativo de desktop"
  2. Defina GOOGLE_REDIRECT_URI=urn:ietf:wg:oauth:2.0:oob no seu arquivo .env

Sobre a AST Consulting

AST Consulting é uma empresa líder em consultoria digital, especializada em FinOps, otimização de nuvem, soluções de IA/ML, transformação digital e marketing de desempenho. Com mais de 100 anos de experiência combinada em liderança e um portfólio que impacta mais de 50 milhões de empresas e mais de 500 milhões de usuários, a AST entrega resultados mensuráveis ao combinar visão estratégica com profunda expertise técnica.

Desenvolvemos o ga-mcp como parte do nosso compromisso de capacitar profissionais de marketing, analistas e equipes digitais com ferramentas que impulsionam eficiência, transparência e insights acionáveis. Seja otimizando gastos em nuvem ou automatizando pipelines de inteligência analítica, a AST constrói soluções que escalam.

👉 Visite-nos em www.astconsulting.in

ga-mcp