Um Google Ads mit dem Claude Agent SDK zu verbinden, fügen Sie einen http-MCP-Server für https://mcp.paidsync.ai/mcp mit Ihrem PaidSync.ai-API-Schlüssel im Authorization-Header hinzu und listen Sie seine Tools in allowedTools auf. Ihr Agent kann dann PaidSync.ai-Tools für Google Ads, Meta Ads und 12 weitere Plattformen aufrufen.
Was das Agent SDK braucht
Das Agent SDK nimmt MCP-Server in seinen Optionen entgegen. Für einen Remote-Server brauchen Sie:
- Einen mcpServers-Eintrag mit Typ
http, der URL und einem headers-Objekt. - allowedTools mit den Tool-Namen in der Form
mcp__paidsync__tool_name. - Einen PaidSync.ai-API-Schlüssel in einer Umgebungsvariablen.
Das SDK öffnet keinen Browser und führt keinen interaktiven OAuth-Ablauf aus, daher ist ein Header-Token der Weg. Laut den Docs von Anthropic brauchen MCP-Tools ausdrückliche Berechtigung über allowedTools.
So läuft die Verbindung
| Einstellung | Wert |
|---|---|
| Servertyp | http |
| URL | https://mcp.paidsync.ai/mcp |
| Header | Authorization: Bearer, aus einer Umgebungsvariablen |
| Tool-Namen | mcp__paidsync__ gefolgt vom Tool-Namen |
| Schlüssel-Limit | Lesen und Vorschau bei Google Ads |
Eine Google-Ads-Änderung anzuwenden, braucht die OAuth-Anmeldung von PaidSync.ai. Wenn Sie diesen Ablauf in Ihrer eigenen App abschließen, können Sie das Access-Token im selben Header senden.
So verbinden Sie Google Ads in 5 Schritten mit dem Claude Agent SDK
Gehen Sie der Reihe nach vor. Der Codekasten enthält die exakte Einrichtung aus den MCP-Docs des Claude Agent SDK.
Google Ads mit PaidSync.ai verbinden
Registrieren Sie sich unter paidsync.ai und verbinden Sie Google Ads auf der Anmeldeseite von Google.
API-Schlüssel erstellen
Erstellen Sie in Ihrem Dashboard einen Schlüssel und exportieren Sie ihn als PAIDSYNC_API_KEY.
Den Server hinzufügen
Übergeben Sie das folgende Snippet als Ihre Optionen.
Nur freigeben, was Sie brauchen
Listen Sie Lese-Tools wie mcp__paidsync__get_wasted_spend_report in allowedTools auf.
Die Init-Meldung prüfen
Sehen Sie sich die Liste mcp_servers in der Init-Meldung an und prüfen Sie, ob paidsync als verbunden angezeigt wird.
Claude Agent SDK mit 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())So prüfen Sie die Verbindung
Lesen Sie zuerst die Init-Meldung. Der Status connected für paidsync bedeutet, dass der Schlüssel funktioniert.
So schützt Sie PaidSync.ai
- Ausdrückliche Berechtigung. Nur die Tools in allowedTools laufen ohne Rückfrage.
- Berichte ändern nichts. Die Berichte zu verschwendeten Ausgaben und zur Leistung lesen Ihr Konto nur.
- Anmeldung für Änderungen. Ein Schlüssel kann keine Google-Ads-Änderung anwenden.
- Ein Änderungsprotokoll. Angewendete Änderungen werden nach bestem Bemühen protokolliert, mit einem Vorher-Nachher-Ergebnis.
Die Einrichtung folgt der Agent-SDK-Dokumentation von Anthropic, geprüft am 24. Oktober 2026. Quelle: MCP-Docs des Claude Agent SDK. Alle Google-Ads-Tools stehen auf der Seite Google Ads MCP-Server, die vollständige Liste der Clients unter Ihre Ads verbinden.
Zu ChatGPT hinzufügen: Öffnen Sie PaidSync.ai im Plugin-Verzeichnis von ChatGPT, installieren Sie es und melden Sie sich an.
Zu Claude hinzufügen: Öffnen Sie PaidSync.ai im Connector-Verzeichnis von Claude, klicken Sie auf Verbinden und melden Sie sich an.
Häufig gestellte Fragen
Unterstützt das Claude Agent SDK Remote-MCP-Server?
Ja. Die Docs von Anthropic beschreiben http- und sse-Server mit Headern, in Python und TypeScript.
Warum ein Schlüssel und nicht OAuth?
Laut den Docs von Anthropic führt das SDK keinen interaktiven OAuth-Ablauf aus. Übergeben Sie ein Token in den Headern.
Wie benenne ich PaidSync.ai-Tools in allowedTools?
Verwenden Sie mcp__paidsync__ gefolgt vom Tool-Namen oder mcp__paidsync__* für alle.
Funktioniert es für Meta Ads?
Ja. Derselbe Server stellt Meta-Ads-Tools bereit. Siehe die Seite Meta Ads MCP-Server.
Was kostet es?
PaidSync.ai ist für 100 Aufgaben im Monat im Wert von $50 kostenlos, ohne Karte. Pro beginnt bei $99 im Monat. Siehe Preise.
Weiterführende Guides
PaidSync.ai betreibt 630+ Tools auf 14 Werbe- und Analyseplattformen. Verbinden Sie Ihre Konten einmal und nutzen Sie sie im KI-Assistenten, in dem Sie ohnehin arbeiten.
Kostenlos starten Demo buchen