Join Médicis
Serveurs MCP
G

MCP Google Ads

Serveur officiel publié par Google

Pose tes questions à ton IA en langage courant et elle va chercher la réponse directement dans tes campagnes Google Ads : performances, budgets, mots-clés, appareils.

  • Officiel
  • Gratuit (serveur open source, API Google Ads sans frais)
  • Lecture seule
  • Installation : Avancé
  • 30 min
InstallerGuide officiel de Google ↗GitHub ↗

✓ Fiche vérifiée par Join Médicis le 30 septembre 2026, d'après la documentation officielle.

Comment ça marche

Un MCP est un pont entre ton IA et un outil. Ici, en trois temps :

  1. 1

    Tu poses ta question : « Comment performent mes campagnes cette semaine ? »

  2. 2

    Ton IA appelle le serveur MCP, qui interroge l'API Google Ads à ta place.

  3. 3

    Elle reçoit les chiffres et te répond en clair, avec l'analyse en prime.

Ce que tu peux lui demander

Copie une de ces demandes dans ta conversation une fois le MCP installé.

  • « À quels comptes Google Ads ai-je accès ? »

    Le bon premier test : vérifie que la connexion marche.

  • « Combien de campagnes actives ai-je sur le compte 1234567890 ? »

    Un inventaire rapide, sans ouvrir l'interface.

  • « Comment ont performé mes campagnes cette semaine par rapport à la semaine dernière ? »

    Ton point hebdo en une phrase.

  • « Donne-moi les 5 campagnes qui ont le plus dépensé ces 7 derniers jours, ventilées par appareil, pour le compte 1234567890. »

    Repère où part ton budget, mobile ou desktop.

  • « Quelles campagnes ont un coût par conversion 30 % au-dessus de la moyenne du compte ce mois-ci ? »

    Trouve les campagnes qui gaspillent ton budget.

  • « Liste les mots-clés qui ont dépensé plus de 100 € ce mois-ci sans générer de conversion. »

    Le classique à couper en priorité.

Ton IA a besoin du numéro client du compte (10 chiffres, affiché en haut de l'interface Google Ads). Si tu gères plusieurs comptes, indique-le directement dans ta question.

Avant de commencer

Il faut un projet Google Cloud, des identifiants OAuth et quelques commandes à lancer. Compte 30 à 45 minutes la première fois, ou demande un coup de main à un développeur.

  • Un accès à un compte Google Ads

    Avec le compte Google que tu utiliseras pour te connecter.

  • Un projet Google Cloud avec l'API Google Ads activée

    Le projet doit disposer d'un niveau d'accès à l'API « Explorateur », « Basique » ou « Standard » (page Vue d'ensemble de l'API Google Ads, dans la console Google Cloud). Sinon, demande-le depuis cette même page.

  • Des identifiants OAuth

    Un client OAuth 2.0 (ID + code secret) téléchargé en fichier JSON, ou des identifiants par défaut de l'application (ADC).

  • Pour une installation locale : Python et pipx

    pipx lance le serveur sans rien installer à la main. Voir pipx.pypa.io pour l'installer sur ton ordinateur.

  • Plus besoin de jeton développeur

    Les jetons développeur ont été abandonnés le 9 septembre 2026 : les niveaux d'accès sont désormais liés au projet Google Cloud.

Installer, selon ton interface

Étape 0, commune à toutes les interfacesPréparer tes identifiants Google (une seule fois)

Cette étape est commune à toutes les interfaces. Elle crée un fichier d'identifiants que le serveur utilisera pour lire tes données.

  1. 1

    Dans la console Google Cloud, active l'API Google Ads pour ton projet (Bibliothèque d'API → Google Ads API → Activer).

  2. 2

    Crée un client OAuth (type application de bureau) et télécharge son fichier JSON.

  3. 3

    Installe l'outil gcloud, puis connecte-toi avec le bon périmètre d'accès (remplace le nom du fichier) :

    gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=TON_FICHIER_CLIENT.json
  4. 4

    Note le chemin affiché à la fin (« Credentials saved to file: … ») : tu en auras besoin à l'étape suivante.

Tu utilises quoi ?

Installer sur Claude Desktop

Sur ton ordinateur
  1. 1

    Termine la préparation des identifiants ci-dessus.

  2. 2

    Dans l'application Claude Desktop : Réglages → Développeur → Modifier la configuration.

  3. 3

    Colle ce bloc dans le fichier (remplace l'ID de projet et le chemin du fichier d'identifiants), puis enregistre :

    {
  "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": "TON_ID_DE_PROJET",
        "GOOGLE_APPLICATION_CREDENTIALS": "/chemin/vers/credentials.json"
      }
    }
  }
}
  4. 4

    Quitte complètement Claude Desktop et relance-le.

C'est bon si… « google-ads-mcp » apparaît dans la liste des outils de la conversation. Demande : « À quels comptes Google Ads ai-je accès ? »

Ce que ton IA peut faire avec

  • Lecture

    Lister tes comptes

    Retrouve les numéros client et les noms des comptes Google Ads auxquels tu as accès.

  • Lecture

    Interroger tes données

    Récupère métriques, budgets et état des campagnes, groupes d'annonces, mots-clés… via le langage de requête de Google Ads (GAQL), que l'IA écrit pour toi.

  • Lecture

    Comprendre la structure des données

    Consulte les champs disponibles (métriques, segments) pour construire la bonne requête.

Ce qu'il ne fait pas

  • Il ne modifie rien : pas de changement d'enchères, pas de mise en pause de campagne, pas de création d'annonce.
  • Il ne voit que les comptes auxquels ton compte Google a déjà accès.
  • Pour les comptes gérés depuis un compte administrateur (MCC), il faut préciser son numéro (variable GOOGLE_ADS_LOGIN_CUSTOMER_ID).

Les outils du serveur

7 outils et ressources, que ton IA découvre et appelle toute seule.

  • Comptes (1)

    • list_accessible_customersListe les numéros client et les noms des comptes Google Ads accessibles.

  • Recherche (1)

    • searchExécute une requête GAQL : métriques, budgets, état des campagnes et des annonces.

  • Métadonnées (1)

    • get_resource_metadataDécrit les champs disponibles d'un type de ressource (par exemple « campaign »).

  • Ressources de référence (4)

    • discovery-documentLa description complète de l'API Google Ads (ressources, méthodes, schémas).
    • metricsLes métriques disponibles pour le reporting.
    • segmentsLes segments disponibles (appareil, date, réseau…).
    • release-notesLes notes de version de la dernière API Google Ads.

Selon l'interface, les noms peuvent être préfixés par leur catégorie (ex. customers_list_accessible_customers, search_search). Les catégories s'activent ou se désactivent via le fichier tools_config.yaml du serveur.

Sécurité et données

  • Lecture seule : le serveur ne peut ni dépenser ni modifier quoi que ce soit dans tes comptes.
  • Les données récupérées sont transmises à l'IA que tu connectes (Claude, ChatGPT…) : vérifie ses règles de confidentialité avant d'y brancher des comptes clients.
  • Garde ton fichier d'identifiants hors des dossiers partagés ou synchronisés, et ne le publie jamais sur GitHub.
  • Google ajoute un en-tête technique aux appels pour mesurer l'usage du serveur. Tu peux révoquer l'accès à tout moment depuis les autorisations de ton compte Google.

Ça ne marche pas ?

Le serveur n'apparaît pas dans mon IA

Vérifie que pipx est installé, que le fichier de configuration est un JSON valide (virgules, accolades), puis quitte et relance complètement l'application.

Erreur d'autorisation ou « permission denied »

Tes identifiants doivent inclure le périmètre https://www.googleapis.com/auth/adwords. Relance la commande gcloud de la préparation avec ce périmètre.

« The developer token is only approved for use with test accounts »

Ton projet n'a pas encore accès aux comptes réels. Demande le niveau d'accès « Explorateur » (ou supérieur) depuis la page de l'API Google Ads dans la console Google Cloud, et utilise la dernière version du serveur.

L'IA me demande sans cesse un numéro client

C'est normal : indique le numéro du compte (10 chiffres) directement dans ta question.

Aucune donnée sur un compte géré via un compte administrateur

Ajoute GOOGLE_ADS_LOGIN_CUSTOMER_ID avec le numéro du compte administrateur dans le bloc « env » de la configuration.

Toujours bloqué ? Signaler un bug (GitHub) · Discord Google Advertising · #ads-api-ai-tools

MCP Google Ads : questions fréquentes

Le MCP Google Ads peut-il modifier mes campagnes ?

Non. La version actuelle est strictement en lecture seule : elle ne peut ni changer les enchères, ni mettre en pause une campagne, ni créer d'annonce. Elle sert à analyser et à faire du reporting.

Est-ce que c'est gratuit ?

Oui. Le serveur est open source et publié par Google, et l'API Google Ads n'est pas facturée. Tu paies seulement ton abonnement à l'IA que tu utilises, et un éventuel hébergement si tu le déploies sur Google Cloud Run.

Faut-il un jeton développeur Google Ads ?

Plus depuis le 9 septembre 2026 : les jetons développeur ont été abandonnés et les niveaux d'accès à l'API sont désormais associés au projet Google Cloud. Il faut en revanche que ce projet ait un niveau d'accès Explorateur, Basique ou Standard.

Pourquoi l'installation est-elle plus simple sur Claude Desktop que sur Claude.ai ?

Le serveur tourne par défaut sur ton ordinateur. Claude Desktop, Gemini CLI, Claude Code, Cursor ou VS Code peuvent le lancer eux-mêmes. Les versions web (Claude.ai, ChatGPT, Vibe) ne peuvent se connecter qu'à un serveur accessible par une URL publique, qu'il faut d'abord héberger.

Mes données Google Ads sont-elles partagées ?

Elles sont transmises à l'IA que tu connectes, le temps de répondre à ta question. Join Médicis ne voit rien : tout se passe entre ton ordinateur, Google et ton IA. Vérifie les règles de confidentialité de ton IA avant d'y connecter des comptes clients.