Codex pode combinar uma investigação de base de código com relatórios GA4 quando você conecta ferramentas do Analytics ao seu host local. Isso permite comparar uma hipótese de lançamento com eventos registrados, mantendo a inspeção de código e os dados de produção observados distintos. Este guia usa MCP hospedado e o navegador OAuth em vez de um SDK do Analytics local.
O que você precisa antes de se conectar?
Use um Codex CLI instalado com suporte remoto para HTTP MCP e OAuth. Execute a configuração no mesmo host Codex onde você usará as ferramentas. Uma configuração CLI local não configura por si só uma tarefa de nuvem separada. Você não precisa de nenhuma chave de conta de serviço Google JSON ou API para esta rota OAuth hospedada.
- Um login Google com acesso à propriedade GA4 que você deseja analisar.
- Uma conta LoomaScale e uma conexão Google Analytics; conectar Google Ads sozinho não autoriza o Analytics.
- O ID numérico da propriedade ou permissão para descobri-la na lista de contas. Um ID de medição G identifica um fluxo da web e não é o ID da propriedade de relatório.
Como você conecta Codex a GA4?
1. Conecte GA4 em LoomaScale
Crie ou faça login em sua conta LoomaScale e abra Conexões. Escolha Google Analytics, faça login com o e-mail Google que tem acesso aos dados necessários e revise as permissões solicitadas. Fazer login em LoomaScale com Google não substitui a conexão desta fonte de dados. Você pode ativar este serviço sem conectar uma conta de publicidade.
2. Adicione o servidor MCP específico da origem ao Codex
Execute esses comandos em seu terminal. O primeiro salva o servidor remoto e o segundo inicia a autorização do navegador. O nome do servidor é específico para esta fonte Google, portanto, outra fonte pode ser adicionada sem substituí-la.
codex mcp add loomascale-ga4 --url https://api.loomascale.com/mcp/ga4
codex mcp login loomascale-ga43. Conclua OAuth e verifique a conexão Codex ativa
Conclua a autorização LoomaScale no navegador usando a conta com sua conexão Google e retorne ao terminal. Execute codex mcp list para verificar o servidor salvo. Inicie ou reabra uma sessão Codex e use /mcp para inspecionar suas ferramentas ativas. Uma entrada salva é uma evidência de configuração; a pesquisa de conta abaixo verifica o acesso aos dados. Os clientes locais suportados do Codex compartilham a configuração MCP para o mesmo host. Consulte a documentação atual do OpenAI para seu desktop ou superfície IDE; não presuma que um host diferente herdou seu login.
4. Verifique o acesso com uma pesquisa de conta real
Use LoomaScale para chamar ga4_get_account_summaries. Liste minhas propriedades GA4 acessíveis com seus nomes e IDs numéricos de propriedade. Pergunte-me qual propriedade usar. Leia o fuso horário e a moeda do relatório. Não altere nenhuma configuração.
A resposta deve conter propriedades do seu próprio login Google, com um recurso como properties/123456789. Selecione a propriedade por nome e ID e mantenha essa seleção nas solicitações subsequentes. Uma descrição de GA4 ou um painel de amostra não prova que o conector recuperou dados. Uma lista de contas vazia pode ser uma resposta válida de um login sem propriedades acessíveis.
Como você investiga uma alteração de evento após um lançamento em Codex?
Forneça a Codex o carimbo de data/hora de lançamento e rotas relevantes ou nomes de eventos. Peça para inspecionar como esses eventos são emitidos no repositório e, em seguida, recupere um relatório limitado da propriedade GA4 selecionada. Evite concluir que uma implantação causou uma mudança apenas porque as datas estão alinhadas. Mantenha a primeira investigação somente leitura para o repositório e o Analytics.
Use a propriedade GA4 selecionada por meio de LoomaScale. Inspecione a instrumentação de eventos purchase do repositório sem editar arquivos. Peça-me o carimbo de data e hora de lançamento, se estiver faltando. Relatório eventCount por date e eventName para purchase e begin_checkout em períodos completos comparáveis antes e depois do lançamento. Estado de propriedade, datas e fuso horário. Compare a hipótese do código com os dados observados e liste as evidências ausentes. Não mude nada.
O relatório pode estabelecer que as contagens de eventos registrados foram alteradas, enquanto a inspeção do repositório pode estabelecer como o código atual emite um evento. Nenhum dos dois prova qual código foi executado para cada visitante histórico. Verifique o lançamento do lançamento, o volume de tráfego e as alterações na coleção antes de propor um patch. Uma investigação de receita pode exigir um relatório separado com as métricas de receita relevantes.
Qual endpoint MCP este guia usa?
https://api.loomascale.com/mcp/ga4O endpoint específico do serviço expõe ferramentas GA4 e auxiliares de conta LoomaScale. O plug-in ou conector de diretório completo usa https://api.loomascale.com/mcp e pode alcançar todas as fontes que você conectar separadamente. Escolha a conexão completa para trabalhar entre serviços; use o endpoint específico quando desejar o conjunto de ferramentas desta fonte. Uma escolha de endpoint limita as ferramentas expostas, não as funções Google que seu login possui.
O que Codex pode ler ou alterar em GA4?
LoomaScale pode recuperar tráfego, engajamento, eventos importantes, receita, atividade em tempo real e relatórios de funil. Comece com relatórios e especifique datas, dimensões e métricas. As ferramentas de configuração, quando habilitadas para sua conta, precisam da função Google apropriada e da permissão analytics.edit; o acesso ao relatório por si só não permite edição. Conectar um assistente não instala uma tag de site, não cria eventos históricos nem torna a atribuição GA4 idêntica à atribuição de uma plataforma de anúncios.
Por que a conexão ou os dados estão faltando?
Se a autorização estiver faltando, execute codex mcp login loomascale-ga4 novamente. Se a entrada estiver configurada, mas ausente na sessão ativa, reinicie essa sessão e inspecione /mcp. Verifique o URL e o host se as ferramentas ainda não carregarem. O plugin principal LoomaScale e o servidor específico do serviço são conexões alternativas; instalar ambos pode expor conjuntos de ferramentas duplicados.
Se a propriedade estiver faltando, confirme o e-mail Google e o acesso à propriedade e, em seguida, verifique a conexão do Analytics em LoomaScale. Se um relatório estiver vazio, verifique a propriedade, datas, filtros e se o site realmente envia eventos. Compare períodos equivalentes no fuso horário da propriedade. Para uma incompatibilidade de métricas, preserve os nomes exatos das métricas e as definições de atribuição antes de tirar conclusões. Use o ID da propriedade de relatório em vez do identificador do G-stream.
Guias de conexão relacionados e referências oficiais
Use GA4 em outro assistente
- Como conectar ChatGPT a GA4
- Como conectar Claude a GA4
- Como conectar Claude Code a GA4
- Como conectar Grok Build a GA4
Conecte outra fonte Google ao Codex
Referências oficiais de configuração
Referências de configuração verificadas em 12 de novembro de 2026. Os rótulos de menu e as políticas do espaço de trabalho podem mudar; use as orientações do fornecedor vinculado para sua conta. Para fluxos de trabalho suportados pelo LoomaScale, consulte o hub de documentação.
