Google Ads MCP : installation et usage avec Claude

Par Amir N., éditeur de serveurmcp.com

Google publie en open source un serveur MCP pour Google Ads. Branché sur Claude, Cursor ou un autre client compatible, il vous permet d’interroger vos comptes publicitaires en langage naturel : campagnes actives, performances de la semaine, structure des données. Ce guide explique comment installer le MCP Google Ads, ce qu’il sait faire et les précautions à prendre avec vos données.

Google Ads MCP en bref

Éditeur : Google, dans l’organisation GitHub googleads ; le serveur est présenté dans la documentation développeur de l’API Google Ads.
Licence : Apache 2.0, code source ouvert.
Accès : lecture de vos données Google Ads, avec trois outils.
Installation : en local avec pipx (Python), ou déployé sur Google Cloud Run.
Authentification : identifiants Google (Application Default Credentials), fichier google-ads.yaml ou proxy OAuth.
Jeton développeur : plus nécessaire depuis le 9 septembre 2026.

Vous trouverez aussi le résumé du serveur dans notre fiche Google Ads MCP.

Ce que l’IA peut faire avec le MCP Google Ads

Le serveur expose trois outils :

search : récupère des informations sur un compte Google Ads, par exemple ses campagnes et leurs métriques.
get_resource_metadata : décrit un type de ressource de l’API, comme « campaign », et les champs disponibles pour les requêtes.
list_accessible_customers : renvoie les identifiants des comptes clients accessibles directement par l’utilisateur connecté.

Il fournit aussi des ressources de référence : le document de découverte de l’API, la liste des métriques, celle des segments et les notes de version. L’assistant s’en sert pour construire des requêtes valides sans que vous ayez à les écrire.

Le README propose des questions comme « Quels comptes clients puis-je consulter ? », « Combien de campagnes actives ai-je ? » ou « Comment se portent mes campagnes cette semaine ? ». Google conseille d’indiquer l’identifiant client dans la question : « Combien de campagnes actives ai-je pour le client 1234567890 ? ». Pour croiser ces chiffres avec votre trafic, voyez notre guide Google Analytics MCP.

Installer le serveur MCP Google Ads

1. Préparer le projet Google Cloud

Il vous faut un projet Google Cloud dans lequel l’API Google Ads (googleads.googleapis.com) est activée. Depuis la fin des jetons développeur, c’est ce projet qui porte votre niveau d’accès. L’activation de l’API donne un accès Test, limité à 15 000 opérations par jour sur des comptes de test. Pour lire des comptes réels, demandez au minimum l’accès Explorer depuis la page Google Ads API de la console Cloud : il est validé automatiquement dans la plupart des cas, jusqu’à 2 880 opérations par jour en production.

2. Installer pipx et s’authentifier

Le serveur se lance avec pipx, à installer avec Python. Pour un usage personnel, la méthode la plus simple passe par les Application Default Credentials, avec la portée adwords :

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

Notez le chemin affiché à la fin (« Credentials saved to file: … ») : il sert dans la configuration du client.

3. Configurer Claude Desktop ou Claude Code

Ajoutez ce bloc dans la configuration MCP de votre client :

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Le README cite encore une variable GOOGLE_ADS_DEVELOPER_TOKEN. Selon Google, le jeton est désormais facultatif et ignoré par l’API. Si vous passez par un compte administrateur, ajoutez GOOGLE_ADS_LOGIN_CUSTOMER_ID avec l’identifiant de ce compte dans env. Notre guide pour ajouter un serveur MCP à Claude montre où placer ce bloc, et le validateur de configuration MCP repère les erreurs de syntaxe.

4. Cursor, VS Code et Antigravity

Le même bloc fonctionne dans .cursor/mcp.json pour Cursor et dans .vscode/mcp.json pour VS Code avec Copilot. Le README fournit aussi une configuration pour Antigravity.

5. Déployer sur Cloud Run pour une équipe

Pour partager le serveur, Google documente un déploiement sur Cloud Run. Dans ce mode, l’authentification passe uniquement par un identifiant et un secret client OAuth (GOOGLE_ADS_MCP_OAUTH_CLIENT_ID et GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET), et les clients se connectent à une adresse se terminant par /mcp.

Limites et pièges à connaître

Pas de modification : aucun des trois outils ne crée ni ne modifie de campagne.
Accès Test par défaut : un projet sans accès production reçoit l’erreur CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION (API v25 et suivantes) sur un compte réel.
Vérification de la marque : les nouvelles demandes d’accès Basic et Standard l’exigent pour le projet Cloud, et l’accès Standard passe par un examen manuel.
Choix des outils : un fichier tools_config.yaml, ou la variable GOOGLE_ADS_MCP_TOOLS_CONFIG, définit les outils actifs ; un fichier indiqué mais absent ou invalide empêche le serveur de démarrer.

Sécurité et confidentialité

Google le rappelle dans le README : le serveur expose vos données à l’agent ou au modèle que vous y connectez. Vos coûts, vos performances et la structure de vos comptes sont donc transmis au fournisseur du modèle. Quelques réflexes :

Utilisez un compte Google qui n’accède qu’aux comptes publicitaires nécessaires.
Gardez le fichier d’identifiants hors de tout dépôt Git.
Sur Cloud Run, configurez le proxy OAuth, seule authentification prise en charge dans ce mode.
Sachez qu’un en-tête supplémentaire est ajouté à vos appels d’API pour aider Google à améliorer le produit.

Notre checklist de sécurité MCP reprend ces points pour tous vos serveurs.

Questions fréquentes

Le serveur MCP Google Ads peut-il modifier mes campagnes ?

Non. Ses trois outils (search, get_resource_metadata et list_accessible_customers) servent à lire des données et à décrire l’API. Pour changer un budget, une enchère ou une annonce, il faut passer par l’interface Google Ads ou par l’API directement.

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

Non. Google a mis fin aux jetons développeur le 9 septembre 2026 : l’accès est désormais géré par votre projet Google Cloud. Le jeton peut encore être envoyé, mais l’API l’ignore, et le serveur MCP a été mis à jour pour fonctionner sans.

Comment utiliser le MCP Google Ads avec Claude ?

Activez l’API Google Ads dans un projet Google Cloud, authentifiez-vous avec gcloud et la portée adwords, puis ajoutez le bloc de configuration du README dans Claude Desktop ou Claude Code. Posez ensuite vos questions en précisant l’identifiant client du compte.

Google Ads MCP est-il gratuit ?

Le serveur est open source, sous licence Apache 2.0. Vous avez besoin d’un compte Google Ads, d’un projet Google Cloud et d’un niveau d’accès à l’API adapté : Test pour les comptes de test, Explorer, Basic ou Standard pour les comptes réels.

Sources

Pages consultées le 23 octobre 2026.

Google Ads MCP : interroger vos campagnes avec Claude et l’IA (guide 2026)