# > # Da mídia paga ao diagnóstico: como combinar Configuração MCP no Codex, Google Ads MCP, Google Analytics MCP e mais 3 - Tipo: Artigo - Autor: Dionatha Rodrigues - Publicado em: 2026-11-03 · Atualizado em: 2026-11-03 - URL: https://clubmartech.com.br/blog/da-midia-paga-ao-diagnostico-com-codex/ Se a sua equipe de marketing gasta metade da manhã exportando planilhas de relatórios do Google Ads, tentando cruzar linhas de investimento com as sessões registradas no Google Analytics 4 e depois montando gráficos manuais no Excel para tentar explicar à diretoria por que o Custo por Aquisição (CPA) oscilou na última semana, você sabe como a análise manual de dados pode ser desgastante. Neste tutorial prático, a gente vai ensinar você a transformar o **OpenAI Codex** em um analista sênior de inteligência de mídia. Você verá como configurar o protocolo MCP no Codex, conectar os servidores oficiais do Google Ads e do GA4 em modo estritamente analítico (sem risco de alterar orçamentos), auditar a qualidade e integridade dos dados, decompor as causas raízes de oscilações de conversão e compilar relatórios executivos interativos em HTML prontos para apresentação. --- ## O resultado final: o que essa esteira entrega na prática Em vez de pedir análises genéricas para chatbots sem acesso aos seus números, essa esteira conecta o agente diretamente às suas fontes de verdade: ``` +-----------------------------------------------------------------------------------------+ | Fluxo de Entrega da Cadeia | +-----------------------------------------------------------------------------------------+ | | | 1. Conexão Segura (Configuração MCP): Codex autenticado aos servidores locais e remotos| | 2. Extração de Mídia (Google Ads MCP): Custo real, impressões e cliques por campanha | | 3. Validação de Aquisição (Google Analytics MCP): Sessões, engajamento e funis no GA4 | | 4. Limpeza e Qualidade (Analyze Data Quality): Identificação de dados nulos ou duplicados| | 5. Diagnóstico de Causa Raiz (Metric Diagnostics): Decomposição exata da oscilação | | 6. Entrega Executiva (Build Report): Relatório visual em HTML com fontes documentadas | | | +-----------------------------------------------------------------------------------------+ ``` Você obtém uma auditoria de desempenho automatizada, fundamentada em dados de API e protegida contra alterações acidentais de campanhas. --- ## Pré-requisitos técnicos Para configurar este ecossistema no seu terminal: - **OpenAI Codex CLI instalado:** Ferramenta oficial de linha de comando da OpenAI (`npm install -g @openai/codex`). - **Python (v3.10+) com pipx:** Necessário para rodar os servidores MCP do Google Ads e GA4 em ambientes isolados. - **Conta ativa no Google Ads:** ID de cliente da conta do Google Ads e credenciais de API de desenvolvedor (token de desenvolvedor e credenciais OAuth). - **Conta ativa no Google Analytics 4:** ID da propriedade do GA4 e credencial de conta de serviço no Google Cloud (`credentials.json`). - **Nível de acesso:** Permissão de leitura (Read-Only) em ambas as ferramentas para garantir segurança total. --- ## O passo a passo: conectando as 6 ferramentas da cadeia ``` +-----------------------------------------------------------------------------------------+ | Arquitetura de Análise no Codex Passo a Passo | +-----------------------------------------------------------------------------------------+ | | | [Configuração MCP ] ---> Registro dos servidores em config.toml com modo leitura | | | | | v | | [ Google Ads MCP ] ---> Extração de custos, lances e conversões da conta de anúncios | | | | | v | | [ GA4 MCP Server ] ---> Extração de sessões, usuários e eventos de conversão no site | | | | | v | | [Data Quality Skil] ---> Verificação de consistência e descarte de ruídos amostrais | | | | | v | | [Metric Diagnostic] ---> Decomposição de fatores: foi leilão, criativo ou página? | | | | | v | | [ Build Report ] ---> Renderização do relatório final em HTML com gráficos locais | | | +-----------------------------------------------------------------------------------------+ ``` --- ### Passo 1: Configurar os servidores MCP no OpenAI Codex O protocolo MCP (Model Context Protocol) permite que o Codex descubra ferramentas externas e chame APIs de forma padronizada. A configuração fica salva no arquivo `config.toml` do seu ambiente. - **O que faz:** Registra os comandos de inicialização dos servidores, variáveis de ambiente e chaves de autenticação, garantindo que o agente saiba exatamente quais ferramentas estão disponíveis para leitura. - **Documentação Oficial:** [OpenAI Codex MCP Configuration](https://learn.chatgpt.com/docs/extend/mcp?surface=cli) - **Licença:** Especificação e cliente oficial da OpenAI - **Como configurar:** Adicione os blocos de configuração no arquivo de perfil do Codex (`~/.codex/config.toml`): ```toml [mcp_servers.analytics] command = "pipx" args = ["run", "analytics-mcp"] [mcp_servers.google_ads] command = "pipx" args = ["run", "--spec", "git+https://github.com/googleads/google-ads-mcp.git", "google-ads-mcp"] ``` - **Prompt para execução:** > "Liste os servidores MCP conectados e confirme quais ferramentas estão registradas para leitura de dados no Google Ads e Google Analytics." > - **Saída esperada:** Lista das ferramentas ativas (como `get_campaign_stats` e `run_report`), confirmando a comunicação com os dois serviços. --- ### Passo 2: Extrair métricas de investimento com Google Ads MCP Com o conector autenticado, o Codex pode consultar o desempenho de campanhas sem exigir que você abra a interface densa do Google Ads. - **O que faz:** Executa consultas em lote na Google Ads Query Language (GAQL), extraindo impressões, cliques, custo total, conversões registradas e taxa de cliques (CTR) por campanha em períodos customizados. - **Repositório GitHub:** [googleads/google-ads-mcp](https://github.com/googleads/google-ads-mcp) - **Licença:** Apache-2.0 (mantido oficialmente pelo Google) - **Como instalar:** `bash codex mcp add google-ads -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp` - **Prompt para execução:** > "Consulte a conta do Google Ads em modo de leitura estrita. Extraia o custo, número de cliques, CPC médio e conversões das 3 principais campanhas de Search nos últimos 30 dias, agrupando por semana." - **Saída esperada:** Tabela formatada em Markdown com as métricas semanais consolidadas e cálculo da variação percentual de custo e volume. --- ### Passo 3: Extrair métricas de comportamento com Google Analytics MCP Agora que você tem o custo registrado no canal de mídia, precisa saber como esses usuários se comportaram após clicar no anúncio e entrar no site. - **O que faz:** Consulta propriedades do GA4 via Google Analytics Data API, puxando sessões com engajamento, tempo médio na página, taxa de rejeição e eventos de conversão no destino. - **Repositório GitHub:** [googleanalytics/google-analytics-mcp](https://github.com/googleanalytics/google-analytics-mcp) - **Licença:** Apache-2.0 (mantido oficialmente pelo Google Analytics) - **Como instalar:** `bash codex mcp add analytics -- pipx run analytics-mcp` - **Prompt para execução:** > "Consulte a propriedade do GA4 associada. Puxe as sessões e a taxa de conversão originadas da fonte `google / cpc` nas mesmas 4 semanas analisadas no Passo 2, comparando cliques do anúncio com sessões registradas no site." - **Saída esperada:** Matriz comparativa destacando a taxa de perda de tráfego entre o clique no anúncio e a abertura real da página de destino. --- ### Passo 4: Auditar a integridade da base com Analyze Data Quality Antes de tirar conclusões precipitadas sobre o desempenho de uma campanha, é crucial conferir se os dados não sofreram contaminações por linhas nulas, duplicidade de IDs ou atrasos de processamento. - **O que faz:** Inspeciona os conjuntos de dados extraídos de ambas as APIs, validando a completude dos dados, identificando outliers inexplicáveis e sinalizando se as janelas de atribuição introduziram distorções temporais. - **Repositório GitHub:** [openai/plugins](https://github.com/openai/plugins/tree/main/plugins/data-analytics/skills/analyze-data-quality) - **Licença:** Repositório oficial de plugins da OpenAI - **Como instalar:** `bash codex plugin marketplace add openai/plugins` - **Prompt para execução:** > "$analyze-data-quality — Analise o cruzamento de dados entre os cliques do Google Ads e as sessões do GA4 das últimas 4 semanas. Aponte se há discrepâncias anormais e avalie se os dados são suficientes para conclusões estatísticas." - **Saída esperada:** Diagnóstico de qualidade indicando se há perda excessiva de sinal (ex.: mais de 15% de cliques sem sessão correspondente) e confirmando que a base está limpa para análise. --- ### Passo 5: Decompor oscilações de resultado com Metric Diagnostics Quando o Custo por Aquisição (CPA) sobe, o gestor comum tende a culpar o anúncio ou o algoritmo. A skill `metric-diagnostics` atua como um perito que decompõe a métrica em seus fatores causais reais. - **O que faz:** Decompõe a variação de um indicador composto (como CPA ou ROAS) em seus componentes fundamentais: 1) Efeito Leilão (variação de CPC); 2) Efeito Criativo (variação de CTR); 3) Efeito Página (variação de taxa de conversão da landing page). - **Repositório GitHub:** [openai/plugins](https://github.com/openai/plugins/tree/main/plugins/data-analytics/skills/metric-diagnostics) - **Licença:** Repositório oficial de plugins da OpenAI - **Como instalar:** `bash codex plugin marketplace add openai/plugins` - **Prompt para execução:** > "$metric-diagnostics — Na terceira semana, o CPA da campanha subiu 35%. Decomponha matematicamente essa alta entre variação de CPC no leilão versus queda na taxa de conversão da landing page no GA4, mostrando a contribuição exata de cada fator." - **Saída esperada:** Relatório de decomposição apontando que 80% do aumento do CPA foi causado pela subida do CPC médio no leilão (pressão de concorrentes), enquanto a página de destino manteve sua eficiência estável de conversão. --- ### Passo 6: Gerar o relatório executivo em HTML com Build Report A última etapa é traduzir toda essa análise técnica em um artefato visual compreensível que a liderança da empresa possa abrir no navegador e interagir com facilidade. - **O que faz:** Compila os números, os gráficos de tendência e as recomendações de ação em um relatório interativo e autocontido em HTML/CSS, sem necessidade de servidores de nuvem externos. - **Repositório GitHub:** [openai/plugins](https://github.com/openai/plugins/tree/main/plugins/data-analytics/skills/build-report) - **Licença:** Repositório oficial de plugins da OpenAI - **Como instalar:** `bash codex plugin marketplace add openai/plugins` - **Prompt para execução:** > "$build-report — Transforme a análise aprovada em um relatório executivo em arquivo único `relatorio-desempenho-midia.html`. Inclua resumo executivo para diretoria, gráficos comparativos de barras em CSS e lista priorizada de ações recomendadas para as próximas campanhas." - **Saída esperada:** Arquivo `relatorio-desempenho-midia.html` gerado localmente com design limpo, responsivo e tabelas de métricas claras prontas para apresentação. --- ## Onde costuma dar errado e como verificar cada passo 1. **Discrepância natural entre cliques do Google Ads e sessões do GA4:** É absolutamente normal que o GA4 registre entre 5% e 12% menos sessões do que os cliques cobrados no Google Ads (devido a usuários que fecham a página antes do carregamento completo do script ou que possuem adblockers). Preocupe-se apenas se a diferença ultrapassar 20%. 2. **Tentativas acidentais de escrita no Google Ads:** Certifique-se de configurar a chamada do Google Ads MCP com tokens ou credenciais restritas a leitura. O agente deve ter acesso para consultar relatórios (`get_campaign_stats`), mas nunca para alterar lances ou pausar conjuntos (`update_campaign`). 3. **Erros de Timezone entre Ads e Analytics:** Se a sua conta do Google Ads estiver configurada no fuso horário de Brasília (GMT-3) e o GA4 estiver no horário do Pacífico (GMT-8), os relatórios diários terão distorções graves. Garanta que ambas as propriedades utilizem o mesmo fuso horário nas configurações administrativas. --- ## Variações da esteira: com e sem ferramentas pagas | Etapa | Versão Padrão (Open Source / Free) | Alternativa Integrada / Paga | | --- | --- | --- | | **Conexão MCP** | OpenAI Codex CLI local | ChatGPT Team com MCP remoto | | **Dados Google Ads** | `google-ads-mcp` oficial | Supermetrics / Fivetran pipeline | | **Dados GA4** | `google-analytics-mcp` oficial | BigQuery export em streaming | | **Qualidade e QA** | `analyze-data-quality` da OpenAI | Monte Carlo Data Observability | | **Diagnóstico** | `metric-diagnostics` no terminal | Amplitude Root Cause Analysis | | **Relatório Final** | `build-report` em HTML local | Looker / Tableau Server | --- ## O que a gente faria diferente com os aprendizados de execução - **Analise janelas móveis de 7 dias:** Comparações diárias sofrem com flutuações sazonais bruscas (fins de semana sempre convertem diferente de terças-feiras). Utilize sempre médias móveis de 7 ou 14 dias para identificar tendências reais. - **Documente o contexto de mudanças externas:** Ao gerar o relatório, anote se houve feriados, eventos no setor ou ataques agressivos de concorrentes no período. Números isolados sem contexto histórico geram diagnósticos incorretos. - **Guarde o HTML dos relatórios em um repositório interno:** Manter o histórico dos arquivos `relatorio-desempenho-midia.html` ao longo dos meses cria uma base de conhecimento inestimável sobre como as suas campanhas reagiram a diferentes cenários econômicos. --- ## Perguntas frequentes (FAQ) ### O conector do Google Ads MCP pode gastar meu orçamento sozinho? Não, se você utilizar permissões de leitura ou restringir o servidor MCP a métodos de relatório (queries GAQL). O conector executará apenas leituras analíticas, deixando a gestão de orçamentos e aprovações sob o controle humano exclusivo do gestor de tráfego. ### O que significa decomposição matemática de métricas? É uma metodologia analítica que isola o quanto da variação de um indicador final (como receita ou CPA) se deve à variação do preço pago pelo insumo (CPC), à atratividade do anúncio (CTR) ou à eficácia da página de destino (Taxa de Conversão). Isso evita que a equipe tente resolver na landing page um problema que se originou no leilão. ### Posso rodar essa mesma rotina no Claude Code ou apenas no Codex? O protocolo MCP é um padrão aberto. Embora o exemplo deste tutorial utilize o cliente OpenAI Codex e seus plugins de análise de dados, os servidores MCP do Google Ads e do GA4 funcionam de maneira idêntica no Claude Code ou no Google Antigravity. --- ## Próximo passo na sua jornada Transformar dados dispersos de mídia e web analytics em inteligência acionável de negócios é o que diferencia os gestores táticos dos líderes estratégicos de receita. Se você quer aprofundar nessa visão e aprender a dominar a integração de agentes autônomos, protocolos MCP e ciência de dados aplicada ao marketing para quem já executa e quer escolher o próprio caminho, conheça o módulo de **Fundamentos de IA** na [Formação Club Martech](https://clubmartech.com.br/formacao/). Lá, a gente capacita você a orquestrar as ferramentas mais avançadas do mercado para construir operações analíticas previsíveis e orientadas a resultados.