Claude MCP Google Ads : setup complet pour connecter Claude à votre compte

Mise à jour du 18 octobre 2026 : d'après la page de Google sur son serveur MCP, les jetons développeur ont été arrêtés le 9 septembre 2026 et ne sont plus requis dans la dernière version du serveur. Ce guide ne les demande donc plus. Le guide Claude Code et Google Ads dans le terminal reprend la configuration actuelle.

Pourquoi connecter Claude à Google Ads via MCP

Interroger Claude sur vos campagnes Google Ads sans connexion directe revient à lui demander d'analyser un rapport qu'il ne voit pas. Le protocole MCP (Model Context Protocol), développé par Anthropic, résout ce problème : il permet à Claude d'appeler la Google Ads API en temps réel, de récupérer vos données et d'agir dessus depuis une conversation ou un Skill.

Résultat concret : vous pouvez demander à Claude "quels sont mes 10 search terms les moins pertinents ce mois-ci ?" et obtenir une réponse avec les données réelles de votre compte, sans export CSV, sans outil tiers.

Pour une vue d'ensemble de ce que permettent les Skills Claude pour le media buying, voir notre article pilier : Claude Skills Google Ads et Meta Ads : le guide complet.

Prérequis : accès à la Google Ads API

Avant de configurer le MCP, vous avez besoin de trois éléments côté Google :

1. Un accès Google Ads aux comptes que vous souhaitez interroger. Un compte manager (MCC) n'est pas exigé par la page de Google : elle indique seulement que, si vous accédez aux comptes par un compte manager, vous pouvez aussi renseigner GOOGLE_ADS_LOGIN_CUSTOMER_ID.
2. Un projet Google Cloud dont le niveau d'accès à l'API est Explorer, Basic ou Standard. D'après la page de Google, si votre projet n'a aucun de ces niveaux, il faut en demander un. Le jeton développeur n'est plus requis : Google l'a arrêté le 9 septembre 2026.
3. Des credentials OAuth 2.0. Créez une application dans la Google Cloud Console (type "Application de bureau"), activez l'API Google Ads, et récupérez votreclient_id, client_secret et un refresh_token via le flux OAuth.

La documentation officielle de l'authentification Google Ads API est disponible sur developers.google.com/google-ads/api/docs/oauth.

Option A : MCP Google Ads avec Claude Desktop

Claude Desktop supporte les serveurs MCP configurés dans un fichier JSON local. Voici comment procéder.

Étape 1 : installer un serveur MCP Google Ads

Google publie un serveur MCP Google Ads officiel, open source et en lecture seule, sur github.com/googleads/google-ads-mcp. Il expose trois outils : list_accessible_customers, search (requêtes GAQL) et get_resource_metadata. Il ne peut ni modifier une enchère, ni mettre en pause une campagne. L'exemple ci-dessous utilise ce serveur, écrit en Python :

pipx run google-ads-mcp

Si ce serveur ne correspond pas à vos besoins, vous pouvez en créer un minimal en Python avec le SDK MCP d'Anthropic et la librairie google-ads.

Étape 2 : configurer claude_desktop_config.json

Ouvrez votre fichier de configuration Claude Desktop. Sur macOS, il se trouve à :~/Library/Application Support/Claude/claude_desktop_config.json

Ajoutez votre serveur MCP dans la section mcpServers :

{
  "mcpServers": {
    "google-ads": {
      "command": "pipx",
      "args": ["run", "google-ads-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/chemin/vers/credentials.json",
        "GOOGLE_PROJECT_ID": "votre_projet_cloud",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

La ligne GOOGLE_ADS_LOGIN_CUSTOMER_ID est facultative : la page de Google la présente comme une variable que l'on peut ajouter lorsque l'on passe par un compte manager, et son exemple de configuration ne la contient pas. Retirez-la si vous n'en avez pas l'usage.

Le serveur s'authentifie via les Application Default Credentials de Google Cloud (gcloud auth application-default login avec le scope adwords, ou une clé de compte de service). Ne commitez jamais ces valeurs dans un dépôt Git. Utilisez des variables d'environnement ou un gestionnaire de secrets.

Étape 3 : vérifier la connexion

Relancez Claude Desktop. Dans une nouvelle conversation, demandez : "Liste mes campagnes Google Ads actives". Si le MCP est correctement configuré, Claude appellera votre serveur et retournera les données de votre compte.

Option B : MCP Google Ads avec Claude Code

Si vous utilisez Claude Code (l'interface CLI), la configuration MCP se fait via la commande claude mcp add, ou en éditant directement le fichier.mcp.json à la racine de votre projet (scope projet) ou votre configuration globale ~/.claude.json (scope utilisateur).

L'avantage de Claude Code : vous pouvez combiner le MCP Google Ads avec des Skills locaux (fichiers SKILL.md) pour créer des workflows d'analyse automatisés. Par exemple, un Skill /weekly-ads-report qui tire les données via le MCP, les analyse et génère un rapport Markdown.

Premiers appels MCP Google Ads utiles

Une fois le MCP configuré, voici les requêtes les plus rentables à tester en premier :

Analyse des search terms

"Récupère les 50 search terms avec le plus d'impressions et un taux de conversion sous 1% sur les 30 derniers jours pour le compte [ID]."

Claude interroge votre compte via le MCP, filtre les résultats et vous propose directement une liste de mots-clés négatifs à ajouter avec le raisonnement associé à chaque exclusion.

Audit de structure de campagnes

"Analyse ma structure de groupes d'annonces : identifie les groupes avec plus de 20 mots-clés actifs et ceux avec moins de 3 annonces."

Ce type de diagnostic prenait une heure dans l'interface Google Ads. Avec le MCP, il tourne en quelques secondes.

Suivi de budget et détection d'anomalies

"Compare mes dépenses journalières de cette semaine à la semaine précédente par campagne. Signale toute variation supérieure à 30%."

Couplé à une alerte automatique, ce skill Claude Google Ads remplace une surveillance manuelle quotidienne de vos comptes.

Pour préparer budgets et enchères avant le pic de novembre, voir Google Ads Black Friday 2026 : préparer et piloter.

MCP Google Ads vs scripts Python directs : lequel choisir ?

Les scripts Python Google Ads API (via google-ads SDK) restent utiles pour les actions à fort volume ou les traitements batch. Le MCP excelle sur les analyses conversationnelles, les diagnostics à la demande et les workflows qui mêlent données Ads et raisonnement contextuel.

Hybridez les deux : le MCP pour l'exploration et le diagnostic, les scripts pour les actions répétitives automatisées (ajout de négatifs en masse, ajustements de bids).

Pour connecter aussi Google Analytics à vos analyses, consultez notre article : Claude skill Google Analytics : récupérer et analyser vos données GA4.

Questions fréquentes sur le MCP Google Ads Claude

Le MCP Google Ads peut-il modifier mes campagnes ?

Non avec le serveur officiel de Google, qui est en lecture seule et n'expose aucune mutation. Un serveur MCP tiers peut exposer des outils d'écriture ; dans ce cas, la bonne pratique est de distinguer les opérations en lecture et en écriture et de demander une confirmation avant chaque modification.

Est-ce compatible avec Performance Max ?

Oui, en lecture : la Google Ads API expose les campagnes PMax (asset groups, search themes, insights d'audience, métriques), que le serveur officiel permet d'interroger. La modification des asset groups ne passe pas par ce MCP.

Faut-il Claude Pro ou Claude Max pour utiliser les MCP ?

Les MCP fonctionnent avec Claude Desktop (tout abonnement) et Claude Code. L'abonnement Max ou Pro améliore la fenêtre de contexte disponible, ce qui est utile quand vous chargez beaucoup de données Ads dans une même conversation.