Google Ads-MCP-Server: Entwickler-Integrationsleitfaden

Das Model Context Protocol (MCP) ist ein offener Standard, der es Large Language Models (LLMs) ermöglicht, sicher mit externen Daten und Anwendungen zu interagieren. Der Google Ads MCP-Server bietet eine standardisierte Brücke zur Google Ads API, sodass KI-Agents Kampagnendaten in natürlicher Sprache analysieren und abrufen können.

Technische Übersicht

Durch die Implementierung dieses MCP-Servers müssen Sie keinen benutzerdefinierten „Glue-Code“ für die Google Ads API-Authentifizierung, das Abrufen von Ressourcen und das Parsen von Daten schreiben. Der Server stellt bestimmte Tools zur Verfügung, die ein LLM autonom erkennen und aufrufen kann.

Wichtige Spezifikationen

  • Protokoll:MCP (Model Context Protocol)
  • Modus:Schreibgeschützt (aktuelle Version)
  • Sprache:Python
  • Transport:Standard-Ein-/Ausgabe (stdio)
  • Authentifizierung:OAuth 2.0 oder Dienstkonto

So funktioniert der Interaktionszyklus

  1. Anfrage:Ein Nutzer stellt eine Frage wie „Wie ist die Leistung meiner Kampagne in dieser Woche?“.
  2. Erkennung:Das LLM untersucht die verfügbaren Tools und identifiziert die google-ads-mcp-Suchfunktionen.
  3. Ausführung:Der MCP-Server führt die zugrunde liegende Python-Logik aus, um die Google Ads API abzufragen.
  4. Kontexteinfügung:Strukturierte Ergebnisse werden in das Kontextfenster des LLM zurückgegeben.
  5. Antwort:Das LLM fasst die Daten in einer für Menschen lesbaren Antwort zusammen.

Jetzt starten

So konfigurieren und verwenden Sie den Google Ads MCP-Server:

Vorbereitung

Bevor Sie die Konfiguration vornehmen, benötigen Sie die folgenden Anmeldedaten aus der Google Ads Developer Console:

  • Entwicklertoken:Ihr eindeutiger 22‑stelliger Zugriffsstring.
  • Projekt-ID:Die ID Ihres Google Cloud-Projekts.
  • Anmeldedatendatei:Eine autorisierte credentials.json (OAuth 2.0 oder Dienstkonto).

Konfiguration

Wenn Sie den Server in einen MCP-kompatiblen Host einbinden möchten, fügen Sie der MCP-Konfigurationsdatei Ihres Hosts den folgenden Eintrag hinzu (z.B. settings.json). Informationen zum genauen Speicherort und Dateinamen dieser Konfiguration finden Sie in der Dokumentation Ihres Hosts.

JSON

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Hauptfunktionen (Tools)

Der Server stellt Tools für die Kontoermittlung und Leistungsberichte zur Verfügung:

  • list_accessible_customers: Gibt die Liste der Google Ads-Kundennummern und Kontonamen zurück, auf die der authentifizierte Nutzer zugreifen kann.
  • search: Führt Google Ads Query Language-Anfragen (GAQL) aus, um Kampagnenmesswerte, Budgets und Status abzurufen.

Beispiel-Prompts für den Einstieg

Fragen, was der Server kann:

What can the google-ads-mcp server do?

Nach Kunden fragen:

What customers do I have access to?

Fragen zu Kampagnen stellen:

How many active campaigns do I have?
How is my campaign performance this week?

Community-Ressourcen und Support