Skip to content
Back to search

google-ads-mcp-cloud-run-guide

Guia prático para implantar o servidor oficial Google Ads MCP no Google Cloud Run, com OAuth 2.0, Secret Manager, testes e resolução de problemas.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alexandreninja--google-ads-mcp-cloud-run-guide/badge.svg)](/listings/alexandreninja--google-ads-mcp-cloud-run-guide)

HTML

<a href="/listings/alexandreninja--google-ads-mcp-cloud-run-guide"><img src="/api/listings/alexandreninja--google-ads-mcp-cloud-run-guide/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 54 lines
  1. # Google Ads MCP no Google Cloud Run
  2. [English](README.en.md) · [Documentação](docs/README.md) · [Licença MIT](LICENSE)
  3. <p align="center">
  4. <img src="docs/assets/github-header.svg" alt="Cliente MCP conectado ao servidor Google Ads MCP no Cloud Run e à Google Ads API" width="100%">
  5. </p>
  6. Este guia nasceu de um desafio no Sebrae Rio: modernizar os dashboards de marketing e explorar como a IA poderia ajudar a interpretar dados validados. Entre uma integração gerenciada e uma implantação própria, o experimento seguiu pelo servidor oficial [Google Ads MCP](https://github.com/googleads/google-ads-mcp), hospedado no Cloud Run.
  7. O repositório pode ser usado de forma independente. Para conhecer a motivação por trás dele, publiquei no LinkedIn o artigo [**Construir ou integrar? O que aprendi implementando um Google Ads MCP com Cloud Run e OAuth 2.0**](https://www.linkedin.com/pulse/construir-ou-integrar-o-que-aprendi-implementando-um-alexandre-ssyie). Nele, conto as decisões, os erros de autenticação e os aprendizados que deram origem a este guia. Essa leitura ajuda a compreender o contexto; **aqui, o percurso se transforma em um passo a passo**, pensado também para quem vem do marketing e está começando a trabalhar com nuvem e IA.
  8. ## 🧭 Comece por aqui
  9. | Quero… | Por onde seguir |
  10. | --- | --- |
  11. | Entender a escolha e os componentes | [Arquitetura](docs/ARCHITECTURE.md) · [STDIO ou HTTP?](docs/concepts/MCP-TRANSPORTS.md) |
  12. | Implementar, uma etapa por vez | [01 · Pré-requisitos](docs/getting-started/PREREQUISITES.md) → [02 · Implantação](docs/getting-started/DEPLOY.md) |
  13. | Aprender com um assistente de IA | [Prompt para seu assistente de IA](docs/guides/AI-TUTOR.md) |
  14. | Resolver um erro | [Diagnóstico por sintoma](docs/guides/TROUBLESHOOTING.md) |
  15. | Manter ou encerrar o laboratório | [Custos](docs/guides/COSTS.md) · [Operação e limpeza](docs/guides/OPERATIONS.md) |
  16. ## 🔎 O que você vai construir
  17. Um serviço HTTPS que permite a um cliente de IA consultar a Google Ads API por meio do MCP. O roteiro usa o **Cloud Shell**, terminal disponível no navegador, e organiza a implantação em etapas com checkpoints:
  18. 1. Preparar o projeto, os acessos e as identidades de build e execução.
  19. 2. Configurar o login Google com OAuth e guardar as credenciais no Secret Manager.
  20. 3. Construir a imagem, publicar no Cloud Run e conectar um cliente MCP.
  21. 4. Conferir as ferramentas disponíveis e validar uma consulta à conta autorizada.
  22. Essa integração cuida do **acesso aos dados**. Nesta arquitetura, cálculos e regras de negócio continuam em código e SQL; o modelo de linguagem ajuda na interpretação. Dashboards, pipelines e a integração ao fluxo corporativo são etapas de evolução.
  23. > [!IMPORTANT]
  24. > Antes de começar, confira os [pré-requisitos](docs/getting-started/PREREQUISITES.md): projeto com faturamento, permissões de implantação, acesso à API e à conta Google Ads. Os recursos podem gerar cobrança. Em ambiente institucional, combine essas liberações com a equipe responsável.
  25. ## 🧪 Aprenda fazendo
  26. Cada checkpoint diz o que conferir antes de avançar. Encontrou uma sigla nova? Consulte o [glossário](docs/GLOSSARY.md). Precisa acompanhar a navegação na tela? Os [vídeos em português](docs/guides/VIDEOS-PT-BR.md) complementam os passos escritos.
  27. Você também pode compartilhar este repositório com o **assistente de IA de sua preferência**, como ChatGPT, Codex, Claude ou Gemini, e pedir acompanhamento com o [prompt de tutoria](docs/guides/AI-TUTOR.md). Ele orienta a explicar os comandos e verificar os resultados com você. Use valores ocultados ao compartilhar erros ou configurações; mantenha credenciais fora da conversa.
  28. <details>
  29. <summary>Versão de referência e verificações do guia</summary>
  30. O roteiro fixa o commit `44ca7770519362c8f334875477e1ceb499f8d2dd` do servidor oficial. A [implantação](docs/getting-started/DEPLOY.md) explica como preparar essa origem; o [registro de revisão](docs/REVIEW.md) lista as verificações locais e o que ainda depende de teste no seu ambiente.
  31. </details>
  32. ## 📚 Para consultar
  33. [Índice completo](docs/README.md) · [Segurança](SECURITY.md) · [Fontes oficiais](docs/REFERENCES.md) · [Como contribuir](CONTRIBUTING.md)
  34. O guia e seus arquivos originais estão sob [licença MIT](LICENSE): você pode usar, estudar, adaptar e redistribuir, inclusive comercialmente, preservando o aviso de licença. O servidor é mantido pelo projeto oficial do Google e segue sua própria licença, descrita nos [avisos de terceiros](THIRD_PARTY_NOTICES.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.