--- title: "MCP do Google Analytics 1.0: o que faz e como conectá-lo ao GA4" description: "O servidor MCP oficial do Google Analytics agora é estável. Quais relatórios permite, como instalá-lo com o Claude ou o Cursor e por que começar só com leitura." url: "https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/" markdown_url: "https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4.md" lang: "pt-BR" date_published: "2026-11-12" author: "Martín Garay" author_url: "https://cookingmetrics.com/pt/quem-e-martin-garay/" publisher: "CookingMetrics" publisher_url: "https://cookingmetrics.com/pt/" keywords: ["MCP", "Google Analytics"] citation_apa7: "Garay, M. (2026, 12 de novembro). *MCP do Google Analytics 1.0: o que faz e como conectá-lo ao GA4*. CookingMetrics. https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/" references_apa7: - "Google Analytics, GitHub. (s.d.). *Google Analytics MCP server*. https://github.com/googleanalytics/google-analytics-mcp" - "Google Analytics, GitHub. (s.d.). *Google Analytics MCP server: releases*. https://github.com/googleanalytics/google-analytics-mcp/releases" - "Google for Developers. (s.d.). *Google Analytics MCP server*. https://developers.google.com/analytics/devguides/MCP" - "Google Cloud. (s.d.). *Set up ADC for a local development environment*. https://docs.cloud.google.com/docs/authentication/set-up-adc-local-dev-environment" - "Python Packaging Authority. (s.d.). *pipx documentation*. https://pipx.pypa.io/" - "Google Analytics for Developers. (s.d.). *Google Analytics Data API basics*. https://developers.google.com/analytics/devguides/reporting/data/v1/basics" - "Google Analytics for Developers. (s.d.). *Google Analytics Data API schema*. https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema" --- # MCP do Google Analytics 1.0: o que faz e como conectá-lo ao GA4 > O servidor MCP oficial do Google Analytics agora é estável. Quais relatórios permite, como instalá-lo com o Claude ou o Cursor e por que começar só com leitura. - **Autor:** [Martín Garay](https://cookingmetrics.com/pt/quem-e-martin-garay/) · Fundador da CookingMetrics - **Publicado:** 12 de novembro de 2026 - **Temas:** MCP, Google Analytics - **Versão web:** https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/ ## Como citar este artigo (APA, 7.ª edição) Garay, M. (2026, 12 de novembro). *MCP do Google Analytics 1.0: o que faz e como conectá-lo ao GA4*. CookingMetrics. https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/ Citação no texto: (Garay, 2026) ## Referências - Google Analytics, GitHub. (s.d.). *Google Analytics MCP server*. https://github.com/googleanalytics/google-analytics-mcp Citação no texto: (Google Analytics, GitHub, s.d.) - Google Analytics, GitHub. (s.d.). *Google Analytics MCP server: releases*. https://github.com/googleanalytics/google-analytics-mcp/releases Citação no texto: (Google Analytics, GitHub, s.d.) - Google for Developers. (s.d.). *Google Analytics MCP server*. https://developers.google.com/analytics/devguides/MCP Citação no texto: (Google for Developers, s.d.) - Google Cloud. (s.d.). *Set up ADC for a local development environment*. https://docs.cloud.google.com/docs/authentication/set-up-adc-local-dev-environment Citação no texto: (Google Cloud, s.d.) - Python Packaging Authority. (s.d.). *pipx documentation*. https://pipx.pypa.io/ Citação no texto: (Python Packaging Authority, s.d.) - Google Analytics for Developers. (s.d.). *Google Analytics Data API basics*. https://developers.google.com/analytics/devguides/reporting/data/v1/basics Citação no texto: (Google Analytics for Developers, s.d.) - Google Analytics for Developers. (s.d.). *Google Analytics Data API schema*. https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema Citação no texto: (Google Analytics for Developers, s.d.) --- **O servidor MCP do Google Analytics é a via oficial para que um assistente de IA, como o Claude ou o Cursor, consulte os dados de uma propriedade do GA4 por meio das APIs do Google.** Em 3 de novembro de 2026, o Google publicou a versão 1.0.0 e o projeto deixou a fase experimental. Três dias depois chegou a 1.1.0, que adiciona a criação opcional de eventos-chave e dimensões personalizadas. Este artigo explica quais ferramentas ele inclui, como instalá-lo passo a passo e quais cuidados tomar antes de habilitar a escrita. O que se afirma sobre o funcionamento do servidor vem do [repositório oficial no GitHub](https://github.com/googleanalytics/google-analytics-mcp) e da [documentação do Google for Developers](https://developers.google.com/analytics/devguides/MCP?hl=pt-br), consultados em 11 de novembro de 2026. ## Em síntese - Com a 1.0.0 (3/11/2026), o projeto deixou de ser experimental. A versão vigente em 11/11/2026 é a 1.1.0. - Oferece quatro relatórios (padrão, tempo real, funis e conversões) e leituras de configuração: contas, propriedade, eventos-chave, dimensões e métricas personalizadas, vínculos com o Google Ads e anotações. - Cada resposta de um relatório retorna até 250.000 linhas; volumes maiores são paginados. - Vem somente com leitura. Criar anotações, eventos-chave ou dimensões personalizadas exige ativar `--allow-write`, adicionar o escopo `analytics.edit` e ter o papel adequado na propriedade. - Requer um projeto do Google Cloud com duas APIs habilitadas, credenciais e Python 3.10 ou superior. ## O que é um servidor MCP e o que muda com a versão 1.0 MCP (*Model Context Protocol*) é um protocolo aberto que permite a um assistente de IA usar ferramentas externas. Um servidor MCP expõe essas ferramentas com nome, descrição e parâmetros, e o assistente decide quando chamá-las. Neste caso, as ferramentas consultam a Google Analytics Data API e a Google Analytics Admin API com as credenciais do usuário. Na prática, em vez de montar um relatório na interface ou escrever código contra a API, a pergunta vai para o assistente, que transforma o pedido em uma consulta, a executa e devolve o resultado. O projeto foi publicado como experimento em agosto de 2025 (versão 0.1.0). A versão 1.0.0, de 3 de novembro de 2026, o declara estável, segundo a [lista de versões do repositório](https://github.com/googleanalytics/google-analytics-mcp/releases). A 1.1.0, de 6 de novembro, adicionou intervalos por minuto no tempo real e as ferramentas opcionais de escrita de dimensões personalizadas e eventos-chave. ## O que ele pode fazer hoje ### Relatórios - **Relatório padrão (`run_report`).** Dimensões, métricas, filtros, ordenação e intervalos de datas. Cada resposta retorna até 250.000 linhas e pode ser paginada. - **Tempo real (`run_realtime_report`).** Os últimos 30 minutos, ou até dois intervalos por minuto dentro dessa janela. Serve para confirmar que uma campanha recém-ativada ou uma tag corrigida já está enviando dados. - **Funis (`run_funnel_report`).** Etapas definidas pelo usuário, detalhamento por uma dimensão, segmentos e análise da "próxima ação": o que as pessoas fazem depois de concluir ou abandonar o funil. Usa a versão alfa da Data API, portanto pode mudar. - **Conversões (`run_conversions_report`).** Custos de anúncios, conversões, retorno sobre o investimento em publicidade (ROAS) e modelo de atribuição, baseado em dados (`DATA_DRIVEN`) ou último clique (`LAST_CLICK`). [Seção para leitores com conta, nível C: https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/#bloque-1] ### Auditoria da configuração - Resumo das contas e propriedades às quais a credencial tem acesso. - Detalhes de uma propriedade. - Lista de eventos-chave. - Dimensões e métricas personalizadas. - Contas do Google Ads vinculadas. - Anotações da propriedade. Para uma auditoria, esta parte é tão útil quanto os relatórios: permite perguntar, por exemplo, quais eventos estão marcados como eventos-chave e se algum não registrou atividade nos últimos 30 dias. [Seção para leitores com conta, nível C: https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/#bloque-2] ### Configuração (somente com a escrita ativada) - Criar anotações na linha do tempo da propriedade. - Criar dimensões personalizadas (requer o papel de Editor). - Marcar um evento como evento-chave (requer o papel de Profissional de marketing ou Editor). Essas três ferramentas não ficam disponíveis se o servidor não for iniciado com a escrita ativada. ## Pré-requisitos - Um projeto do Google Cloud. - A Google Analytics Admin API e a Google Analytics Data API habilitadas nesse projeto. - Acesso à propriedade com, no mínimo, o papel de Leitor. - Credenciais com o escopo `https://www.googleapis.com/auth/analytics.readonly`. Para escrever, também `https://www.googleapis.com/auth/analytics.edit`. - Python 3.10 ou superior e `pipx` (ou `uv`) para executar o pacote `analytics-mcp`. ## Como instalar passo a passo 1. **Habilitar as APIs.** Pelo console do Google Cloud ou com a CLI do Google Cloud: ``` gcloud services enable analyticsadmin.googleapis.com analyticsdata.googleapis.com --project=ID_DO_PROJETO ``` 2. **Configurar as credenciais.** A opção mais direta são as credenciais padrão do aplicativo (ADC): ``` gcloud auth application-default login --scopes="https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform" ``` O comando informa o caminho do arquivo de credenciais que gera. Como alternativa, é possível usar uma conta de serviço, por personificação ou com um arquivo de chave, que recebe acesso à propriedade como qualquer usuário. 3. **Adicionar o servidor ao assistente.** No Claude Code: ``` claude mcp add analytics-mcp --scope user -e GOOGLE_APPLICATION_CREDENTIALS="CAMINHO_DO_ARQUIVO_JSON" -e GOOGLE_CLOUD_PROJECT="ID_DO_PROJETO" -- pipx run analytics-mcp ``` No Claude Desktop, no Cursor ou em outros clientes compatíveis, a configuração equivalente em JSON é: ``` { "mcpServers": { "analytics-mcp": { "command": "pipx", "args": ["run", "analytics-mcp"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "CAMINHO_DO_ARQUIVO_JSON", "GOOGLE_CLOUD_PROJECT": "ID_DO_PROJETO" } } } } ``` 4. **Verificar a conexão.** Reiniciar o cliente e pedir algo de baixo risco, por exemplo: "A quais contas e propriedades do Google Analytics eu tenho acesso?". Se a resposta listar as propriedades esperadas, a conexão funciona. O repositório também documenta a execução como servidor HTTP próprio, inclusive no Cloud Run, com OAuth integrado. O Google não oferece um servidor hospedado: cada equipe executa o seu. [Seção para leitores com conta, nível C: https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/#bloque-3] [Seção para leitores com conta, nível C: https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/#bloque-4] ## Prompts para começar - "Compare sessões e eventos-chave da Meta com os do Google Ads nos últimos 30 dias, em relação ao período anterior." O resultado depende de como o tráfego da Meta está marcado: sem parâmetros UTM consistentes, parte desse tráfego pode aparecer como referência ou direto. - "Mostre o funil de compra somente do tráfego pago. Em qual etapa mais pessoas desistem e o que fazem depois?" O assistente precisa definir um segmento de tráfego pago; convém pedir que informe a condição usada. - "O tráfego da campanha ativada hoje está chegando em tempo real?" - "Adicione uma anotação com a data de hoje: a estratégia de lances foi alterada para ROAS desejado." Só funciona com a escrita ativada. Em todos os casos, convém pedir ao assistente que mostre as dimensões, métricas, filtros e datas que usou. Um relatório correto com uma definição errada continua sendo um erro. ## Por que começar somente com leitura A escrita é ativada de propósito, com a opção `--allow-write` ou a variável de ambiente `ANALYTICS_MCP_ALLOW_WRITE`, e também exige o escopo `analytics.edit`. Mantê-la desativada no início tem três vantagens: - **Dano limitado.** Um pedido ambíguo não consegue criar eventos-chave nem dimensões. Um evento-chave muda o que os relatórios contam como conversão e, se a propriedade estiver vinculada, o que pode chegar ao Google Ads. - **Cotas limitadas.** As propriedades têm um número máximo de dimensões personalizadas. Criar uma de teste ocupa uma vaga. - **Processo.** Antes de delegar mudanças a um assistente, a equipe precisa definir quem as aprova e como são registradas. Quando a escrita for necessária, convém usar uma credencial separada, limitada às propriedades correspondentes, e começar pelas anotações, que não alteram os dados. [Seção para leitores com conta, nível C: https://cookingmetrics.com/pt/blog/mcp-google-analytics-ga4/#bloque-5] ## Limites que convém conhecer - **Documentação desalinhada.** Em 11 de novembro de 2026, a página do Google for Developers informa que o servidor está disponível somente para leitura e lista nove ferramentas; o repositório, na versão 1.1.0, inclui treze, três delas de escrita opcional. - **Funções em versão alfa.** Os funis e as anotações usam versões alfa das APIs do Google, que podem mudar. - **Cotas.** As consultas consomem a cota da Data API do projeto. Muitas perguntas encadeadas sobre intervalos amplos podem esgotá-la. - **Interpretação.** O servidor devolve dados; a conclusão é montada pelo assistente. Os números devem ser verificados antes de serem usados em uma decisão ou em um relatório para um cliente. As respostas do assistente valem tanto quanto a configuração da propriedade. Se os eventos, as conversões ou a atribuição de campanhas não estiverem bem definidos, o [autodiagnóstico de Google Analytics da CookingMetrics](https://cookingmetrics.com/pt/google-analytics-autodiagnostico/) ajuda a revisá-los antes de confiar em uma consulta automática. ## Leituras relacionadas - [MCP para Google Ads: conexão, eCommerce e leads B2B](https://cookingmetrics.com/pt/blog/mcp-google-ads/), o servidor equivalente para a conta de anúncios. - [O que aprendemos ao revisar nosso site para agentes de IA](https://cookingmetrics.com/pt/blog/medimos-nuestro-sitio-agent-ready/), sobre como a [CookingMetrics](https://cookingmetrics.com/pt/) preparou o site para agentes. ## Perguntas frequentes ### O MCP do Google Analytics modifica a propriedade? Não, a menos que a escrita seja ativada de forma explícita. Por padrão, ele só consulta relatórios e configuração. Com `--allow-write` e o escopo `analytics.edit`, pode criar anotações, eventos-chave e dimensões personalizadas, de acordo com o papel da credencial na propriedade. ### É preciso saber programar para usá-lo? Para consultá-lo, não: as perguntas são feitas em linguagem natural. A instalação, porém, exige trabalhar com o console do Google Cloud, a linha de comando e o arquivo de configuração do cliente de IA. ### O Google oferece um servidor hospedado? Não. O servidor é executado na máquina do usuário ou em uma infraestrutura própria, como o Cloud Run. O repositório documenta as duas opções. --- ## Sobre o autor **[Martín Garay](https://cookingmetrics.com/pt/quem-e-martin-garay/)** — Fundador da CookingMetrics Sou Martín Garay, fundador e Martech Advisor da CookingMetrics e diretor da Comissão de Tecnologia da Câmara Argentina de Comércio Eletrônico (CACE). Há mais de 20 anos trabalho com Analytics, desenvolvimento, SEO técnico e ecommerce: implemento a mensuração, encontro onde ela falha e a transformo em informação útil para decidir. ### Meu trabalho na Câmara Argentina de Comércio Eletrônico - **Diretor da Comissão de Tecnologia** (DESDE AGOSTO DE 2025): Coordeno a agenda da comissão com Gabriel Topola, subdiretor. Analisamos as plataformas e ferramentas de que um negócio online precisa para crescer: CMS, integrações, atendimento ao cliente e gestão omnicanal. - **Curadoria do fórum técnico** (IT CAMP · ECOMMERCE DAY ARGENTINA): Com a equipe de Eventos da CACE, monto a programação do IT Camp: palestras para equipes de sistemas e desenvolvimento sobre arquitetura de plataformas, código e boas práticas, com palestrantes que trabalham na implementação. - **Comissões de Marketing e Data Analytics** (DESDE 2016): Comecei na comissão de Marketing e ajudei a criar a de Data Analytics. Dei webinars de Google Analytics, incluindo a migração para o GA4, e colaborei na implementação do Google Analytics para o Hot Sale e o Cyber Monday. - **Dashboard de métricas para ecommerce** (PARA OS ASSOCIADOS): Com a comissão de Data Analytics e a equipe de Comunidade CACE, desenvolvemos um painel no Google Analytics e no Looker Studio para que cada associado consulte os indicadores-chave da sua própria loja. ### Palestras - [De SEO a GEO: o que é preciso para uma marca ser citada por um motor de respostas](https://www.youtube.com/watch?v=mlyjuSBdMzI) — ECOMMERCE DAY ARGENTINA 2026 · IT CAMP · 27 DE AGOSTO DE 2026 · CENTRO DE CONVENÇÕES BUENOS AIRES - [SEO para IA: como preparar uma marca para aparecer no ChatGPT e nos resumos com IA do Google](https://www.youtube.com/watch?v=4dI7jqnLg-M) — AI IN LATAM 2025 · BUENOS AIRES · MAIS DE 3.500 PARTICIPANTES E 100 PALESTRANTES, SEGUNDO A ORGANIZAÇÃO ### Perfis e links - [Perfil completo](https://cookingmetrics.com/pt/quem-e-martin-garay/) - [LinkedIn](https://www.linkedin.com/in/seospecialistmartingaray/) - [Instagram](https://www.instagram.com/garaymartin/) - [YouTube](https://www.youtube.com/@MartinGaray) - [martingaray.com.ar](https://www.martingaray.com.ar/) - [Diretor da Comissão de Tecnologia da CACE, a câmara de ecommerce da Argentina](https://cace.org.ar/pages/comision-de-tecnologia?utm_source=cookingmetrics.com&utm_medium=referral&utm_campaign=perfil-martin&utm_content=caja-autor) - [Dashboard de métricas para ecommerce, gratuito para associados da CACE](https://cace.org.ar/pages/dashboard-de-metricas?utm_source=cookingmetrics.com&utm_medium=referral&utm_campaign=perfil-martin&utm_content=caja-autor) --- ## Sobre a CookingMetrics A CookingMetrics oferece consultoria de Google Analytics, implementação de mensuração e SEO. Seu fundador, Martín Garay, tem mais de 20 anos de experiência em Analytics, desenvolvimento e ecommerce. O trabalho conecta os dados às decisões do negócio. ### Serviços - **[Auditoria de Google Analytics](https://cookingmetrics.com/pt/servicos/auditoria-ga4/)**: As compras ou a receita não batem com os dados da sua loja? Revisamos a mensuração e entregamos um plano de correção em 10 dias úteis. [Conheça o escopo da auditoria](https://cookingmetrics.com/pt/servicos/auditoria-ga4/). - **[Google Tag Manager](https://cookingmetrics.com/pt/servicos/gtm/)**: Os eventos deixaram de ser medidos após uma mudança no site? Revisamos tags, acionadores e versões para encontrar duplicações ou dados ausentes. [Consulte sobre auditoria e implementação do Google Tag Manager](https://cookingmetrics.com/pt/servicos/gtm/). - **[Mensuração do lado do servidor](https://cookingmetrics.com/pt/servicos/medicao-cookieless/)**: Avaliamos como enviar dados pelo seu servidor, respeitar o consentimento e evitar duplicações. [O que a mensuração server-side inclui](https://cookingmetrics.com/pt/servicos/medicao-cookieless/). - **[SEO técnico](https://cookingmetrics.com/pt/servicos/seo-tecnico/)**: Você migrou o site ou há páginas que não aparecem no Google? Revisamos rastreamento, indexação, estrutura e desempenho. [Como trabalhamos o SEO técnico](https://cookingmetrics.com/pt/servicos/seo-tecnico/). - **[SEO para buscas com IA (GEO)](https://cookingmetrics.com/pt/servicos/seo-ai-geo/)**: Revisamos se mecanismos de busca e assistentes conseguem acessar suas páginas e compreender o conteúdo. [O que podemos melhorar para a busca com IA](https://cookingmetrics.com/pt/servicos/seo-ai-geo/). ### Soluções - **[Autodiagnóstico de Google Analytics](https://cookingmetrics.com/pt/google-analytics-autodiagnostico/)** (Status: Disponível) - **[GA4 Report Generator](https://cookingmetrics.com/pt/produto/ga4-report-generator/)** (Status: Beta): Ferramenta em beta que já permite gerar relatórios do Google Analytics. Consulte os recursos disponíveis e o escopo para seu projeto. [Conheça o GA4 Report Generator](https://cookingmetrics.com/pt/produto/ga4-report-generator/). - **[IndexNow Connect](https://cookingmetrics.com/pt/produto/indexnow-connect/)** (Status: Disponível para Tiendanube): Comunica URLs novas, atualizadas ou excluídas aos mecanismos de busca que participam do IndexNow. [Como funciona o IndexNow Connect](https://cookingmetrics.com/pt/produto/indexnow-connect/). - **[Análise SEO IA](https://cookingmetrics.com/pt/produto/ai-seo-analysis/)** (Status: Em desenvolvimento): *Em breve.* Uma auditoria automatizada de como os assistentes de IA e os mecanismos de busca acessam e usam seu conteúdo. [Conheça a Análise SEO IA](https://cookingmetrics.com/pt/produto/ai-seo-analysis/). **Vamos conversar sobre sua mensuração:** [Agendar conversa](https://cookingmetrics.com/pt/quem-e-martin-garay/) · [CookingMetrics](https://cookingmetrics.com/pt/)