Pour connecter Google Ads au Agent Development Kit, ajoutez un McpToolset avec StreamableHTTPConnectionParams pointant vers https://mcp.paidsync.ai/mcp et envoyez votre clé API PaidSync.ai dans l'en-tête Authorization. L'agent ADK peut alors appeler les outils PaidSync.ai pour Google Ads, Meta Ads et 12 autres plateformes.
Ce dont ADK a besoin
Les agents ADK utilisent un McpToolset pour joindre les serveurs MCP. Pour PaidSync.ai, il vous faut :
- Un McpToolset avec StreamableHTTPConnectionParams et l'URL de PaidSync.ai.
- Une clé API PaidSync.ai, créée dans votre tableau de bord et conservée dans une variable d'environnement.
- Un identifiant PaidSync.ai avec Google Ads connecté.
La documentation d'ADK montre des en-têtes dans les paramètres de connexion, et indique que McpToolset peut aussi gérer le renouvellement des jetons OAuth 2.0 via auth_scheme et auth_credential.
Comment ça marche
| Réglage | Valeur |
|---|---|
| Classe | McpToolset |
| Connexion | StreamableHTTPConnectionParams |
| URL | https://mcp.paidsync.ai/mcp |
| En-tête | Authorization: Bearer, depuis une variable d'environnement |
| Limite de la clé | Lectures et aperçus sur Google Ads |
Appliquer une modification Google Ads nécessite la connexion OAuth de PaidSync.ai, qu'une clé ne permet pas. Utilisez la clé pour les agents de reporting, et gardez une personne dans la boucle pour les modifications.
Google Ads vers Google ADK en 5 étapes
Suivez-les dans l'ordre. Le bloc de code contient la configuration exacte issue de la documentation des outils MCP de Google ADK.
Connecter Google Ads à PaidSync.ai
Inscrivez-vous sur paidsync.ai et connectez Google Ads sur l'écran de connexion de Google.
Créer une clé API
Créez une clé dans votre tableau de bord et exportez-la sous PAIDSYNC_API_KEY. Ne la mettez jamais dans l'URL.
Ajoutez le toolset
Ajoutez le McpToolset du bloc ci-dessous aux outils de votre LlmAgent.
Lancez l'agent
Démarrez l'agent avec adk run ou l'interface web et posez une question sur votre compte.
Vérifiez l'appel d'outil
Confirmez dans le journal des événements qu'un outil PaidSync.ai a bien été exécuté.
Agent ADK avec PaidSync.ai
import os
from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
root_agent = LlmAgent(
model="gemini-flash-latest",
name="ads_analyst",
instruction="Answer questions about the user's ad accounts with PaidSync tools.",
tools=[McpToolset(connection_params=StreamableHTTPConnectionParams(
url="https://mcp.paidsync.ai/mcp",
headers={"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
))],
)Comment vérifier la connexion
Commencez par une question en lecture seule, comme la liste des comptes, et vérifiez l'appel d'outil dans le journal des événements.
Comment PaidSync.ai vous protège
- Les clés restent hors des URL. La clé passe dans un en-tête, depuis une variable d'environnement.
- Les rapports ne changent rien. Les rapports de budget gaspillé et de performance ne font que lire votre compte.
- Connexion pour les modifications. Une clé ne peut pas appliquer de modification Google Ads.
- Un journal des changements. Les changements appliqués sont consignés, au mieux, avec un résultat avant et après.
La configuration suit la documentation ADK de Google, vérifiée le 24 octobre 2026. Source : documentation des outils MCP de Google ADK. Tous les outils Google Ads figurent sur la page du serveur MCP Google Ads, et la liste complète des clients se trouve sur Connectez vos publicités.
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.
Questions fréquentes
Les agents Google ADK peuvent-ils utiliser des serveurs MCP ?
Oui. Le McpToolset d'ADK connecte un agent à des serveurs MCP distants via Streamable HTTP.
ADK a-t-il besoin d'OAuth pour PaidSync.ai ?
Pas pour les rapports. Un en-tête Bearer avec une clé API fonctionne. ADK documente aussi la prise en charge d'OAuth via auth_scheme.
Un agent ADK peut-il modifier mon compte Google Ads ?
Avec une clé, il lit et prévisualise. Appliquer une modification Google Ads exige la connexion OAuth.
Cela fonctionne-t-il pour Meta Ads ?
Oui. Le même serveur expose les outils Meta Ads. Voir la page du serveur MCP Meta Ads.
Combien cela coûte-t-il ?
PaidSync.ai est gratuit pour 100 tâches par mois, d'une valeur de $50, sans carte. Pro démarre à $99 par mois. Voir les tarifs.
Guides associés
PaidSync.ai exécute 630+ outils sur 14 plateformes publicitaires et analytiques. Connectez vos comptes une seule fois et utilisez-les dans l'assistant IA dans lequel vous travaillez déjà.
Essai gratuit Réserver une démo