Serwer MCP Google Ads: przewodnik po integracji dla programistów

Protokół kontekstu modelu (MCP) to otwarty standard, który umożliwia dużym modelom językowym (LLM) bezpieczną interakcję z zewnętrznymi danymi i aplikacjami. Serwer MCP Google Ads zapewnia ustandaryzowany pomost do interfejsu Google Ads API, umożliwiając agentom AI analizowanie i pobieranie danych kampanii za pomocą języka naturalnego.

Omówienie techniczne

Wdrażając ten serwer MCP, nie musisz pisać niestandardowego „kodu łączącego” na potrzeby uwierzytelniania interfejsu Google Ads API, pobierania zasobów i parsowania danych. Serwer udostępnia konkretne narzędzia, które LLM może wykrywać i wywoływać autonomicznie.

Najważniejsze dane

  • Protokół: MCP (Model Context Protocol)
  • Tryb: Tylko do odczytu (obecna wersja)
  • Język: Python
  • Transport: standardowy strumień wejścia/wyjścia (stdio)
  • Uwierzytelnianie: OAuth 2.0 lub konto usługi

Jak działa pętla interakcji

  1. Żądanie: użytkownik przesyła zapytanie, np. „Jakie są wyniki mojej kampanii w tym tygodniu?”.
  2. Odkrywanie: LLM sprawdza dostępne narzędzia i identyfikuje funkcje wyszukiwania.google-ads-mcp
  3. Wykonanie: serwer MCP wykonuje podstawową logikę Pythona, aby wysyłać zapytania do interfejsu Google Ads API.
  4. Wstrzykiwanie kontekstu: ustrukturyzowane wyniki są zwracane do okna kontekstu LLM.
  5. Odpowiedź: LLM syntetyzuje dane w odpowiedź zrozumiałą dla człowieka.

Rozpocznij

Aby skonfigurować i używać serwera MCP Google Ads, wykonaj te czynności.

Wymagania wstępne

Przed konfiguracją upewnij się, że masz te dane logowania z konsoli dewelopera Google Ads:

  • Token programisty: unikalny 22-znakowy ciąg dostępu.
  • Identyfikator projektu: identyfikator Twojego projektu Google Cloud.
  • Plik danych logowania: autoryzowany credentials.json (OAuth 2.0 lub konto usługi).

Konfiguracja

Aby zintegrować serwer z hostem zgodnym z MCP, dodaj ten wpis do pliku konfiguracji MCP hosta (np. settings.json). Dokładną lokalizację i nazwę pliku tej konfiguracji znajdziesz w dokumentacji hosta.

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"
      }
    }
  }
}

Podstawowe funkcje (narzędzia)

Serwer udostępnia narzędzia przeznaczone do wykrywania kont i raportowania skuteczności:

  • list_accessible_customers: zwraca listę identyfikatorów klientów Google Ads i nazw kont dostępnych dla uwierzytelnionego użytkownika.
  • search: wykonuje żądania w języku zapytań Google Ads (GAQL), aby pobierać dane, budżety i stan kampanii.

Przykładowe prompty na początek

Zapytaj, co może zrobić serwer:

What can the google-ads-mcp server do?

Zapytaj o klientów:

What customers do I have access to?

Zadaj pytanie o kampanie:

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

Materiały i pomoc dla społeczności