Pour connecter Google Ads au Claude Agent SDK, ajoutez un serveur MCP http pour https://mcp.paidsync.ai/mcp avec votre clé API PaidSync.ai dans l'en-tête Authorization, et listez ses outils dans allowedTools. Votre agent peut alors appeler les outils PaidSync.ai pour Google Ads, Meta Ads et 12 autres plateformes.
Prérequis du Agent SDK
Le Agent SDK reçoit les serveurs MCP dans ses options. Pour un serveur distant, il vous faut :
- Une entrée mcpServers avec le type
http, l'URL et un objet headers. - allowedTools qui nomme les outils, sous la forme
mcp__paidsync__tool_name. - Une clé API PaidSync.ai dans une variable d'environnement.
Le SDK n'ouvre pas de navigateur et n'exécute pas de flux OAuth interactif, donc un jeton en en-tête est la voie à suivre. La documentation d'Anthropic indique que les outils MCP nécessitent une autorisation explicite via allowedTools.
Comment ça marche
| Réglage | Valeur |
|---|---|
| Type de serveur | http |
| URL | https://mcp.paidsync.ai/mcp |
| En-tête | Authorization: Bearer, depuis une variable d'environnement |
| Noms des outils | mcp__paidsync__ suivi du nom de l'outil |
| Limite de la clé | Lectures et aperçus sur Google Ads |
Appliquer une modification Google Ads exige la connexion OAuth de PaidSync.ai. Si vous réalisez ce flux dans votre propre application, vous pouvez envoyer le jeton d'accès dans le même en-tête.
Comment connecter Google Ads au Claude Agent SDK en 5 étapes
Suivez-les dans l'ordre. Le bloc de code contient la configuration exacte tirée de la documentation MCP du Claude Agent SDK.
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.
Ajouter le serveur
Passez l'extrait ci-dessous comme options.
N'autoriser que le nécessaire
Listez les outils de lecture comme mcp__paidsync__get_wasted_spend_report dans allowedTools.
Vérifier le message init
Regardez la liste mcp_servers du message init et confirmez que paidsync apparaît comme connecté.
Claude Agent SDK avec PaidSync.ai
import asyncio, os
from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage
options = ClaudeAgentOptions(
mcp_servers={
"paidsync": {
"type": "http",
"url": "https://mcp.paidsync.ai/mcp",
"headers": {"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
}
},
allowed_tools=["mcp__paidsync__get_wasted_spend_report"],
)
async def main():
async for message in query(prompt="Run get_wasted_spend_report for the last 30 days.", options=options):
if isinstance(message, ResultMessage) and message.subtype == "success":
print(message.result)
asyncio.run(main())Comment vérifier la connexion
Lisez d'abord le message init. Un statut connected pour paidsync signifie que la clé fonctionne.
Comment PaidSync.ai vous protège
- Autorisation explicite. Seuls les outils listés dans allowedTools s'exécutent sans demande de confirmation.
- 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 du Agent SDK d'Anthropic, vérifiée le 24 octobre 2026. Source : documentation MCP du Claude Agent SDK. 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 annonces.
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
Le Claude Agent SDK prend-il en charge les serveurs MCP distants ?
Oui. La documentation d'Anthropic décrit des serveurs http et sse avec en-têtes, en Python et en TypeScript.
Pourquoi une clé et pas OAuth ?
La documentation d'Anthropic indique que le SDK n'exécute pas de flux OAuth interactif. Transmettez un jeton dans les en-têtes.
Comment nommer les outils PaidSync.ai dans allowedTools ?
Utilisez mcp__paidsync__ suivi du nom de l'outil, ou mcp__paidsync__* pour tous.
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