Um Google Ads mit dem Agent Development Kit zu verbinden, fügen Sie ein McpToolset mit StreamableHTTPConnectionParams hinzu, das auf https://mcp.paidsync.ai/mcp zeigt, und senden Sie Ihren PaidSync.ai-API-Schlüssel im Authorization-Header. Der ADK-Agent kann dann PaidSync.ai-Tools für Google Ads, Meta Ads und 12 weitere Plattformen aufrufen.
Was ADK braucht
ADK-Agenten nutzen ein McpToolset, um MCP-Server zu erreichen. Für PaidSync.ai brauchen Sie:
- Ein McpToolset mit StreamableHTTPConnectionParams und der PaidSync.ai-URL.
- Einen PaidSync.ai-API-Schlüssel, in Ihrem Dashboard erstellt und in einer Umgebungsvariablen abgelegt.
- Ein PaidSync.ai-Login mit verbundenem Google Ads.
Die Docs von ADK zeigen Header in den Verbindungsparametern und sagen, dass McpToolset über auth_scheme und auth_credential auch OAuth-2.0-Token-Erneuerungen verwalten kann.
So läuft die Verbindung
| Einstellung | Wert |
|---|---|
| Klasse | McpToolset |
| Verbindung | StreamableHTTPConnectionParams |
| URL | https://mcp.paidsync.ai/mcp |
| Header | Authorization: Bearer, aus einer Umgebungsvariablen |
| Schlüssel-Limit | Lesen und Vorschau bei Google Ads |
Eine Google-Ads-Änderung anzuwenden, braucht die OAuth-Anmeldung von PaidSync.ai, und ein Schlüssel kann das nicht. Nutzen Sie den Schlüssel für Reporting-Agenten und behalten Sie bei Änderungen einen Menschen in der Schleife.
Google Ads in 5 Schritten mit Google ADK verbinden
Gehen Sie der Reihe nach vor. Der Codekasten enthält die exakte Einrichtung aus den MCP-Tools-Docs von Google ADK.
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. Setzen Sie ihn nie in die URL.
Das Toolset hinzufügen
Fügen Sie das McpToolset aus dem Kasten unten zu den Tools Ihres LlmAgent hinzu.
Den Agenten ausführen
Starten Sie den Agenten mit adk run oder der Web-Oberfläche und fragen Sie nach Ihrem Konto.
Den Tool-Aufruf prüfen
Prüfen Sie im Ereignisprotokoll, dass ein PaidSync.ai-Tool gelaufen ist.
ADK-Agent mit 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"]},
))],
)So prüfen Sie die Verbindung
Beginnen Sie mit einer Frage, die nur liest, etwa der Kontoliste, und prüfen Sie das Ereignisprotokoll auf den Tool-Aufruf.
So schützt Sie PaidSync.ai
- Schlüssel bleiben aus URLs heraus. Der Schlüssel kommt aus einer Umgebungsvariablen in einen Header.
- 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 ADK-Dokumentation von Google, geprüft am 24. Oktober 2026. Quelle: MCP-Tools-Docs von Google ADK. 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
Können Google-ADK-Agenten MCP-Server nutzen?
Ja. Das McpToolset von ADK verbindet einen Agenten über Streamable HTTP mit Remote-MCP-Servern.
Braucht ADK OAuth für PaidSync.ai?
Nicht für Berichte. Ein Bearer-Header mit einem API-Schlüssel funktioniert. ADK dokumentiert auch OAuth-Unterstützung über auth_scheme.
Kann ein ADK-Agent mein Google-Ads-Konto ändern?
Mit einem Schlüssel liest und zeigt er Vorschauen. Eine Google-Ads-Änderung anzuwenden, braucht die OAuth-Anmeldung.
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