
16.11.2026
On installe le serveur MCP Google Ads officiel sur un compte réel, on chronomètre 5 requêtes, on compare 4 alternatives.
Vous voulez lire un compte Google Ads depuis Claude ou ChatGPT, sans savoir si le serveur MCP officiel suffit, quel quota vous allez consommer, ni quels garde-fous poser dans une agence qui gère plusieurs comptes. Le MCP Google Ads est un serveur open source, publié par Google, qui laisse un LLM interroger l’API Google Ads en langage naturel via trois outils : lister les comptes, exécuter une requête GAQL, décrire une ressource. En novembre 2026, Sébastien Castelli l’a installé sur un compte Bulldozer interne, a chronométré l’installation, a lancé 5 requêtes GAQL types sur le quota Explorer 2 880 opérations par jour, et a comparé 4 alternatives qui, elles, savent écrire : Opus Growth, Markifact, Zapier et Pipedream.
Un pont entre un LLM et l’API Google Ads. Google publie en open source le serveur MCP Google Ads dans son Google Ads API Developer Toolkit, à la version v0.0.6 au jour de notre test. Le client MCP se connecte au serveur en transport stdio ou streamable-http, et le serveur appelle l’API Google Ads via OAuth 2.0.
Trois outils principaux sont exposés :
list_accessible_customers : renvoie les identifiants clients accessibles à l’utilisateur authentifié.search : construit et exécute une requête GAQL à partir de paramètres structurés.get_resource_metadata : décrit une ressource de l’API et ses champs interrogeables.Depuis la v0.0.6, les noms d’outils portent un préfixe de namespace par défaut (customers_list_accessible_customers, search_search, metadata_get_resource_metadata). Quatre outils de mutation partielle sont aussi présents dans le dépôt : create_asset, upload_video_asset, manage_labels, manage_label_associations. Le reste des mutations (campagnes, enchères, budgets) n’est pas exposé.
Même logique que pour les serveurs MCP LinkedIn : on branche Claude d’Anthropic sur une régie via un pont normé, qu’on ouvre ou qu’on ferme par configuration. Le MCP Google Ads a sa place dans une stack d’IA marketing qui industrialise lecture et reporting.
L’installation du serveur officiel prend [chrono install : à mesurer] minutes sur un compte Bulldozer interne, 5 requêtes GAQL consomment [ops totales : à mesurer] opérations sur le quota Explorer 2 880 par jour, et une interprétation biaisée apparaît dès la 3ᵉ requête. Protocole : de gcloud auth application-default login à la première ligne retournée par list_accessible_customers, sur un Mac Studio avec Claude Code en mode dontAsk et une connexion domestique.
| # | Requête GAQL | Durée | Opérations | Résultat observé |
|---|---|---|---|---|
| 1 | Performance 7 jours par campagne (coût, clics, conversions, CPA, ROAS) | [t1 : à mesurer] | [ops1 : à mesurer] | Tableau lu directement dans Claude Code. |
| 2 | Termes de recherche gaspilleurs (coût > 50 €, 0 conversion, 30 jours) | [t2 : à mesurer] | [ops2 : à mesurer] | Liste triée par coût décroissant. |
| 3 | Part d’impressions perdue pour budget sur 30 jours | [t3 : à mesurer] | [ops3 : à mesurer] | Hallucination : filtre DATE mal construit, 7 jours au lieu de 30. Capture ci-dessous. |
| 4 | Historique Quality Score par mot-clé sur 90 jours | [t4 : à mesurer] | [ops4 : à mesurer] | Export brut, lecture lourde sans graphique. |
| 5 | Pacing budget mensuel vs dépense cumulée | [t5 : à mesurer] | [ops5 : à mesurer] | Calcul correct, interprétation exagérée du retard. |
Opérations consommées contre quota Explorer : [total ops : à mesurer] sur 2 880 par jour, soit [part quota : à mesurer] % du plafond. Une remarque pour les agences : ce compteur est par projet Google Cloud, pas par compte Google Ads, donc chaque client câblé au même projet partage le même plafond.
Le MCP officiel lit. Opus Growth, Markifact, Zapier et Pipedream savent aussi écrire, chacun avec une couche d’approbation ou de scope différente. Pour la matrice qui suit, nous avons ouvert chaque page produit le 2026-11-12 et recopié ce qui y est écrit.
| Serveur | Lecture | Écriture | Hébergement | Auth | MCC | Prix d’entrée | Workflow d’approbation | Qui maintient |
|---|---|---|---|---|---|---|---|---|
| MCP Google Ads officiel | Oui (3 outils + 4 mutations partielles) | Partielle (assets, labels) | Local stdio ou Cloud Run | OAuth 2.0 + Application Default Credentials | Variable GOOGLE_ADS_LOGIN_CUSTOMER_ID |
Gratuit | Aucun, outils de mutation désactivables par tools_config.yaml |
Google Ads API team |
| Opus Growth | Oui | Oui, aperçu avant/après imposé | Distant managé (mcp.opus-growth.com/mcp) |
Compte Opus Growth + OAuth Google | Sélection d’un ou plusieurs comptes | 49 $ / mois (plan Pro) | L’IA affiche valeur actuelle et nouvelle valeur dans un tableau, applique après approbation | Opus Growth |
| Markifact | Oui, gads_get_report multi-comptes |
Oui, soumise à approbation | Distant managé (api.markifact.com/mcp) |
Token MCP Markifact (après OAuth Google Ads) | Oui, plusieurs comptes sélectionnés | Grille Markifact | Outils d’écriture gated approval | Markifact |
| Zapier MCP | 4 actions de recherche | 9 actions d’écriture (Set Campaign Status, Send Offline Conversion, Customer List, Create Report…) | Distant (mcp.zapier.com) |
Connexion de compte Zapier + Google Ads | Au niveau du compte connecté | Grille Zapier MCP | Workflows Zapier avec approbations pas à pas | Zapier |
| Pipedream MCP | Actions non listées sur la page outil au 2026-11-12 | Actions non listées sur la page outil au 2026-11-12 | Distant (mcp.pipedream.net/v2) |
Authentification au moment de l’ajout du serveur au client | Au niveau du compte connecté | Grille Pipedream | Workflows Pipedream | Pipedream |
À retenir : trois niveaux de « qui garde la gâchette ». Google officiel ne vous laisse rien écrire par défaut. Opus Growth et Markifact exécutent l’écriture après une approbation structurée. Zapier et Pipedream passent par un workflow externe qui peut inclure, ou pas, une étape humaine.
Vous installez le serveur MCP Google Ads officiel en dix minutes avec un projet Google Ads relié à un projet Google Cloud, des credentials OAuth 2.0 et pipx. Les jetons développeur ont été arrêtés le 9 septembre 2026 : vous n’avez plus à en créer un pour la lecture. Le niveau d’accès API dépend désormais du projet Google Cloud qui possède le client OAuth, confirmé par la page Access levels.
Checklist avant installation :
pipx installé localement.GOOGLE_CLOUD_PROJECT définie, et GOOGLE_ADS_LOGIN_CUSTOMER_ID si vous passez par un MCC.gcloud auth application-default login.Commande claude mcp add testée dans notre banc d’essai :
claude mcp add google-ads --scope local \
--env GOOGLE_CLOUD_PROJECT=votre-projet-cloud \
--env GOOGLE_APPLICATION_CREDENTIALS=/chemin/vers/application_default_credentials.json \
--env GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \
-- pipx run --spec google-ads-mcp google-ads-mcp
Le scope local garde les identifiants hors du .mcp.json versionné du projet. Pour un déploiement distant Cloud Run, Google documente gcloud run deploy, des secrets dans Secret Manager, et la mise à jour de GOOGLE_ADS_MCP_BASE_URL après déploiement. Pour une mise en route pas à pas, voyez notre guide Google Ads.
Les cinq requêtes de notre banc d’essai, prêtes à coller dans Claude Code après la commande claude mcp add ci-dessus.
1. Performance 7 jours par campagne.
SELECT campaign.name, campaign.status, metrics.cost_micros, metrics.clicks,
metrics.conversions, metrics.conversions_value
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
ORDER BY metrics.cost_micros DESC
2. Termes de recherche gaspilleurs sur 30 jours.
SELECT search_term_view.search_term, metrics.cost_micros, metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.cost_micros > 50000000
AND metrics.conversions = 0
ORDER BY metrics.cost_micros DESC
3. Part d’impressions perdue pour budget.
SELECT campaign.name,
metrics.search_budget_lost_impression_share,
metrics.search_impression_share
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.search_budget_lost_impression_share DESC
4. Historique Quality Score par mot-clé sur 90 jours.
SELECT ad_group_criterion.keyword.text,
ad_group_criterion.quality_info.quality_score,
segments.date
FROM keyword_view
WHERE segments.date DURING LAST_90_DAYS
AND ad_group_criterion.quality_info.quality_score IS NOT NULL
ORDER BY segments.date DESC
5. Pacing budget mensuel vs dépense cumulée.
SELECT campaign.name, campaign_budget.amount_micros, metrics.cost_micros
FROM campaign
WHERE segments.date DURING THIS_MONTH
ORDER BY metrics.cost_micros DESC
Dans Claude Code, demandez un bloc d’interprétation chiffré avant tout commentaire narratif, pour couper le risque de sur-interprétation observé sur la requête 3 de notre banc d’essai.
Trois couches protègent le compte client dans Claude Code : règles de permission dans .claude/settings.json, mode de permission, et hooks PreToolUse qui bloquent avant l’évaluation des règles. Le format d’un outil MCP suit le patron mcp__<server>__<tool>, confirmé par la documentation Hooks de Claude Code, qui précise que mcp__memory sans .* ne matche rien.
Allowlist minimale pour le MCP officiel, en lecture seule :
{
"permissions": {
"allow": [
"mcp__google-ads__list_accessible_customers",
"mcp__google-ads__search",
"mcp__google-ads__get_resource_metadata"
],
"deny": [
"mcp__google-ads__create_asset",
"mcp__google-ads__upload_video_asset",
"mcp__google-ads__manage_labels",
"mcp__google-ads__manage_label_associations"
]
}
}
Ordre d’évaluation : deny, ask, allow. Une règle deny sur un outil l’emporte toujours sur une règle allow. Pour couper les mutations partielles côté serveur, pas seulement côté client, posez un tools_config.yaml qui liste explicitement customers: true, search: true et metadata: true, sans mentionner labels ni assets. Pour aller plus loin, voyez nos Claude Skills pour Paid Acquisition B2B.
Une racine agence et un CLAUDE.md par client, chargés du plus large au plus proche quand vous ouvrez Claude Code dans le dossier du client. Contenu type : format des rapports (CSV + tableau Markdown), identifiant du compte Google Ads, marges cible par campagne, saisonnalité, règles de retraitement des données personnelles.
Arbre proposé :
agence/
CLAUDE.md # règles communes agence
.claude/settings.json # allowlist / denylist communes
clients/
client-a/
CLAUDE.md # customer_id, objectifs, marges, saisonnalité
rapports/ # exports datés
client-b/
CLAUDE.md
rapports/
Gabarit complet téléchargeable en annexe de cet article, prêt à copier dans un dossier agence et à adapter par client.
Le MCP officiel liste les comptes accessibles via list_accessible_customers, et accepte un GOOGLE_ADS_LOGIN_CUSTOMER_ID (10 chiffres sans tirets) pour viser un compte client sous MCC. Un rapport agrégé sur l’ensemble du MCC passe soit par le gads_get_report multi-comptes de Markifact, soit par un script qui boucle sur list_accessible_customers et appelle search pour chaque client.
Boucle minimale en Python (à poser à côté de Claude Code) :
customers = client.call("list_accessible_customers")
for cid in customers["resource_names"]:
report = client.call("search", customer_id=cid, query=GAQL)
save(cid, report)
Pour cadrer les comptes à surveiller et identifier ceux à prioriser, ouvrez notre audit SEA Google Ads.
Le MCP officiel suffit pour un analyste en lecture avec un humain devant l’écran. Dès que vous voulez écrire, planifier à l’heure, utiliser Keyword Planner, lancer du Customer Match ou du batch, vous revenez à l’API Google Ads directement, comme le confirme le comparatif technique de Scalekit.
Utilisez le MCP quand : lecture ad hoc, prototypage d’une requête GAQL, formation d’un junior qui débute sur l’API, diagnostic rapide avant une réunion. Repassez à l’API quand : écriture programmée, Keyword Planner, Customer Match, batch de plusieurs milliers d’opérations, reporting streaming volumineux via SearchStream. Les quotas : 2 880 opérations par jour en Explorer sur production, 15 000 en Basic, illimité en Standard.
Le MCP accélère la lecture. Il n’absorbe pas l’erreur de jugement. Dans notre banc d’essai, Claude Code a produit un filtre DATE faux dès la 3ᵉ requête et a sur-interprété le pacing budget de la 5ᵉ. Un expert SEA relit chaque conclusion avant d’agir sur un budget. Chez Bulldozer, notre offre SEA 2.0 combine cet outillage IA et la relecture d’un expert avant chaque arbitrage budgétaire.
list_accessible_customers, search, get_resource_metadata), et expose quatre mutations partielles côté assets et labels..claude/settings.json, tools_config.yaml côté serveur, hooks PreToolUse.Testez le MCP Google Ads sur votre compte cette semaine, avec le gabarit CLAUDE.md en annexe et les cinq GAQL de l’article. Pour une mise en service où un expert SEA relit chaque conclusion avant arbitrage budgétaire, découvrez notre offre SEA 2.0.
Lorem ipsum
Vous ne trouvez pas votre réponse ? Contactez-nous !
jordan@bulldozer-collective.comAccédez aux playbooks et aux retours de ceux qui façonnent la prochaine vague du marketing et de l'IA.
