Connecter Google Ads à Claude Code avec une seule commande
Claude Code vit dans votre terminal: il n'y a pas d'écran de réglages de connecteurs sur lequel cliquer.
Ce qu'il vous faut avant de commencer: Claude Code installé et connecté sur une offre qui l'inclut (Claude Pro, Max, Team ou Enterprise) ou une facturation API Anthropic, une version raisonnablement récente, les serveurs MCP HTTP distants étant une capacité plus récente, et un compte Google qui a déjà accès au compte publicitaire à gérer. C'est toute la liste. Pas de developer token Google Ads à demander, pas de clé API à coller, rien à héberger, et l'essai gratuit commence dès votre autorisation, sans carte, avec 75 crédits qui n'expirent jamais.
Une ligne, claude mcp add --transport http opus-growth https://mcp.opus-growth.com/mcp, déclare Opus Growth comme serveur MCP distant, une seule validation OAuth relie votre compte Google Ads, et l'agent qui lit déjà votre base de code obtient les outils Google Ads, avec Meta Ads, Microsoft Advertising, TikTok et LinkedIn sur la même connexion.
Ce que vous pouvez faire
Une commande au lieu d'un écran de réglages
Toute l'installation tient en une ligne dans votre terminal: claude mcp add --transport http opus-growth https://mcp.opus-growth.com/mcp. La portée par défaut garde le serveur dans le projet où vous vous trouvez; ajouter -s user le rend disponible dans chaque projet de votre machine; -s project écrit un fichier.mcp.json partagé que vos collègues récupèrent avec un git pull. Rien à héberger, aucun paquet à installer, aucun processus proxy local à surveiller.
Votre compte publicitaire et votre dépôt dans le même contexte
C'est ce que seul un agent de code peut faire. Claude Code peut lire les événements de conversion que votre module analytics déclenche réellement et les comparer aux actions de conversion configurées dans Google Ads, vérifier les URL finales des annonces en ligne par rapport aux routes qui existent dans l'application, ou rapprocher les modèles de suivi des campagnes des conventions UTM de votre code. Un assistant dans le navigateur ne voit pas le dépôt; un connecteur de reporting ne voit pas le code.
Le travail récurrent sur le compte devient une ligne de cron
Le mode sans interface, claude -p, transforme les opérations publicitaires hebdomadaires en tâche planifiée: exporter les dépenses de la semaine dans un fichier markdown daté, le comparer à l'exécution précédente, déposer la synthèse dans une pull request. Un détail à connaître avant d'écrire cette entrée de cron: Claude Code n'approuve pas automatiquement les outils MCP en mode sans interface. Vous passez l'option --allowedTools et nommez les outils Opus Growth, ou leur préfixe commun, que l'exécution peut appeler. Autorisez les outils de reporting et la tâche tourne seule; laissez les outils d'écriture hors de la liste et aucune exécution planifiée ne peut toucher aux dépenses.
Des passes sur tout le compte administrateur, avec l'offre Agency
Les hiérarchies de comptes administrateur (MCC) sont gérées nativement via le login-customer-id: avec l'offre Agency, une seule demande peut balayer chaque compte client et revenir avec une réponse classée: suivi des conversions manquant, budgets qui dépassent leur rythme, campagnes sans annonce active. Dans un terminal, ce résultat est un fichier, un diff ou un tableau que vous pouvez commiter, pas une capture d'écran. Free et Pro sont volontairement limités à un seul compte publicitaire: les passes multicomptes sont une capacité Agency; les audits d'un seul compte fonctionnent avec toutes les offres.
Aucun identifiant publicitaire à proximité de votre dépôt
Le connecteur est hébergé et chaque développeur autorise son propre compte Google via OAuth: la seule chose qui arrive dans.mcp.json est une URL publique. Pas de developer token Google Ads à demander, pas de secret client, pas de fichier JSON de compte de service à ajouter au.gitignore en espérant que personne ne le commite par erreur.
Des garde-fous à la mesure d'un agent qui a déjà accès au shell
Claude Code peut modifier des fichiers et lancer des commandes, ce qui rend une autorité de dépense non protégée vraiment dangereuse. Chaque outil d'écriture répond donc d'abord par un aperçu à blanc et rien d'autre: quel compte, quel élément, la valeur actuelle, la valeur proposée, puis il s'arrête. La modification n'atteint la plateforme publicitaire qu'au second appel confirmé. Une seule modification ne peut jamais augmenter un budget de plus de 50 %, et chaque action appliquée est consignée dans un journal d'audit que vous pouvez relire plus tard. Cette validation vit dans le connecteur et non dans le client: elle tient de la même façon dans un terminal, un navigateur ou un éditeur.
Configurez en 60 secondes
- 1
Ajoutez le serveur avec une commande
Dans votre terminal, lancez: claude mcp add --transport http opus-growth https://mcp.opus-growth.com/mcp. La portée par défaut le déclare pour le projet en cours. Ajoutez -s user pour le rendre disponible dans tous les projets de votre machine, ou -s project pour créer un fichier.mcp.json que votre équipe peut commiter dans le dépôt.
- 2
Authentifiez-vous depuis la session
Lancez Claude Code, tapez /mcp, sélectionnez opus-growth et choisissez Authenticate. Claude Code ouvre une fois votre navigateur pour le processus OAuth hébergé: connectez-vous avec Google, validez l'accès et choisissez les comptes publicitaires avec lesquels le connecteur peut travailler. Vous travaillez en SSH sur une machine sans navigateur ? Copiez l'URL d'autorisation affichée dans un navigateur sur votre ordinateur portable, le retour se termine exactement de la même façon.
- 3
Vérifiez avant de faire confiance
Lancez claude mcp list et vérifiez qu'opus-growth apparaît comme connecté. Puis, dans la session, demandez-lui de lister vos comptes publicitaires. Si les noms des comptes reviennent, les outils Google Ads sont actifs pour cette session. Meta Ads, Microsoft Advertising, TikTok Ads et LinkedIn Ads sont sur le même connecteur mais chacun a sa propre connexion unique: demandez à l'agent de connecter ceux que vous utilisez.
- 4
Lancez une vraie tâche et enregistrez le résultat
Commencez par quelque chose que vous feriez sinon à la main: auditer les 30 derniers jours et écrire les constats dans un fichier du dépôt. Les lectures s'exécutent immédiatement. Dès que l'agent propose une modification, une baisse de budget, une liste de mots clés négatifs, un groupe d'annonces en pause, il affiche l'aperçu à blanc et attend votre confirmation dans le terminal.
Demandez en langage naturel
›Liste mes comptes Google Ads, puis écris dans reports/google-ads.md un tableau des performances des campagnes sur 30 jours avec dépenses, conversions et CPA.
›Compare les actions de conversion configurées dans mon compte Google Ads avec les événements de conversion que ce dépôt déclenche réellement, et dis-moi lesquelles ne se déclenchent jamais.
›Vérifie les URL finales de chaque annonce Search active par rapport aux routes de cette application et signale celles qui renverraient une 404 ou une redirection.
›Récupère les termes de recherche des 14 derniers jours, prépare une liste de mots clés négatifs en expression et montre-moi l'aperçu à blanc avant d'appliquer quoi que ce soit.
›Balaye les comptes clients sous mon compte administrateur à la recherche de suivi des conversions manquant et de campagnes sans annonce active, et écris les résultats dans un fichier CSV.
›Nos conventions UTM sont définies dans src/lib/analytics.ts: audite les modèles de suivi de mes campagnes en ligne par rapport à elles et liste chaque écart.
›Écris une entrée de cron qui lance claude -p chaque lundi, en n'autorisant que les outils de reporting Opus Growth, pour exporter les dépenses Google et Microsoft Ads de la semaine dans un fichier markdown daté.
La comparaison
| Opus Growth | claude.ai (navigateur) | |
|---|---|---|
| Où il tourne | Votre terminal, dans le projet sur lequel vous travaillez déjà. Pas d'onglet de navigateur, pas d'application séparée, pas de changement de contexte loin du code. | Un onglet de navigateur ou Claude Desktop. Idéal pour planifier, explorer et partager une conversation avec un collègue. |
| Comment le connecteur s'ajoute | Une commande: claude mcp add --transport http opus-growth https://mcp.opus-growth.com/mcp | Paramètres, puis Connectors, puis Add custom connector, et collez la même URL. Les connecteurs personnalisés sont disponibles avec Pro, Max, Team et Enterprise. |
| Authentification | Tapez /mcp dans la session, choisissez Authenticate, validez une fois dans un navigateur. Sur une machine sans interface ou en SSH, ouvrez plutôt l'URL affichée sur votre ordinateur portable. | Gérée dans le navigateur où vous êtes déjà connecté: un seul écran de validation, puis le choix de vos comptes publicitaires. |
| Partage en équipe | L'option -s project écrit un fichier.mcp.json que vous pouvez commiter; quiconque clone le dépôt obtient le serveur, et chacun autorise son propre compte Google. | Chacun ajoute le connecteur dans ses propres réglages. Rien à commiter, mais rien de partagé non plus. |
| Automatisation | claude -p rend le reporting scriptable une fois les outils de lecture autorisés avec --allowedTools: un audit hebdomadaire dans un fichier daté, un diff des dépenses dans une pull request. | Interactif par nature. Vous êtes présent à chaque étape, ce qui convient à l'analyse et devient fastidieux pour la répétition. |
| Ce qu'il voit en plus du compte publicitaire | Votre dépôt, votre shell, vos tests et vos journaux: il peut donc recouper le code de suivi, les routes et les conventions UTM avec la configuration des campagnes en ligne. | Seulement ce que vous tapez, collez ou importez dans la conversation. |
| Sécurité des écritures | Aperçu à blanc, confirmation explicite, journal d'audit, la même validation que décrite plus haut, imposée par le connecteur. | Identique, car le même serveur hébergé l'impose. |
| Pour qui | Les développeurs et les équipes SEA techniques qui veulent un travail sur le compte reproductible et scriptable à côté du code qui génère les conversions. | Les marketeurs qui font de l'analyse exploratoire, des revues hebdomadaires ou qui travaillent depuis un téléphone. |
Questions fréquentes
En deux étapes. D'abord, dans votre terminal, lancez: claude mcp add --transport http opus-growth https://mcp.opus-growth.com/mcp. Ensuite, lancez Claude Code, tapez /mcp, sélectionnez opus-growth et choisissez Authenticate: une fenêtre de navigateur s'ouvre pour le processus OAuth hébergé où vous vous connectez avec Google et choisissez les comptes publicitaires à rendre disponibles. La session a ensuite les outils Google Ads, sans clé API, sans developer token et sans serveur à faire tourner vous-même.
L'URL d'autorisation est affichée: vous l'ouvrez là où vous avez un navigateur, généralement sur votre ordinateur portable. Connectez-vous avec Google, validez l'accès, et le retour hébergé termine l'échange; la session du terminal récupère l'état connecté sans qu'aucun navigateur ne tourne sur la machine distante. C'est le chemin normal pour quiconque utilise Claude Code en SSH ou dans un conteneur de développement, et c'est précisément là qu'un serveur MCP distant hébergé l'emporte sur un serveur stdio auto-hébergé qui attend des fichiers d'identifiants locaux.
La portée locale, par défaut, garde le serveur dans le projet où vous vous trouvez. La portée utilisateur, avec -s user, le déclare une fois pour chaque projet de votre machine; c'est le choix habituel d'un freelance ou d'un marketeur interne seul. La portée projet, avec -s project, écrit un fichier.mcp.json que vous commitez: toute personne qui clone le dépôt obtient automatiquement la définition du serveur. Ce fichier ne contient qu'une URL publique: chaque collègue s'authentifie toujours avec son propre compte Google et ne voit que les comptes publicitaires qui lui ont été accordés, le commiter ne divulgue donc rien.
Vous lancez la commande d'ajout et l'étape Authenticate unique sur chaque machine ou image de conteneur, car Claude Code conserve le jeton de session du connecteur dans son propre magasin d'identifiants sur cette machine, jamais dans vos fichiers de projet. Ce qui arrive dans le dépôt est une URL, rien d'autre. Vos identifiants Google ne sont ni à un endroit ni à l'autre: les jetons Google restent chiffrés sur nos serveurs, un ordinateur perdu n'expose donc aucun compte publicitaire, et révoquer l'accès depuis la page de votre compte Google coupe tous les clients d'un coup. Le compte Opus Growth, l'offre et les comptes publicitaires connectés vous suivent intacts sur la nouvelle machine.
Pour le reporting, oui, avec une option. Les exécutions sans interface lancées avec claude -p n'approuvent pas automatiquement les outils MCP: vous utilisez --allowedTools pour nommer les outils Opus Growth que l'exécution peut appeler. Autorisez les outils de lecture (rapports de performances, termes de recherche, audits de compte) et un rapport hebdomadaire devient une tâche cron qui écrit un fichier puis s'arrête. Soyez réfléchi avec les outils d'écriture: l'aperçu à blanc est imposé par un paramètre de confirmation dans l'appel, un agent que vous avez explicitement autorisé pour les outils d'écriture peut donc aussi envoyer l'appel confirmé. Gardez les tâches planifiées en lecture seule et laissez un humain valider les modifications dans une session interactive.
Avec l'offre Agency, oui: les hiérarchies de comptes administrateur (MCC) fonctionnent via le login-customer-id, une seule demande peut donc parcourir chaque compte client autorisé et renvoyer une liste classée. Avec Free et Pro, le connecteur est limité à un seul compte publicitaire, le premier utilisé: une passe sur ces offres couvre donc ce compte seulement, et le travail multicompte est la raison d'être de l'offre Agency. L'avantage du terminal reste le même: le résultat arrive sous forme de fichier ou de CSV que vous pouvez comparer et commiter, pas d'un tableau de bord à capturer.
Les actions sont décomptées par appel d'outil, pondérées selon le coût. Construire une campagne Search compte 8, ajouter des mots clés 5, un audit de compte ou une passe du planificateur de mots clés 3, un rapport de performances ou de termes de recherche 2, lister les comptes 1, et connecter un compte ou consulter votre solde 0. 75 crédits représentent donc environ deux constructions complètes de campagne avec groupes d'annonces, mots clés et annonces, ou vingt-cinq audits de compte, ou trente-sept rapports de performances: assez pour prouver le fonctionnement sur un vrai compte, pas un mois d'opérations publicitaires en production. Ensuite, Pro coûte 49 $/mois et Agency 99 $/mois, facturés en USD, résiliables à tout moment; consulter les rapports dans l'espace client reste gratuit.
Oui. Opus Growth est un seul serveur MCP distant hébergé: l'autorisation faite dans Claude Code correspond au même compte et aux mêmes comptes publicitaires connectés que dans claude.ai, Cursor, VS Code, Windsurf, Codex ou Gemini CLI, seule la façon d'ajouter le connecteur change. Ce seul compte Opus Growth couvre Google Ads, Meta Ads, Microsoft Advertising, TikTok Ads et LinkedIn Ads, chacun connecté une fois depuis n'importe laquelle de ces applications, plus Google Tag Manager, GA4, Search Console et YouTube pour le contexte de mesure, issus du catalogue d'outils.
Non. Google Ad Manager est le serveur publicitaire côté éditeur, avec ordres, éléments de campagne et blocs d'annonces pour vendre l'inventaire de votre propre site, et nous ne le prenons pas en charge. Opus Growth connecte Google Ads, la plateforme côté annonceur où vous achetez des campagnes Search, Performance Max, Demand Gen et pour applications, comptes administrateur (MCC) compris. Si vous cherchiez Ad Manager mais pensiez au compte où vous dépensez sur des mots clés, vous êtes au bon endroit.
Explorer davantage
Une commande, une connexion, et l'agent qui livre votre code peut auditer le compte qui dépense pour lui. Lancez claude mcp add --transport http opus-growth https://mcp.opus-growth.com/mcp et commencez votre essai gratuit: 75 crédits qui n'expirent jamais, accès complet en écriture, sans carte.