Connecter Google Ads à Claude Code en une commande
Claude Code
Pour connecter Google Ads à Claude Code, ajoutez PaidSync.ai : lancez claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, tapez /mcp et connectez-vous avec vos identifiants PaidSync.
Claude Code accède alors à vos comptes Google Ads via 158 outils : audits, termes de recherche, mots clés, budgets, enchères, création de campagnes. Claude Code demande avant chaque outil, et la plupart des écritures Google Ads passent d'abord en simulation.
Une commande. OAuth, sans clé. Gratuit : 100 tâches/mois, valeur $50, sans carte.
La commande
Claude Code parle aux serveurs MCP distants via Streamable HTTP. PaidSync en fait partie. Ajoutez-le une fois et le même terminal qui modifie votre code peut lire et modifier vos comptes Google Ads.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPar défaut, cela enregistre le serveur pour le projet courant seulement. Ajoutez --scope user pour le rendre disponible dans tous les projets de votre machine.
Exécutez claude mcp list pour confirmer qu'il est là, puis lancez une session et tapez /mcp pour vous connecter.
Configuration en 5 étapes
1Inscrivez-vous sur paidsync.ai/signup
Cela prend 10 secondes. Connexion avec Google ou e-mail. Le forfait gratuit offre 100 tâches par mois à $0, sans carte.
2Connectez Google Ads dans le tableau de bord PaidSync
Cliquez sur Connecter pour Google Ads et connectez-vous avec le compte Google qui peut accéder à vos comptes publicitaires. Google Ads s'autorise via Google OAuth. PaidSync stocke les jetons chiffrés au repos avec AES-256-GCM et ne voit jamais votre mot de passe Google.
Déjà dans Claude Code ? Demandez-lui d'exécuter connect_google_ads. L'outil renvoie un lien OAuth à ouvrir dans votre navigateur.
3Choisissez les comptes que Claude Code doit voir
Après la connexion, PaidSync liste les comptes Google Ads auxquels cet identifiant donne accès. Cochez ceux qui appartiennent à cet espace de travail. Dans une session, list_accounts les affiche et set_active_account choisit celui sur lequel Claude Code travaille.
4Ajoutez PaidSync à Claude Code
Dans votre terminal, lancez :
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpDémarrez une session, tapez /mcp, choisissez paidsync et connectez-vous avec votre compte PaidSync dans la fenêtre du navigateur qui s'ouvre. Claude Code stocke le jeton OAuth pour vous. Aucune clé n'est collée nulle part.
Vous configurez pour une équipe ? Validez un .mcp.json à la racine du dépôt pour que chaque ingénieur ait le même connecteur :
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Vous préférez une clé API, par exemple pour des exécutions sans interface ? Envoyez-la dans un en-tête, jamais dans l'URL, où elle finirait dans les journaux :
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Dans un .mcp.json validé, ajoutez "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } pour que la clé reste dans l'environnement de chaque ingénieur et n'entre jamais dans git. Appliquer un changement à Google Ads exige toujours la connexion OAuth. Sur les autres plateformes, une clé peut aussi appliquer des changements, donc traitez-la comme un mot de passe et préférez OAuth.
5Testez la connexion
Dans une session Claude Code, demandez : “Montre-moi les performances Google Ads des 7 derniers jours par campagne”
Claude Code renvoie impressions, clics, coût et conversions pour chaque campagne du compte actif. La connexion est active.
Le forfait gratuit comprend 100 tâches par mois. Pro à partir de $99 par mois, Team à partir de $249.
Prompts Google Ads dans Claude Code
Chaque prompt ci-dessous correspond à des outils du groupe Google Ads de PaidSync. Claude Code choisit l'outil. La dernière colonne indique si l'appel peut modifier quelque chose dans le compte.
| Demande | Outils appelés | Modifie votre compte ? |
|---|---|---|
| “Audite le compte et liste les cinq corrections avec le plus de dépenses derrière” | run_account_audit | Non |
| “Montre les performances des campagnes sur 30 jours triées par coût, avec les conversions” | get_campaign_performance | Non |
| “Quels termes de recherche ont dépensé de l'argent ce mois-ci sans aucune conversion ?” | get_search_terms_report, get_wasted_spend_report | Non |
| “Décompose les termes de recherche des 30 derniers jours en n-grammes et suggère des négatifs” | analyze_search_term_ngrams | Non |
| “Ajoute ces cinq termes comme négatifs en requête large de type expression sur la campagne Brand” | add_negative_keywords | Oui, après votre confirmation |
| “Réduis le budget quotidien de la campagne Generic de 20 pour cent” | update_campaign_budget | Oui, après votre confirmation |
| “Mets en pause chaque campagne qui a dépensé de l'argent la semaine dernière sans conversion” | get_campaign_performance, pause_campaign | Oui, après votre confirmation |
| “Construis une campagne Search en pause pour la nouvelle gamme de produits” | create_search_campaign | Oui, après votre confirmation |
Exécuter sans interface avec claude -p
L'option -p lance Claude Code sans la session interactive. Connectez-vous une fois via /mcp et le jeton OAuth stocké est repris. Un rapport qui atterrit dans un fichier ressemble à ceci :
claude -p "Pull last 7 days Google Ads performance by campaign and flag any campaign that spent money with zero conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/google-ads-$(date +%F).jsonLes lectures s'exécutent directement, et les écritures aussi. --allowedTools "mcp__paidsync" autorise tous les outils PaidSync, écritures comprises, sans invite.
Pour une tâche sans surveillance, n'autorisez que les outils de lecture nécessaires, chacun par son nom sous la forme mcp__paidsync__tool_name.
Ce qui se lit et ce qui s'écrit
Sur les 158 outils Google Ads, 64 ne font que lire et 94 peuvent écrire.
Lire la suite
Les lectures couvrent la performance, les mots clés, les termes de recherche, le Quality Score, les auction insights, le rythme de budget et l'historique des modifications, via des outils comme get_keyword_performance, get_quality_score_report, get_auction_insights, get_budget_pacing et get_change_history.
Les écritures couvrent budgets, enchères, mots clés, négatifs, annonces, extensions, audiences et création de campagnes. Les outils de création Google Ads et la plupart des autres écritures sont prévisualisés par défaut avec dry_run, donc le premier appel montre la modification et un second appel l'applique.
Via MCP, l'étape d'approbation est l'invite propre à Claude Code. Il demande une confirmation avant d'exécuter un outil, sauf si vous l'avez autorisé avec --allowedTools ou dans vos paramètres. PaidSync ajoute des contrôles de son côté. Les suppressions, mises en pause et changements de budget exigent confirm_destructive, et un contrôle de règles avant écriture bloque les arguments dangereux. La carte d'approbation, et l'annulation sur une carte appliquée dont la modification a un inverse sûr, ne s'appliquent que dans l'espace de travail PaidSync.
Ajouter à ChatGPT : ouvrez PaidSync.ai dans l'annuaire des plugins de ChatGPT, installez-le, puis connectez-vous.
Ajouter à Claude : ouvrez PaidSync.ai dans l'annuaire des connecteurs de Claude, cliquez sur Connecter, puis connectez-vous.
Limites à connaître
create_search_campaignconstruit une campagne Search uniquement en état de pause. Les partenaires de recherche et le Réseau Display sont désactivés au départ, le ciblage géographique est la présence uniquement, et les enchères sont en CPC manuel sauf si vous nommez une autre stratégie.- Une variation de budget de plus de 50 pour cent exige
confirm_large_changeen plus deconfirm_destructive. Cette protection évite un budget multiplié par 10x par accident ou un budget mis à zéro. remove_campaignest définitif dans Google Ads. Une campagne supprimée ne peut pas être réactivée. Utilisezpause_campaignquand vous voulez seulement arrêter la diffusion.L'audit du compte couvre les 30 derniers jours et analyse le haut de chaque dimension par coût, donc les scores reflètent où va l'argent plutôt que chaque mot clé.
Le rapport de mots clés renvoie les 100 premiers mots clés et le rapport de Quality Score les 200 premiers.
Questions fréquentes
Comment connecter Google Ads à Claude Code ?
Inscrivez-vous sur paidsync.ai, connectez Google Ads via Google OAuth dans le tableau de bord, puis exécutez claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp dans votre terminal. Tapez /mcp dans une session, choisissez paidsync, et connectez-vous avec votre identifiant PaidSync.
Claude Code peut-il modifier mes campagnes Google Ads ?
Oui. Claude Code peut ajouter des négatifs, modifier des budgets, mettre en pause et activer des campagnes, et construire des campagnes Search en pause. Claude Code demande avant d'exécuter chaque outil, sauf si vous l'avez autorisé. La plupart des écritures sont d'abord prévisualisées en simulation, et les suppressions, mises en pause et modifications de budget exigent une confirmation explicite.
Cela fonctionne-t-il en mode sans interface avec claude -p ?
Oui. Une fois connecté via /mcp, claude -p réutilise le jeton OAuth stocké. Les lectures s'exécutent directement. Les écritures demandent de la prudence. Personne n'est là pour répondre à l'invite de Claude Code : tout outil d'écriture que vous avez autorisé avec --allowedTools s'exécute donc directement. Pour une tâche sans surveillance, n'autorisez que les outils de lecture nécessaires.
Ai-je besoin d'un jeton développeur Google Ads ?
Non. PaidSync est un serveur hébergé sur https://mcp.paidsync.ai/mcp. Vous vous connectez à Google Ads via Google OAuth dans le tableau de bord PaidSync et à PaidSync via /mcp dans Claude Code.
Est-ce gratuit ?
Oui. Le forfait gratuit est à $0 pour 100 tâches par mois sans carte. Pro démarre à $99 par mois et Team à $249 par mois. Claude Code lui-même nécessite un forfait Anthropic qui l'inclut.
158 outils Google Ads. Une commande dans Claude Code.