Korzystanie z serwera MCP Google Ad Managera

Google Ad Manager udostępnia zdalny serwer Model Context Protocol (MCP), który umożliwia agentom AI bezpieczną interakcję z sieciami, zasobami reklamowymi, zamówieniami i danymi użytkowników Google Ad Manager. Konfigurując serwer MCP Ad Managera, umożliwiasz aplikacjom AI, takim jak Google Antigravity, Claude i ChatGPT, wykonywanie działań jako użytkownik Ad Managera.

Serwer MCP jest dostępny pod adresem https://admanager.googleapis.com/mcp.

Wymagania wstępne

• Dostęp do tworzenia projektów w chmurze Google Cloud lub dostęp do wyświetlania istniejącego projektu w chmurze Google Cloud.
• Dostęp do edytowania połączeń lub aplikacji na platformach AI (np. ChatGPT lub Claude).

Konfigurowanie serwera MCP Ad Managera

Aby korzystać z serwera MCP Ad Managera, musisz wykonać te czynności:

• włączyć interfejs Ad Manager API w projekcie Google Cloud;
• Skonfiguruj uwierzytelnianie użytkownika OAuth 2.0.
• Dodaj serwer MCP do klienta AI.

Włączanie interfejsu API Ad Managera

Aby korzystać z serwera MCP Ad Managera, musisz włączyć interfejs Ad Managera API w swoim projekcie Google Cloud. Jeśli musisz utworzyć projekt Google Cloud, zapoznaj się z sekcją Nowy projekt.

Włączanie interfejsu API

Konfigurowanie uwierzytelniania

Serwer MCP Ad Managera używa protokołu OAuth 2.0 do uwierzytelniania i autoryzacji użytkowników końcowych. Gdy klient AI łączy się z serwerem MCP, uwierzytelnia się jako użytkownik, który uruchamia klienta AI. Agent AI dziedziczy dokładne role użytkownika, członkostwo w sieciach i uprawnienia użytkownika w usłudze Google Ad Manager.

1. W konsoli Google Cloud wybierz Google Auth Platform > Branding.

   Przejdź do sekcji Elementy marki

2. Jeśli platforma uwierzytelniania Google została już skonfigurowana, możesz skonfigurować te ustawienia ekranu zgody OAuth: Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Platforma uwierzytelniania Google nie została jeszcze skonfigurowana, kliknij Rozpocznij:

   1. W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz Ad Manager MCP Server lub wybraną nazwę.
   2. W sekcji Adres e-mail pomocy dla użytkowników wybierz swój adres e-mail lub odpowiednią grupę.
   3. Kliknij Dalej.
   4. W polu Odbiorcy wybierz Wewnętrzny.
   5. Kliknij Dalej.
   6. W sekcji Dane kontaktowe wpisz adres e-mail, na który będziesz otrzymywać powiadomienia o zmianach w projekcie.
   7. Kliknij Dalej.
   8. W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google. Jeśli je akceptujesz, wybierz Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
   9. Kliknij Dalej.
   10. Kliknij Utwórz.

3. Kliknij Dostęp do danych > Dodaj lub usuń zakresy. Pojawi się panel z listą zakresów każdego interfejsu API włączonego w projekcie Google Cloud.

   1. W sekcji Ręcznie dodaj zakresy wpisz zakresy protokołu OAuth wymagane przez serwer MCP Ad Managera:
      • https://www.googleapis.com/auth/admanager (Pełny dostęp do wyświetlania kampanii i zarządzania nimi)
   2. Kliknij Dodaj do tabeli.
   3. Kliknij Aktualizuj.
   4. Po wybraniu zakresów wymaganych przez aplikację na stronie Dostęp do danych kliknij Zapisz.

Dodawanie serwera MCP do klienta AI

Aby dodać serwer MCP Ad Managera do klienta AI, postępuj zgodnie z instrukcjami dotyczącymi Twojego klienta:

Antigravity

Aby dodać serwer MCP Ad Managera do Antigravity, wykonaj te czynności:

1. Utwórz identyfikator klienta i tajny klucz klienta OAuth 2.0:

   1. W konsoli interfejsów API Google kliknij Platforma uwierzytelniania Google > Klienci > Utwórz klienta.

      Otwórz stronę Utwórz klienta

      Jeśli nie masz wybranego projektu, pojawi się prośba o jego utworzenie.

   2. Na liście Typ aplikacji wybierz Aplikacja internetowa.

   3. W polu Nazwa wpisz nazwę aplikacji.

   4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie w polu Identyfikatory URI wpisz https://antigravity.google/oauth-callback.

   5. Kliknij Utwórz. Klient został utworzony.

      Otworzy się okno Klient OAuth 2.0 został utworzony.

   6. W sekcji Tajne klucze klienta skopiuj tajny klucz klienta i zapisz go w bezpiecznym miejscu. Możesz go skopiować tylko raz. Jeśli go utracisz, usuń klucz tajny i utwórz nowy.

      Ostrzeżenie: traktuj tajne klucze klienta jak hasła i przechowuj je w bezpiecznym miejscu.

2. Aby dodać serwer MCP Ad Managera do Antigravity, zaktualizuj plik ~/.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"
         }
       }
     }
   }

   Zastąp CLIENT_ID i CLIENT_SECRET danymi uwierzytelniającymi klienta OAuth 2.0.

3. Informacje o uwierzytelnianiu serwera MCP Ad Managera znajdziesz w artykule Antigravity: uwierzytelnianie za pomocą protokołu OAuth.

Claude.ai

Aby dodać serwer MCP Ad Managera do Claude.ai, skonfiguruj niestandardowe połączenie z identyfikatorem klienta OAuth i tajnym kluczem klienta OAuth:

1. Utwórz identyfikator klienta i tajny klucz klienta OAuth 2.0:

   1. W konsoli interfejsów API Google kliknij Platforma uwierzytelniania Google > Klienci > Utwórz klienta.

      Otwórz stronę Utwórz klienta

      Jeśli nie masz wybranego projektu, pojawi się prośba o jego utworzenie.

   2. Na liście Typ aplikacji wybierz Aplikacja internetowa.

   3. W polu Nazwa wpisz nazwę aplikacji.

   4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie w polu Identyfikatory URI wpisz https://claude.ai/api/mcp/auth_callback.

   5. Kliknij Utwórz. Klient został utworzony.

      Otworzy się okno Klient OAuth 2.0 został utworzony.

   6. W sekcji Tajne klucze klienta skopiuj tajny klucz klienta i zapisz go w bezpiecznym miejscu. Możesz go skopiować tylko raz. Jeśli go utracisz, usuń klucz tajny i utwórz nowy.

      Ostrzeżenie: traktuj tajne klucze klienta jak hasła i przechowuj je w bezpiecznym miejscu.
2. Postępuj zgodnie z instrukcjami, aby utworzyć łącznik niestandardowy. Wpisz identyfikator klienta i tajny klucz w menu Ustawienia zaawansowane.

Claude Code

Aby dodać serwer MCP Ad Managera do Claude Code, skonfiguruj niestandardowe połączenie z identyfikatorem klienta OAuth i kluczem klienta OAuth:

1. Zainstaluj Claude Code

2. Utwórz identyfikator klienta i tajny klucz klienta OAuth 2.0:

   1. W konsoli interfejsów API Google kliknij Platforma uwierzytelniania Google > Klienci > Utwórz klienta.

      Otwórz stronę Utwórz klienta

      Jeśli nie masz wybranego projektu, pojawi się prośba o jego utworzenie.

   2. Na liście Typ aplikacji wybierz Aplikacja internetowa.

   3. W polu Nazwa wpisz nazwę aplikacji.

   4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie w polu Identyfikatory URI wpisz https://claude.ai/api/mcp/auth_callback.

   5. Kliknij Utwórz. Klient został utworzony.

      Otworzy się okno Klient OAuth 2.0 został utworzony.

   6. W sekcji Tajne klucze klienta skopiuj tajny klucz klienta i zapisz go w bezpiecznym miejscu. Możesz go skopiować tylko raz. Jeśli go utracisz, usuń klucz tajny i utwórz nowy.

      Ostrzeżenie: traktuj tajne klucze klienta jak hasła i przechowuj je w bezpiecznym miejscu.
3. Postępuj zgodnie z instrukcjami, aby utworzyć łącznik niestandardowy. Wpisz identyfikator klienta i tajny klucz w menu Ustawienia zaawansowane.

Claude Desktop

Aby dodać serwer MCP Ad Managera do Claude Desktop:skonfiguruj niestandardowe złącze z identyfikatorem klienta OAuth i kluczem tajnym klienta OAuth:

1. Zainstaluj Claude Desktop.

2. Utwórz identyfikator klienta i tajny klucz klienta OAuth 2.0:

   1. W konsoli interfejsów API Google kliknij Platforma uwierzytelniania Google > Klienci > Utwórz klienta.

      Otwórz stronę Utwórz klienta

      Jeśli nie masz wybranego projektu, pojawi się prośba o jego utworzenie.

   2. Na liście Typ aplikacji wybierz Aplikacja internetowa.

   3. W polu Nazwa wpisz nazwę aplikacji.

   4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie w polu Identyfikatory URI wpisz https://claude.ai/api/mcp/auth_callback.

   5. Kliknij Utwórz. Klient został utworzony.

      Otworzy się okno Klient OAuth 2.0 został utworzony.

   6. W sekcji Tajne klucze klienta skopiuj tajny klucz klienta i zapisz go w bezpiecznym miejscu. Możesz go skopiować tylko raz. Jeśli go utracisz, usuń klucz tajny i utwórz nowy.

      Ostrzeżenie: traktuj tajne klucze klienta jak hasła i przechowuj je w bezpiecznym miejscu.
3. Postępuj zgodnie z instrukcjami, aby utworzyć łącznik niestandardowy. Wpisz identyfikator klienta i tajny klucz w menu Ustawienia zaawansowane.

ChatGPT

Aby korzystać z serwera MCP Ad Managera z ChatGPT, musisz mieć subskrypcję ChatGPT Business.

Aby dodać serwer MCP do ChatGPT, utwórz identyfikator klienta i tajny klucz klienta Google OAuth 2.0, a następnie dodaj serwer MCP jako aplikację w ChatGPT.

Tworzenie identyfikatora klienta i tajnego klucza OAuth 2.0

1. W konsoli interfejsów API Google kliknij Platforma uwierzytelniania Google > Klienci > Utwórz klienta.

   Otwórz stronę Utwórz klienta

   Jeśli nie masz wybranego projektu, pojawi się prośba o jego utworzenie.

2. Na liście Typ aplikacji wybierz Aplikacja internetowa.

3. W polu Nazwa wpisz nazwę aplikacji.

4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie w polu Identyfikatory URI wpisz https://chatgpt.com/connector_platform_oauth_redirect.

5. Kliknij Utwórz. Klient został utworzony.

   Otworzy się okno Klient OAuth 2.0 został utworzony.

6. W sekcji Tajne klucze klienta skopiuj tajny klucz klienta i zapisz go w bezpiecznym miejscu. Możesz go skopiować tylko raz. Jeśli go utracisz, usuń klucz tajny i utwórz nowy.

   Ostrzeżenie: traktuj tajne klucze klienta jak hasła i przechowuj je w bezpiecznym miejscu.

Dodawanie serwera MCP jako aplikacji w ChatGPT

1. Zaloguj się w ChatGPT.
2. Włącz tryb programisty.
3. Otwórz ustawienia aplikacji ChatGPT.
4. Kliknij Utwórz aplikację i utwórz aplikację dla zdalnego serwera MCP.
5. W sekcji OAuth podaj identyfikator i tajny klucz klienta.
6. Potwierdź, że rozumiesz ryzyko związane z używaniem serwera MCP, a potem kliknij Utwórz.

Serwer MCP jest wyświetlany w menu Aplikacje i jest gotowy do użycia za pomocą promptów na czacie.

Kursor

Aby dodać serwer MCP Ad Managera do usługi Cursor, utwórz identyfikator klienta i tajny klucz. Skonfiguruj serwer MCP ze statycznym OAuth. Cursor używa identyfikatorów URI przekierowania w zależności od tego, jak uzyskujesz dostęp do usługi – np. za pomocą aplikacji internetowej lub na komputer.

1. Utwórz identyfikator klienta i tajny klucz klienta OAuth 2.0:

   agenci internetowi lub agenci Cursor.

   1. W konsoli interfejsów API Google kliknij Platforma uwierzytelniania Google > Klienci > Utwórz klienta.

      Otwórz stronę Utwórz klienta

      Jeśli nie masz wybranego projektu, pojawi się prośba o jego utworzenie.

   2. Na liście Typ aplikacji wybierz Aplikacja internetowa.

   3. W polu Nazwa wpisz nazwę aplikacji.

   4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie w polu Identyfikatory URI wpisz https://www.cursor.com/agents/mcp/oauth/callback.

   5. Kliknij Utwórz. Klient został utworzony.

      Otworzy się okno Klient OAuth 2.0 został utworzony.

   6. W sekcji Tajne klucze klienta skopiuj tajny klucz klienta i zapisz go w bezpiecznym miejscu. Możesz go skopiować tylko raz. Jeśli go utracisz, usuń klucz tajny i utwórz nowy.

      Ostrzeżenie: traktuj tajne klucze klienta jak hasła i przechowuj je w bezpiecznym miejscu.

   Komputer

   1. W konsoli interfejsów API Google kliknij Platforma uwierzytelniania Google > Klienci > Utwórz klienta.

      Otwórz stronę Utwórz klienta

      Jeśli nie masz wybranego projektu, pojawi się prośba o jego utworzenie.

   2. Na liście Typ aplikacji wybierz Aplikacja internetowa.

   3. W polu Nazwa wpisz nazwę aplikacji.

   4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie w polu Identyfikatory URI wpisz http://localhost:8787/callback.

   5. Kliknij Utwórz. Klient został utworzony.

      Otworzy się okno Klient OAuth 2.0 został utworzony.

   6. W sekcji Tajne klucze klienta skopiuj tajny klucz klienta i zapisz go w bezpiecznym miejscu. Możesz go skopiować tylko raz. Jeśli go utracisz, usuń klucz tajny i utwórz nowy.

      Ostrzeżenie: traktuj tajne klucze klienta jak hasła i przechowuj je w bezpiecznym miejscu.
2. Postępuj zgodnie z instrukcjami, aby skonfigurować serwer MCP za pomocą statycznego protokołu OAuth.
3. Korzystanie z serwera MCP w Chat

Testowanie serwera MCP Ad Managera

Po skonfigurowaniu i uwierzytelnieniu klienta MCP możesz sprawdzić połączenie, uruchamiając testowe prompty w interfejsie czatu z AI.

Zadaj klientowi AI te pytania:

• „Wyświetl sieci Google Ad Manager, do których mam dostęp”.

  Klient wywołuje funkcję list_networks, aby pobrać i wyświetlić kody sieci Ad Managera oraz nazwy wyświetlane powiązane z Twoim kontem użytkownika.

• „Znajdź szczegóły dotyczące kodu sieci NETWORK_CODE”.

  Klient używa get_network do pobierania metadanych określonej sieci.

• „Pokaż pierwsze 5 zamówień w sieci NETWORK_CODE”.

  Klient wywołuje funkcję list_orders, aby wysyłać zapytania o zamówienia w Twojej sieci i je podsumowywać.

Jeśli narzędzia działają prawidłowo i zwracają dane Google Ad Managera, połączenie z serwerem MCP jest skonfigurowane prawidłowo.