Google Ad Manager bietet einen Remote-MCP-Server (Model Context Protocol), mit dem KI-Agenten sicher mit Google Ad Manager-Netzwerken, ‑Inventar, ‑Aufträgen und ‑Nutzerdaten interagieren können. Wenn Sie den Ad Manager-MCP-Server konfigurieren, können KI-Anwendungen wie Google Antigravity, Claude und ChatGPT Aktionen als Ihr Ad Manager-Nutzer ausführen.
Der MCP-Server ist unter https://admanager.googleapis.com/mcp verfügbar.
Vorbereitung
- Zugriff zum Erstellen von Google Cloud-Projekten oder zum Aufrufen eines vorhandenen Google Cloud-Projekts.
- Sie haben Zugriff, um Verbindungen oder Apps in Ihren KI-Clients (z. B. ChatGPT oder Claude) zu bearbeiten.
Ad Manager-MCP-Server konfigurieren
Wenn Sie den Ad Manager-MCP-Server verwenden möchten, müssen Sie die folgenden Schritte ausführen:
- Aktivieren Sie die Ad Manager API in Ihrem Google Cloud-Projekt.
- Konfigurieren Sie die OAuth 2.0-Endnutzerauthentifizierung.
- Fügen Sie den MCP-Server Ihrem KI-Client hinzu.
Ad Manager API aktivieren
Wenn Sie den Ad Manager MCP-Server verwenden möchten, müssen Sie die Ad Manager API in Ihrem Google Cloud-Projekt aktivieren. Wenn Sie ein Google Cloud-Projekt erstellen müssen, lesen Sie den Abschnitt Neues Projekt.
Authentifizierung konfigurieren
Der Ad Manager-MCP-Server verwendet OAuth 2.0 für die Authentifizierung und Autorisierung von Endnutzern. Wenn ein KI-Client eine Verbindung zum MCP-Server herstellt, authentifiziert er sich als der Nutzer, der den KI-Client ausführt. Der KI-Agent übernimmt die Google Ad Manager-Nutzerrollen, Netzwerkmitgliedschaften und Berechtigungen des Nutzers.
Rufen Sie in der Google Cloud Console Google Auth Platform > Branding auf.
Wenn Sie die Google Auth Platform bereits konfiguriert haben, können Sie die folgenden Einstellungen für den OAuth-Zustimmungsbildschirm unter Branding, Zielgruppe und Datenzugriff konfigurieren. Wenn Sie die Meldung Google Auth Platform noch nicht konfiguriert sehen, klicken Sie auf Jetzt starten:
- Geben Sie im Abschnitt App-Informationen für App-Name
Ad Manager MCP Serveroder den gewünschten Namen ein. - Wählen Sie unter E-Mail-Adresse für den Nutzer-Support Ihre E-Mail-Adresse oder eine geeignete Gruppe aus.
- Klicken Sie auf Weiter.
- Wählen Sie als Zielgruppe die Option Intern aus.
- Klicken Sie auf Weiter.
- Geben Sie unter Kontaktdaten eine E-Mail-Adresse ein, über die Sie über Änderungen an Ihrem Projekt benachrichtigt werden können.
- Klicken Sie auf Weiter.
- Sehen Sie sich im Abschnitt Abschließen die Richtlinie zu Nutzerdaten für Google API-Dienste an und wählen Sie Ich akzeptiere die Richtlinie zu Nutzerdaten für Google API-Dienste aus, wenn Sie damit einverstanden sind.
- Klicken Sie auf Weiter.
- Klicken Sie auf Erstellen.
- Geben Sie im Abschnitt App-Informationen für App-Name
Klicken Sie auf Datenzugriff > Bereiche hinzufügen oder entfernen. Ein Bereich mit einer Liste der Bereiche für jede API, die Sie in Ihrem Google Cloud-Projekt aktiviert haben, wird angezeigt.
- Geben Sie unter Bereiche manuell hinzufügen die für den Ad Manager-MCP-Server erforderlichen OAuth-Bereiche ein:
https://www.googleapis.com/auth/admanager(Vollständiger Zugriff zum Ansehen und Verwalten von Kampagnen)
- Klicken Sie auf Zur Tabelle hinzufügen.
- Klicken Sie auf Aktualisieren.
- Nachdem Sie die für Ihre App erforderlichen Bereiche ausgewählt haben, klicken Sie auf der Seite Datenzugriff auf Speichern.
- Geben Sie unter Bereiche manuell hinzufügen die für den Ad Manager-MCP-Server erforderlichen OAuth-Bereiche ein:
MCP-Server zum KI-Client hinzufügen
So fügen Sie den Ad Manager-MCP-Server Ihrem KI-Client hinzu:
Antigravity
So fügen Sie den Ad Manager MCP-Server zu Antigravity hinzu:
So erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:
-
Rufen Sie in der Google API Console Google Auth Platform > Clients > Create client auf.
Wenn Sie kein Projekt ausgewählt haben, werden Sie aufgefordert, eines zu erstellen.
Wählen Sie in der Liste Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Anwendung ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und geben Sie dann
https://antigravity.google/oauth-callbackin das Feld URIs ein.Klicken Sie auf Erstellen. Der Client wird erstellt.
Das Dialogfeld OAuth 2.0-Client erstellt wird geöffnet.
Kopieren Sie im Abschnitt Clientschlüssel den Clientschlüssel und speichern Sie ihn an einem sicheren Ort. Sie können sie nur einmal kopieren. Wenn Sie den Clientschlüssel verlieren, löschen Sie ihn und erstellen Sie einen neuen.
-
Wenn Sie den Ad Manager-MCP-Server zu Antigravity hinzufügen möchten, aktualisieren Sie die Datei
~/.gemini/config/mcp_config.json:{ "mcpServers": { "AdManager-MCP": { // Use your chosen MCP server URL. "serverUrl": "https://admanager.googleapis.com/mcp", "oauth": { "clientId": "CLIENT_ID", "clientSecret": "CLIENT_SECRET" } } } }
Ersetzen Sie CLIENT_ID und CLIENT_SECRET durch Ihre OAuth 2.0-Clientanmeldedaten.
Informationen zur Authentifizierung des Ad Manager-MCP-Servers finden Sie unter Antigravity: Mit OAuth authentifizieren.
Claude.ai
So fügen Sie den Ad Manager MCP-Server zu Claude.ai hinzu: Konfigurieren Sie einen benutzerdefinierten Connector mit einer OAuth-Client-ID und einem OAuth-Clientschlüssel:
So erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:
-
Rufen Sie in der Google API Console Google Auth Platform > Clients > Create client auf.
Wenn Sie kein Projekt ausgewählt haben, werden Sie aufgefordert, eines zu erstellen.
Wählen Sie in der Liste Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Anwendung ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und geben Sie dann
https://claude.ai/api/mcp/auth_callbackin das Feld URIs ein.Klicken Sie auf Erstellen. Der Client wird erstellt.
Das Dialogfeld OAuth 2.0-Client erstellt wird geöffnet.
Kopieren Sie im Abschnitt Clientschlüssel den Clientschlüssel und speichern Sie ihn an einem sicheren Ort. Sie können sie nur einmal kopieren. Wenn Sie den Clientschlüssel verlieren, löschen Sie ihn und erstellen Sie einen neuen.
-
- Folgen Sie der Anleitung, um einen benutzerdefinierten Connector zu erstellen. Geben Sie Ihre Client-ID und Ihren Clientschlüssel im Menü Erweiterte Einstellungen ein.
Claude Code
Wenn Sie den Ad Manager-MCP-Server zu Claude Code hinzufügen möchten, konfigurieren Sie einen benutzerdefinierten Connector mit einer OAuth-Client-ID und einem OAuth-Clientschlüssel:
- Claude Code installieren
So erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:
-
Rufen Sie in der Google API Console Google Auth Platform > Clients > Create client auf.
Wenn Sie kein Projekt ausgewählt haben, werden Sie aufgefordert, eines zu erstellen.
Wählen Sie in der Liste Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Anwendung ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und geben Sie dann
https://claude.ai/api/mcp/auth_callbackin das Feld URIs ein.Klicken Sie auf Erstellen. Der Client wird erstellt.
Das Dialogfeld OAuth 2.0-Client erstellt wird geöffnet.
Kopieren Sie im Abschnitt Clientschlüssel den Clientschlüssel und speichern Sie ihn an einem sicheren Ort. Sie können sie nur einmal kopieren. Wenn Sie den Clientschlüssel verlieren, löschen Sie ihn und erstellen Sie einen neuen.
-
- Folgen Sie der Anleitung, um einen benutzerdefinierten Connector zu erstellen. Geben Sie Ihre Client-ID und Ihren Clientschlüssel im Menü Erweiterte Einstellungen ein.
Claude für den Computer
So fügen Sie den Ad Manager-MCP-Server zu Claude Desktop hinzu: Konfigurieren Sie einen benutzerdefinierten Connector mit einer OAuth-Client-ID und einem OAuth-Client-Secret:
- Claude für Desktop installieren
So erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:
-
Rufen Sie in der Google API Console Google Auth Platform > Clients > Create client auf.
Wenn Sie kein Projekt ausgewählt haben, werden Sie aufgefordert, eines zu erstellen.
Wählen Sie in der Liste Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Anwendung ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und geben Sie dann
https://claude.ai/api/mcp/auth_callbackin das Feld URIs ein.Klicken Sie auf Erstellen. Der Client wird erstellt.
Das Dialogfeld OAuth 2.0-Client erstellt wird geöffnet.
Kopieren Sie im Abschnitt Clientschlüssel den Clientschlüssel und speichern Sie ihn an einem sicheren Ort. Sie können sie nur einmal kopieren. Wenn Sie den Clientschlüssel verlieren, löschen Sie ihn und erstellen Sie einen neuen.
-
- Folgen Sie der Anleitung, um einen benutzerdefinierten Connector zu erstellen. Geben Sie Ihre Client-ID und Ihren Clientschlüssel im Menü Erweiterte Einstellungen ein.
ChatGPT
Sie benötigen ein ChatGPT Business-Abo, um den Ad Manager MCP-Server mit ChatGPT zu verwenden.
Wenn Sie den MCP-Server zu ChatGPT hinzufügen möchten, erstellen Sie eine Google OAuth 2.0-Client-ID und einen Clientschlüssel und fügen Sie den MCP-Server dann als App in ChatGPT hinzu.
OAuth 2.0-Client-ID und ‑Secret erstellen
-
Rufen Sie in der Google API Console Google Auth Platform > Clients > Create client auf.
Wenn Sie kein Projekt ausgewählt haben, werden Sie aufgefordert, eines zu erstellen.
Wählen Sie in der Liste Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Anwendung ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und geben Sie dann
https://chatgpt.com/connector_platform_oauth_redirectin das Feld URIs ein.Klicken Sie auf Erstellen. Der Client wird erstellt.
Das Dialogfeld OAuth 2.0-Client erstellt wird geöffnet.
Kopieren Sie im Abschnitt Clientschlüssel den Clientschlüssel und speichern Sie ihn an einem sicheren Ort. Sie können sie nur einmal kopieren. Wenn Sie den Clientschlüssel verlieren, löschen Sie ihn und erstellen Sie einen neuen.
MCP-Server als App in ChatGPT hinzufügen
- Melden Sie sich in ChatGPT an.
- Aktivieren Sie den Entwicklermodus.
- Öffnen Sie die Einstellungen für ChatGPT-Apps.
- Klicken Sie auf App erstellen und erstellen Sie eine App für den Remote-MCP-Server.
- Geben Sie im Bereich „OAuth“ Ihre Client-ID und Ihr Secret an.
- Bestätigen Sie, dass Sie das mit der Verwendung von MCP-Servern verbundene Risiko verstanden haben, und klicken Sie dann auf Erstellen.
Der MCP-Server wird im Menü Apps angezeigt und kann über Chat-Prompts verwendet werden.
Cursor
Wenn Sie den Ad Manager-MCP-Server zu Cursor hinzufügen möchten, erstellen Sie eine Client-ID und einen Clientschlüssel. Konfigurieren Sie den MCP-Server mit statischem OAuth. Cursor verwendet Weiterleitungs-URIs, je nachdem, wie Sie auf Cursor zugreifen, z. B. über eine Web- oder eine Desktopanwendung.
So erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:
Web- oder Cursor-Agents
-
Rufen Sie in der Google API Console Google Auth Platform > Clients > Create client auf.
Wenn Sie kein Projekt ausgewählt haben, werden Sie aufgefordert, eines zu erstellen.
Wählen Sie in der Liste Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Anwendung ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und geben Sie dann
https://www.cursor.com/agents/mcp/oauth/callbackin das Feld URIs ein.Klicken Sie auf Erstellen. Der Client wird erstellt.
Das Dialogfeld OAuth 2.0-Client erstellt wird geöffnet.
Kopieren Sie im Abschnitt Clientschlüssel den Clientschlüssel und speichern Sie ihn an einem sicheren Ort. Sie können sie nur einmal kopieren. Wenn Sie den Clientschlüssel verlieren, löschen Sie ihn und erstellen Sie einen neuen.
Computer
-
Rufen Sie in der Google API Console Google Auth Platform > Clients > Create client auf.
Wenn Sie kein Projekt ausgewählt haben, werden Sie aufgefordert, eines zu erstellen.
Wählen Sie in der Liste Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Anwendung ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und geben Sie dann
http://localhost:8787/callbackin das Feld URIs ein.Klicken Sie auf Erstellen. Der Client wird erstellt.
Das Dialogfeld OAuth 2.0-Client erstellt wird geöffnet.
Kopieren Sie im Abschnitt Clientschlüssel den Clientschlüssel und speichern Sie ihn an einem sicheren Ort. Sie können sie nur einmal kopieren. Wenn Sie den Clientschlüssel verlieren, löschen Sie ihn und erstellen Sie einen neuen.
-
- Folgen Sie der Anleitung zum Konfigurieren des MCP-Servers mit statischem OAuth.
- MCP-Server in Chat verwenden
Ad Manager-MCP-Server testen
Nachdem Sie Ihren MCP-Client konfiguriert und authentifiziert haben, können Sie die Verbindung überprüfen, indem Sie Testprompts in Ihrer KI-Chatoberfläche ausführen.
Stellen Sie Ihrem KI-Client die folgenden Fragen:
„Liste die Google Ad Manager-Netzwerke auf, auf die ich Zugriff habe.“
Der Client ruft
list_networksauf, um die mit Ihrem Nutzerkonto verknüpften Ad Manager-Netzwerkcodes und Anzeigenamen abzurufen und anzuzeigen.„Finde Details zum Netzwerkcode
NETWORK_CODE.“Der Client verwendet
get_network, um Metadaten für das angegebene Netzwerk abzurufen.„Zeige die ersten fünf Bestellungen im Netzwerk
NETWORK_CODE.“Der Client ruft
list_ordersauf, um Bestellungen in Ihrem Netzwerk abzufragen und zusammenzufassen.
Wenn die Tools erfolgreich ausgeführt werden und Google Ad Manager-Daten zurückgeben, ist die Verbindung zu Ihrem MCP-Server richtig konfiguriert.