adtestbench Higgsfield
FR

Google Ads MCP : comment connecter le serveur de Google à Claude

Par Alexandre S. Publié le Dernière vérification le

Google propose un serveur Google Ads MCP officiel. MCP (Model Context Protocol) est le standard qui permet à un assistant IA d'utiliser les outils d'un autre service. Avec ce serveur, Claude interroge votre compte publicitaire en langage courant. Google publie le code sur GitHub, et c'est à vous de l'exécuter.

Deux changements récents modifient la configuration. Google a supprimé les jetons de développeur le 9 septembre 2026 : il faut désormais un projet Google Cloud avec accès à l'API. Par ailleurs, la page développeur de Google, mise à jour le 30 octobre 2026, qualifie le serveur de « strictly read-only » (lecture seule stricte), alors que la version 0.0.6 du dépôt, publiée le 2 novembre 2026, ajoute quatre outils d'écriture.

Si vous cherchez une solution qui prépare les modifications sans passer par Python, Creatify en propose une sous le nom de Google Ads Agent.

Comment brancher un assistant IA sur un compte Google Ads
Accès Prix Ce qu'il fait Configuration
Serveur MCP de Google Aucun prix sur ses pages Lit via des requêtes ; écrit des assets et des libellés avec une étape de confirmation Python, projet Cloud, OAuth
Ads Advisor et Recommandations Gratuit dans Google Ads Suggère des exclusions, des budgets et des assets Aucune
Pipeboard Gratuit pour 30 exécutions d'outils par semaine ; Pro 29,90 $ par mois Serveur hébergé ; Google Ads occupe un emplacement de compte Connexion
Creatify Google Ads Agent Connexion gratuite ; fonctionne avec des crédits (10 gratuits par mois, offres payantes à partir de 15 $ par mois) Lit le compte, prépare les modifications pour validation, crée la publicité Connexion Google

Faites défiler sur le côté pour voir les 4 colonnes

Le serveur Google Ads MCP est-il en lecture seule ?

Par défaut, non, malgré la phrase affichée sur la page de Google.

Google Ads MCP server

Read-only. This implementation is strictly read-only. It cannot modify bids, pause campaigns, or create new assets.

Documentation développeur de l'API Google Ads sur le serveur MCP officiel, mise à jour le 30 octobre 2026, avant la version du 2 novembre. Google Ads API documentation, Google Ads MCP server,

Le README recense sept outils, dont trois en lecture : search, get_resource_metadata et list_accessible_customers.

Les quatre autres écrivent : create_asset, upload_video_asset, manage_labels et manage_label_associations. Chacun passe par une étape que Google appelle Propose and Confirm. L'outil renvoie d'abord une description de la modification et un checksum, un code lié à cette demande précise. Il ne s'exécute que si ce code lui revient après votre validation.

Aucun des sept ne peut modifier une enchère, mettre une campagne en pause ou changer un budget. Pour verrouiller le serveur en lecture seule, définissez labels: false et assets: false dans tools_config.yaml.

De quels accès le serveur a-t-il besoin ?

Il vous faut un projet Google Cloud avec accès à l'API Google Ads, une connexion OAuth et un identifiant Google qui voit le compte. OAuth, c'est la fenêtre « Se connecter avec Google ». La page sur les jetons de Google indique : « We sunset developer tokens on September 9, 2026 », et précise que les niveaux d'accès sont désormais « granted to your Google Cloud Console project ».

Niveaux d'accès à l'API Google Ads pour un projet Cloud
Niveau Accès à Opérations par jour Comment l'obtenir
Test Comptes de test uniquement 15 000 Automatique à l'activation de l'API
Explorer Test et production 2 880 en production Demande depuis la page API Overview
Basic Test et production 15 000 Demande depuis Explorer, après vérification de la marque
Standard Test et production Unlimited Demande depuis Basic ; audit manuel d'environ 10 jours ouvrés

Faites défiler sur le côté pour voir les 4 colonnes

Explorer autorise 2 880 opérations de production par jour, de quoi couvrir les rapports d'un seul compte. La page du serveur de Google exige Explorer, Basic ou Standard : un projet au niveau Test ne peut donc pas lire un compte réel.

Attention à un bug que Google signale : certains projets passés à un niveau supérieur après le 9 septembre reçoivent AUTHORIZATION_ERROR sur les appels de production. Google présente comme solution provisoire la création d'un nouveau projet Cloud avec une nouvelle demande Explorer, le temps que le correctif soit déployé.

Comment connecter Google Ads à Claude

Ces étapes suivent le README de Google, pour Claude Code. Le serveur tourne sur votre propre machine.

  1. Installez pipx, l'outil qui exécute le serveur, ainsi que l'outil en ligne de commande gcloud de Google, qui gère la connexion.
  2. Dans un projet Google Cloud, activez l'API Google Ads, puis demandez le niveau Explorer sur la page API Overview.
  3. Créez un client OAuth. Ajoutez le scope https://www.googleapis.com/auth/adwords à l'écran de consentement, et ajoutez-vous comme utilisateur test si l'état affiché est Testing. En mode Testing, les règles d'audience de Google n'autorisent que les utilisateurs test listés, et chaque connexion expire au bout de sept jours.
  4. Connectez-vous, puis copiez le chemin des identifiants affiché :
gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE
  1. Ajoutez le serveur sous mcpServers dans ~/.claude.json, ou dans le .mcp.json d'un projet. Le README de Google cite ~/.claude/settings.json, alors que la documentation MCP de Claude Code mentionne ces deux-là :
{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": ["run", "--spec", "git+https://github.com/googleads/google-ads-mcp.git", "google-ads-mcp"],
      "env": {
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}
  1. Vous passez par un compte administrateur (MCC) ? Ajoutez GOOGLE_ADS_LOGIN_CUSTOMER_ID au même bloc env.
  2. Redémarrez, puis demandez à Claude de lister les clients accessibles.

Avec Claude sur le web, le chemin est plus long. Un connecteur personnalisé exige une adresse de serveur accessible sur internet : il faut donc héberger celui-ci sur Cloud Run avec un client OAuth. Google déconseille de le déployer avec --allow-unauthenticated sans ce client, car n'importe qui pourrait alors utiliser le compte du conteneur.

Une précaution ne coûte rien. Le scope adwords couvre à la fois la lecture et les modifications : la limite de lecture seule se joue donc dans la liste des outils. Connectez-vous avec un identifiant Google dont le rôle Ads est Lecture seule, et les règles d'accès de Google bloquent les modifications de campagne au niveau du compte.

Que peut lire le serveur ?

Il lit tout ce que GAQL peut atteindre. GAQL (Google Ads Query Language) est le langage de reporting de Google, et Claude l'écrit pour vous. Campagnes, termes de recherche, budgets, statuts et historique des modifications sont tous accessibles via l'outil search.

Use the Google Ads server. For the last 30 days, list search terms with spend and no conversions.
Sort by spend, show the top 50, and give spend in my account currency. Change nothing.

Vérifiez les montants dans la réponse. L'API renvoie les sommes en micros, et la documentation de Google fixe un million de micros pour une unité de votre devise. Demandez à Claude de montrer une conversion avant de vous fier à un tableau.

Les données de votre compte transitent aussi par le modèle. Le README indique que le serveur « will expose your data to the Agent or LLM that you connect to it », ce qui compte pour les comptes clients.

Trois tâches à déléguer, trois à garder

C'est en lecture que ce serveur justifie sa configuration. Tout ce qui touche à l'argent reste entre vos mains, et les outils du serveur en sont de toute façon incapables.

Ce qu'il faut confier à un assistant IA dans Google Ads
Usage Qui s'en charge Pourquoi
Passer les termes de recherche au crible pour repérer les dépenses sans conversion Assistant Une lecture longue et répétitive sur tous les groupes d'annonces
Répartir la part d'impressions perdue entre budget et classement Assistant Une seule requête répond à « ai-je besoin de budget ou de meilleures annonces ? »
Expliquer une hausse du coût par vente à partir de l'historique des modifications Assistant Il aligne chaque modification avec sa date sur tout le compte
Ajouter des mots clés négatifs Vous Un mot clé négatif trop large peut bloquer des termes qui convertissent
Augmenter les budgets Vous Creatify signale les hausses supérieures à 20 %, car une forte variation oblige Smart Bidding à réapprendre
Modifier les enchères de mots clés Vous Avec un CPA cible ou un ROAS cible, la stratégie les ignore

Faites défiler sur le côté pour voir les 3 colonnes

Smart Bidding désigne les enchères automatiques de Google. Un mot clé négatif indique à Google de ne pas afficher votre annonce pour une recherche donnée.

Découvrir l'agent de Creatify À partir de 15 $ par mois · vérifié le

Le Google Ads Agent de Creatify prépare les modifications à votre place

Le Google Ads Agent de Creatify s'adresse à ceux qui veulent que la seconde moitié de ce tableau soit exécutée après un simple feu vert. Sa page de tarifs cite Ad Agent pour Meta, TikTok et AppLovin sans mentionner Google : vérifiez donc votre offre auprès de Creatify avant de payer.

Vous vous connectez avec Google, et les propriétaires ou administrateurs de votre espace Creatify choisissent les comptes, comptes administrateurs compris. L'agent passe par l'API officielle Google Ads.

Il lit les termes de recherche, la part d'impressions, le Quality Score, les statistiques d'enchères et 30 jours d'historique des modifications. Chaque pause, budget, mot clé ou exclusion apparaît ensuite sur une carte avec les valeurs avant et après, et s'exécute une fois que vous avez validé. Les cartes ignorées expirent au bout de 72 heures. Il ne supprime jamais rien.

Tableau des autorisations du Google Ads Agent de Creatify : campagnes, termes de recherche, part d'impressions, Quality Score et historique des modifications en lecture ; pauses, budgets, enchères de mots clés, exclusions et nouvelles campagnes Search après votre validation ; suppressions : jamais, il met en pause à la place
Ce que l'agent lit, ce qui attend votre validation et ce qu'il ne fait jamais Page Creatify Google Ads Agent, capturée le

La page de Creatify elle-même fixe trois limites. L'agent crée des campagnes Search et ajoute de nouvelles annonces à des groupes d'annonces existants, mais ne crée pas de campagnes Performance Max. Il ne prépare pas d'enchères de mots clés avec « Maximize conversions », le CPA cible ou le ROAS cible. Et les routines planifiées « ask before acting unless you choose otherwise » : ne touchez pas à ce réglage.

Creatify ne chiffre aucune action : l'agent « runs on credits ». Selon les utilisateurs, les crédits partent plus vite que les tarifs le laissent penser, et ils citent les exécutions de l'agent parmi les causes (15 sources sur 61 : Trustpilot, Reddit).

Creatify n'est pas le bon choix pour un compte uniquement Search sans projet vidéo. Creatify reconnaît lui-même que les Recommandations et Ads Advisor de Google font doublon avec son agent et sont « free inside Google Ads ».

Selon Creatify, l'agent apporte trois choses : il lit Google à côté de vos autres comptes publicitaires, explique les changements à partir de votre historique et crée de nouvelles publicités dans le même chat. Les media buyers IA compare l'ensemble du marché.

Visiter Creatify À partir de 15 $ par mois · vérifié le

La vidéo dans Performance Max, Demand Gen et YouTube

Sur la vidéo, l'agent de Creatify va plus loin que le serveur de Google. Il peut créer une vidéo et l'ajouter à un groupe d'assets Performance Max existant, après votre validation. Performance Max est la campagne multicanale de Google, et un groupe d'assets en est le lot de publicités.

Sa page ne mentionne ni Demand Gen ni les campagnes YouTube. Dans ces cas, créez le fichier dans Creatify et transférez-le vous-même. Demand Gen est la campagne de Google pour les publicités visuelles sur YouTube, Discover et Gmail, et ses règles vidéo sont strictes :

  • Les vidéos doivent déjà être sur YouTube. « You can't upload an offline video », mais une vidéo non répertoriée convient.
  • Le minimum est de 5 secondes, et « Videos shorter than 10 seconds won't serve on YouTube In-stream. »
  • Chaque annonce accepte de 1 à 5 vidéos, et Google recommande le format 1080 par 1920 pour YouTube Shorts.

Le serveur de Google aide désormais pour l'étape intermédiaire. En mode local, upload_video_asset envoie un fichier vidéo sur YouTube et create_asset l'enregistre comme asset, chacun derrière l'étape de confirmation. La liste d'outils ne permet pas de rattacher cet asset à une campagne : vous terminez dans Google Ads.

Créer une publicité vidéo dans Claude ou ChatGPT vous donne le fichier depuis un chat. Les publicités YouTube Shorts détaille ce format.

Ouvrir Creatify À partir de 15 $ par mois · vérifié le

Questions fréquentes sur le serveur Google Ads MCP

Faut-il encore un jeton de développeur pour Google Ads MCP ?

Non. Google a supprimé les jetons de développeur le 9 septembre 2026. L'accès dépend désormais du projet Google Cloud lié à votre connexion OAuth.

Le serveur Google Ads MCP est-il gratuit ?

Aucune des deux pages de Google n'indique de prix. Vous exécutez le code vous-même, et l'hébergement Cloud Run est facturé via votre compte Google Cloud.

Google Ads MCP peut-il mettre une campagne en pause ou modifier un budget ?

Non. Les sept outils du README exécutent des requêtes et gèrent les assets, les libellés et les envois de vidéos. Aucun ne modifie une enchère, le statut d'une campagne ou un budget.

Est-ce compatible avec l'application Claude comme avec Claude Code ?

Oui, mais avec plus de travail. Claude Code l'exécute en local depuis un fichier de configuration. L'application web de Claude exige que le serveur soit hébergé sur internet avec un client OAuth.

Une seule configuration peut-elle couvrir plusieurs comptes clients ?

Oui. Réglez GOOGLE_ADS_LOGIN_CUSTOMER_ID sur votre compte administrateur, et le serveur atteint les comptes placés dessous que votre identifiant peut voir.

D'autres pages pour les utilisateurs de Creatify, classées par usage, dans le dossier Creatify

Sources

  1. Google for Developers : Google Ads MCP server, qualifie le serveur de strictement en lecture seule, liste les prérequis, les modes de transport et la configuration ; mis à jour le 30 octobre 2026. Vérifié le
  2. Google Ads sur GitHub : google-ads-mcp README, sept outils dont quatre d'écriture, l'étape Propose and Confirm, le réglage en lecture seule et la configuration client. Vérifié le
  3. Google Ads sur GitHub : google-ads-mcp releases, version 0.0.6, 2 novembre 2026, ajoute la gestion des assets et des libellés. Vérifié le
  4. Google for Developers : Developer token, fin des jetons le 9 septembre 2026 ; niveaux d'accès rattachés au projet Google Cloud ; le bug AUTHORIZATION_ERROR. Vérifié le
  5. Google for Developers : Access levels and permissible use, Test, Explorer, Basic et Standard, avec leurs limites quotidiennes. Vérifié le
  6. Aide Google Ads : About access levels in your Google Ads account, les utilisateurs en lecture seule ne peuvent pas modifier les campagnes. Vérifié le
  7. Google for Developers : CampaignBudget, les montants sont exprimés en micros de la devise du compte. Vérifié le
  8. Aide Google Ads : About video assets specifications for Demand Gen campaigns, formats, limites de durée, hébergement YouTube et emplacements. Vérifié le
  9. Creatify : Google Ads Agent, ce qu'il lit, les cartes de validation, les types de campagne, les crédits, le doublon avec les outils gratuits de Google. Vérifié le
  10. Creatify : Creatify pricing, le tableau comparatif cite Meta, TikTok et AppLovin pour Ad Agent. Vérifié le
  11. Pipeboard : Pipeboard pricing, formules et emplacements ; Google Ads compte pour un emplacement. Vérifié le
  12. Centre d'aide Claude : Get started with custom connectors using remote MCP, comment ajouter un serveur distant à Claude. Vérifié le
  13. Documentation Claude Code : Connect Claude Code to tools via MCP, les serveurs MCP se trouvent dans ~/.claude.json ou dans le .mcp.json d'un projet. Vérifié le
  14. Aide de la console Google Cloud Platform : Manage App Audience, en mode Testing, seuls les utilisateurs test listés peuvent se connecter, et les autorisations expirent au bout de sept jours. Vérifié le
  15. Trustpilot, Reddit, G2 et Product Hunt : Creatify user reports, 61 sources publiques synthétisées, vérifiées le 28 septembre 2026. Vérifié le
Portrait d'Alexandre S.

Alexandre S.

Alexandre S. est stratège créatif en publicité et copywriter, avec dix ans d’expérience en marketing digital sur plusieurs canaux.