Google Ads MCP: cała struktura kampanii od Twojego agenta, jedną operacją

Czy istnieje serwer MCP Google Ads? Tak. Hermoso to hostowany serwer MCP Google Ads. Dodaj https://app.hermoso.ai/mcp do Claude, ChatGPT lub Cursor i połącz konto Google Ads raz. Twój asystent może wtedy budować kampanie Search, displayowe i Performance Max, znajdować pomysły na słowa kluczowe, ustawiać budżety, stawki i targetowanie oraz generować raporty. Włączenie kampanii zawsze wymaga Twojej wyraźnej zgody.

Google Ads to drzewo, a drzewa najczęściej psują się przy skryptowym tworzeniu kampanii. Tworzysz budżet, potem kampanię, potem grupę reklam, a na końcu reklamę. Jeśli reklama zostanie odrzucona na czwartym kroku, zostaje Ci trzy osierocone obiekty i budżet, którego nie chciałeś. Sprzątanie tego ręcznie to powód, dla którego większość ludzi rezygnuje z automatyzacji Google Ads.

Serwer MCP Hermoso buduje całe drzewo jedną atomową operacją, używając tymczasowych identyfikatorów zasobów, dzięki czemu elementy podrzędne mogą odwoływać się do rodziców, którzy jeszcze nie istnieją. Albo powstają kampania, grupa reklam, reklama i słowa kluczowe, albo nie powstaje nic. Odrzucona reklama oznacza, że budżet też nigdy nie został utworzony.

Instalacja raz: w Claude.ai lub Claude Desktop wklej https://app.hermoso.ai/mcp w Ustawienia → Connectors i zatwierdź to swoim kontem Hermoso. W agencie do kodowania to jedno polecenie: /plugin marketplace add hermoso-ai/hermoso, a następnie /plugin install hermoso@hermoso w Claude Code, codex plugin marketplace add hermoso-ai/hermoso, a następnie codex plugin add hermoso@hermoso w Codex, albo npx skills add hermoso-ai/hermoso -a cursor w Cursor (nazwij swojego agenta po -a), a potem zaloguj się raz poleceniem npx -y hermoso auth login. Pełna konfiguracja na stronie MCP i CLI.

Narzędzia Google Ads

Budowanie. create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, create_google_ads_performance_max_campaign, upload_google_ads_asset, add_google_ads_assets dla linków do podstron, wyróżników i fragmentów strukturalnych.

Konfiguracja. set_google_ads_budget, set_google_ads_bidding (sześć strategii), set_google_ads_targeting (lokalizacja i język), find_google_ads_locations, set_google_ads_networks (sieć partnerów wyszukiwania i sieć displayowa włączone lub wyłączone), create_google_ads_conversion_action oraz list_google_ads_conversion_actions.

Badania. google_ads_keyword_ideas wprowadza Planer słów kluczowych do rozmowy: realne miesięczne wolumeny wyszukiwań, konkurencję i zakresy stawek na górze wyników, z podanych słów kluczowych, strony docelowej lub całej witryny.

Odczyt i zmiany. list_google_ads_campaigns, google_ads_report dla dowolnego zapytania GAQL, google_ads_change_history do sprawdzenia, co i kiedy się zmieniło na koncie, delete_google_ads_object do usunięcia obiektu oraz set_google_ads_status, jedyny przełącznik wymagający zgody, który uruchamia prawdziwe wydatki.

create_google_ads_campaign ma też tryb próbny, więc agent może sprawdzić całe drzewo w żywym API bez tworzenia czegokolwiek. To dobry domyślny wybór, gdy agent proponuje plan do zatwierdzenia.

Co Twój agent może zrobić z MCP Google Ads

Każdy wiersz to prawdziwe narzędzie na serwerze. Zapytaj zwykłym językiem, a agent sam wybierze, które uruchomić.

Przykładowe prompty

Wklej dowolny z nich do Claude, ChatGPT lub Cursor, gdy Hermoso jest już połączone.

• “Znajdź 30 słów kluczowych dla naszej aplikacji do zarządzania projektami, z wyszukiwaniami powyżej 1000 miesięcznie w USA, i pogrupuj je według intencji.”
  google_ads_keyword_ideas zwraca wolumeny, konkurencję i zakresy stawek z Planera słów kluczowych, a agent je grupuje.
• “Zbuduj wstrzymaną kampanię Search dla tych słów kluczowych: $50 dziennie, USA i Kanada, angielski, maksymalizacja konwersji.”
  create_google_ads_campaign buduje budżet, kampanię, grupę reklam, reklamę i słowa kluczowe jedną atomową operacją, wstrzymane, a potem odczytuje wszystko z powrotem.
• “Skonfiguruj kampanię Performance Max dla naszego katalogu Shopify z feedem Merchant Center.”
  list_merchant_accounts wybiera sklep, a create_google_ads_performance_max_campaign buduje kampanię wstrzymaną, z podłączonym feedem.
• “Które wyszukiwane hasła wydały pieniądze w zeszłym miesiącu bez konwersji? Dodaj dziesięć najgorszych jako wykluczające.”
  google_ads_report pobiera raport wyszukiwanych haseł, a add_google_ads_keywords dodaje wykluczenia.
• “Dodaj cztery linki do podstron do naszej kampanii marki: cennik, demo, case studies i kontakt.”
  add_google_ads_assets tworzy linki do podstron i przypisuje je do kampanii.
• “Wyłącz partnerów wyszukiwania we wszystkich kampaniach i pokaż mi stan przed i po.”
  set_google_ads_networks najpierw odczytuje obecne ustawienie, a potem zmienia je kampania po kampanii.
• “Ktoś zmienił nam stawki w piątek. Co się zmieniło?”
  google_ads_change_history wypisuje zmiany z godzinami.
• “Połącz naszą właściwość GA4, żeby rejestracje liczyły się jako konwersje w Google Ads.”
  link_google_ads_to_analytics łączy oba konta, a create_analytics_key_event oznacza zdarzenie rejestracji jako kluczowe.

Performance Max, zbudowany tak samo

create_google_ads_performance_max_campaign buduje międzykanałowy typ kampanii Google (Search, YouTube, sieć displayowa, Discover, Gmail i Mapy z jednej kampanii). Buduje go jedną atomową operacją, bo Google tego wymaga: budżet, kampania, targetowanie lokalizacji i języka, grupa zasobów oraz wszystkie powiązania zasobów idą razem, więc odrzucony zasób nie zostawia za sobą połowicznie zbudowanej kampanii. Kampania powstaje wstrzymana, a całe drzewo jest odczytywane z Google, zanim Twój agent powie Ci, że istnieje.

Minimalne wymagania Google dotyczące zasobów są sprawdzane tutaj, zanim cokolwiek zostanie wysłane, więc brakujący kwadratowy obraz to jasny komunikat, a nie niejasne odrzucenie z API: 3–15 nagłówków do 30 znaków, 1–5 długich nagłówków do 90 znaków, 2–5 opisów do 90 znaków, jedna nazwa firmy do 25 znaków oraz co najmniej jedno logo, jeden obraz marketingowy i jeden kwadratowy obraz marketingowy. Najpierw wgraj obrazy narzędziem upload_google_ads_asset i przekaż nazwy zasobów. Film w YouTube jest opcjonalny. Jeśli go pominiesz, Google wygeneruje go z grupy zasobów.

Performance Max nie ma słów kluczowych ani ręcznych stawek: optymalizuje wyłącznie pod konwersje. Dlatego budowanie odmawia na koncie bez włączonej akcji konwersji, zamiast tworzyć kampanię, która nie może się optymalizować, i wskazuje oba wyjścia: utworzenie akcji narzędziem create_google_ads_conversion_action albo wybór strategii, która jej nie wymaga. Wytyczne marki są domyślnie włączone dla nowych kampanii PMax od Google Ads API v21, co zmienia miejsce podpięcia nazwy firmy i logo; Hermoso podpina je do kampanii za Ciebie.

Performance Max oparty na feedzie zakupowym (retail) działa tak samo: podaj merchantCenterId, a kampania będzie reklamować Twój katalog Merchant Center, z feedLabel, żeby zawęzić go do jednego feedu. Jest budowany i odczytywany dokładnie jak kampania wyżej. Odczyt pokazuje konto Merchant Center i etykietę feedu, które Google faktycznie zapisał, więc możesz sprawdzić, że to naprawdę kampania retail, a nie wierzyć nam na słowo. Reklamuje cały feed pod jednym głównym elementem grupy produktów; podział feedu według marki, kategorii czy etykiety własnej nie jest zbudowany i jest odrzucany po nazwie, a nie cicho ignorowany, więc nigdy nie uznasz, że zawęziłeś feed, gdy tego nie zrobiłeś.

Merchant Center, żeby agent wiedział, co sprzedaje

„Dlaczego ten produkt się nie wyświetla?” to pytanie, na które raportowanie Google Ads z natury nie odpowie, bo odrzucony produkt nie ma wyświetleń do raportowania. Odpowiedź leży w Merchant Center, a to samo połączenie z Google do niego sięga, bez drugiego logowania.

Twój agent może wypisać konta Merchant Center, do których ma dostęp Twoje połączone konto Google, narzędziem list_merchant_accounts (agencje zwykle mają ich kilka, więc agent pyta, o który sklep chodzi, zamiast zgadywać), odczytać produkty w feedzie narzędziem list_merchant_products (faktyczny katalog, który obsługuje kampania Shopping lub retail Performance Max) i odczytać problemy na poziomie konta, które Google zgłasza, narzędziem list_merchant_issues. To wystarcza, żeby pisać treści reklam o produktach, które naprawdę istnieją, po cenach, które naprawdę obowiązują, i wyjaśnić kampanię, która milczy.

Narzędzia także zapisują. create_merchant_data_source tworzy feed produktów API, upsert_merchant_product wstawia produkt do niego, update_merchant_product zmienia pola, które zmieniają się codziennie (cenę i dostępność), a delete_merchant_product i delete_merchant_data_source usuwają je po potwierdzeniu. list_merchant_data_sources pokazuje, które feedy faktycznie przyjmują zapis.

Trzy rzeczy warto wiedzieć od razu. Google blokuje każde wywołanie Merchant API, dopóki projekt Cloud Hermoso nie zostanie zarejestrowany w Twoim koncie Merchant Center, więc register_merchant_developer wykonuje to połączenie raz i mówi o tym wprost. To nie jest zepsute połączenie i ponowne połączenie tego nie naprawi. Zapisy produktów trafiają tylko do źródła danych API: feed plikowy, autofeed i feed tworzony przez interfejs Merchant Center wyświetlają się normalnie, ale wszystkie odmawiają zapisu. Hermoso wybiera dla Ciebie feed, do którego można pisać, tworzy go, jeśli nie ma żadnego, i odmawia po nazwie, jeśli jest ich kilka, zamiast wrzucać produkt na rynek, na który Twoje kampanie mogą nie być ustawione. A upsert_merchant_product to zapis całego wiersza, podczas gdy update_merchant_product to poprawka. Do pierwszego wyślij każde pole, które ma zostać, do drugiego tylko pola, które zmieniasz.

Nic z tego nie oznacza, że musisz przenosić katalog. Jeśli feed już jest w Shopify albo na Twojej platformie, zostaw go tam i pozwól agentowi go czytać; zapisy są dla przypadków, gdy nic jeszcze nie jest właścicielem feedu, albo gdy jedną cenę lub dostępność trzeba poprawić teraz, a nie przy następnej synchronizacji.

Google Analytics 4, żebyś widział, co zrobiły kliknięcia

Raportowanie Google Ads kończy się na kliknięciu. To, co działo się potem (sesja, rejestracja, zamówienie), znajduje się w Google Analytics, a to samo logowanie Google tam sięga (to osobne połączenie, bo wymaga własnego uprawnienia).

Twój agent może ustalić, którą właściwość GA4 odczytać, narzędziem list_analytics_properties. Ma to znaczenie, bo każde wywołanie Analytics wymaga numerycznego identyfikatora właściwości, a to, co zwykle masz, to identyfikator pomiaru G-XXXXXXXXX z fragmentu śledzenia. Następnie analytics_report zwraca sesje, użytkowników, konwersje i przychód z podziałem na kanał, źródło/medium, kampanię, stronę docelową, kraj, urządzenie lub datę, a analytics_realtime pokazuje, kto właśnie jest na stronie. Dzięki temu „zbuduj kampanię” i „powiedz mi, ile zarobiła” to ta sama rozmowa.

Narzędzia również zapisują i to jest część, która wraca prosto do Google Ads: create_analytics_key_event oznacza zdarzenie, które GA4 już zbiera, jako zdarzenie kluczowe, czyli dokładnie to, co Google Ads importuje jako konwersję, a bez akcji konwersji żadna strategia inteligentnych stawek z tej strony nie zadziała. create_analytics_custom_dimension rejestruje parametr zdarzenia, żeby raporty mogły go rozbijać, a list_analytics_definitions pokazuje, co właściwość już mierzy, zanim cokolwiek dodasz. Dwie rzeczy są stałe na zawsze: to tylko GA4, bo API nie ma żadnej powierzchni Universal Analytics, oraz wymiar niestandardowy można zarchiwizować, ale nigdy usunąć, a każda właściwość ma 50 miejsc na wymiary zdarzeń, więc agent najpierw sprawdza istniejący zestaw.

Blokada wydatków na żywo obejmuje więcej niż jedno narzędzie

Wstrzymanie kampanii to nie jedyny sposób, żeby nie wydawać pieniędzy, i traktowanie tego jako jedynego to realna pułapka: utworzenie włączonej grupy reklam, reklamy lub słowa kluczowego pod już włączonym elementem nadrzędnym zaczyna się wyświetlać w następnej aukcji. Dlatego to samo potwierdzenie, które chroni set_google_ads_status, chroni też create_google_ads_ad_group, create_google_ads_ad i add_google_ads_keywords, gdy element nadrzędny jest aktywny. Stan odczytywany jest z wiersza, który każde z tych narzędzi i tak pobiera, więc bez dodatkowego zapytania. Słowa wykluczające tylko ograniczają wydatki, więc nigdy nie wymagają zgody.

Raporty GAQL, z jednym zastrzeżeniem, które warto znać

google_ads_report przyjmuje dowolne zapytanie GAQL, więc Twój agent może poprosić o dokładnie ten wycinek danych, którego potrzebuje, zamiast być zamkniętym w stałym formacie raportu. Jedna rzecz do pamiętania, jeśli piszesz zapytania ręcznie albo pozwalasz modelowi je pisać: GAQL to nie SQL. Nie ma podzapytań, a IN przyjmuje dosłowną listę. Zapis WHERE id IN (SELECT …) jest nieprawidłowy i się nie wykona, zamiast po cichu zwrócić złe wiersze. Wynik możesz od razu wkleić do arkusza narzędziami create_sheet i append_to_sheet albo do dokumentu narzędziem create_doc.

Odczyt zwrotny, a potem raport

Po operacji mutate drzewo jest odczytywane z Google, a podsumowanie, które dostajesz, powstaje z tego odczytu, a nie z tego, co zostało zamówione. To mała dyscyplina, która wyłapuje konkretny błąd: agent pewnie opowiada o kampanii, którą platforma faktycznie zmieniła lub odrzuciła.

Czego nie zrobi bez pytania

Agent z budżetem jest użyteczny tylko wtedy, gdy zasięg jego działania jest ograniczony, więc uprawnienia do wydatków są egzekwowane na serwerze, a nie w prompcie. Kampanie, zestawy reklam i reklamy Meta są tworzone jako PAUSED, bez możliwości nadpisania przez wywołującego. Przełączniki statusu, które mogą uruchomić prawdziwe wydatki (jeden na każdej platformie reklamowej: set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status i set_openai_ads_status, między innymi), nie działają bez wyraźnej flagi potwierdzenia, a ta sama blokada obejmuje tworzenie włączonej grupy reklam, reklamy lub słowa kluczowego w Google Ads pod już włączonym elementem nadrzędnym, bo to zaczyna się wyświetlać w następnej aukcji. Usuwanie także wymaga potwierdzenia. Po stronie generowania hermoso_capabilities pokazuje dokładny koszt kredytów każdego modelu, zanim cokolwiek się uruchomi, a każde renderowanie rezerwuje szacunek, a potem rozlicza rzeczywisty koszt, więc nieudane wysłanie zwraca pieniądze zamiast po cichu obciążać Cię.

Podłączanie konta Google Ads

Łączysz Google Ads z Hermoso przez własny przepływ OAuth Google w Ustawieniach, w sekcji Łączniki; żadne hasło nie przechodzi przez model. Połączenia z Google Ads są współdzielone na poziomie marki, więc cały zespół pracujący na marce korzysta z jednego połączenia, zamiast każdy autoryzować się osobno.

Część kreatywna

Zarządzanie kampaniami ma sens tylko wtedy, gdy jest co uruchomić. Ten sam serwer bada, co już działa na Twoim rynku, w bibliotekach reklam Meta, Google i LinkedIn, renderuje gotowe kreacje graficzne i wideo oparte na Twoim prawdziwym produkcie w ponad 100 modelach i wgrywa zasoby, więc „co mamy puścić” i „zbuduj to” to jedna rozmowa zamiast dwóch narzędzi. Zobacz przegląd marketingowego MCP, pełną listę narzędzi albo Meta Ads MCP, jeśli prowadzisz obie platformy.

Najczęstsze pytania

Czy istnieje serwer MCP dla Google Ads?

Tak. Serwer MCP Hermoso buduje i zarządza kampaniami Google Ads z dowolnego klienta MCP: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad i add_google_ads_keywords do budowy drzewa Search lub displayowego; create_google_ads_performance_max_campaign dla Performance Max; set_google_ads_budget, set_google_ads_bidding i set_google_ads_targeting do konfiguracji; google_ads_keyword_ideas do badań w Planerze słów kluczowych; list_google_ads_campaigns i google_ads_report do raportów; odczyty Merchant Center dla feedu produktów za kampanią Shopping; oraz set_google_ads_status, wymagające potwierdzenia, do włączania.

Czy agent AI może utworzyć kampanię Google Ads?

Tak, i całe drzewo powstaje jedną atomową operacją z tymczasowymi identyfikatorami zasobów: kampania, grupa reklam, responsywna reklama tekstowa lub displayowa oraz słowa kluczowe razem. Jeśli reklama zostanie odrzucona, budżet też nie powstaje, więc nie zostajesz z osieroconymi obiektami do sprzątania. Tryb próbny sprawdza drzewo w żywym API bez tworzenia czegokolwiek.

Czy może utworzyć kampanię Performance Max?

Tak. create_google_ads_performance_max_campaign buduje budżet, kampanię, targetowanie, grupę zasobów i wszystkie powiązania zasobów jedną atomową operacją, bo Google wymaga ich razem. Kampania powstaje wstrzymana i jest odczytywana, zanim agent o niej zaraportuje. Minimalne wymagania Google dotyczące zasobów są egzekwowane, zanim cokolwiek zostanie wysłane: 3–15 nagłówków, 1–5 długich nagłówków, 2–5 opisów, nazwa firmy oraz co najmniej jedno logo, obraz marketingowy i kwadratowy obraz marketingowy. PMax licytuje tylko na konwersje, więc odmawia budowania na koncie bez włączonej akcji konwersji, zamiast tworzyć kampanię, która nie może się optymalizować. Retail PMax oparty na feedzie działa tak samo: podajesz merchantCenterId, kampania reklamuje katalog Merchant Center, a feedLabel zawęża ją do jednego feedu, a odczyt pokazuje konto Merchant Center i etykietę feedu, które Google faktycznie zapisał.

Czy działa z Google Merchant Center?

Tak, odczyty i zapisy, przez to samo połączenie z Google. Agent może wypisać konta Merchant Center, do których ma dostęp Twoje konto, odczytać produkty w feedzie (katalog, który faktycznie obsługuje kampania Shopping lub retail Performance Max) i odczytać problemy na poziomie konta, które zgłasza Google. To jedyne miejsce, w którym dowiesz się, dlaczego produkt się nie wyświetla, bo odrzucony produkt nie ma wyświetleń, które mogłoby pokazać raportowanie Google Ads. Google wymaga jednorazowej rejestracji projektu Cloud Hermoso w Twoim koncie Merchant Center, zanim API zacznie odpowiadać, i jest narzędzie, które to wykonuje. Zapisuje też: create_merchant_data_source, upsert_merchant_product, update_merchant_product do codziennych zmian ceny i dostępności oraz delete_merchant_product i delete_merchant_data_source, wymagające potwierdzenia. Google akceptuje zapisy produktów tylko do źródła danych API, więc Hermoso wybiera dla Ciebie feed, do którego można pisać, i odmawia po nazwie, jeśli konto ma ich kilka.

Czy może zrobić badanie słów kluczowych?

Tak. google_ads_keyword_ideas wywołuje Planer słów kluczowych Google i zwraca realne miesięczne wolumeny wyszukiwań, konkurencję i zakresy stawek na górze wyników, z podanych słów, adresu strony docelowej lub całej witryny. Agent może przekazać je prosto do add_google_ads_keywords albo zapisać w Arkuszu Google.

Czy może zacząć wydawać mój budżet Google Ads?

Tylko po wyraźnym potwierdzeniu. set_google_ads_status to przełącznik, który uruchamia prawdziwe pieniądze, a ponieważ utworzenie włączonego elementu podrzędnego pod już włączonym elementem nadrzędnym zaczyna się wyświetlać w następnej aukcji, to samo potwierdzenie chroni też create_google_ads_ad_group, create_google_ads_ad i add_google_ads_keywords, gdy element nadrzędny jest aktywny. Słowa wykluczające tylko ograniczają wydatki i nigdy nie wymagają zgody.

Czy może generować raporty?

Tak. google_ads_report przyjmuje dowolne zapytanie GAQL, więc agent może poprosić o taki wycinek danych, jaki potrzebuje. Pamiętaj, że GAQL nie jest SQL-em: nie ma podzapytań, a IN przyjmuje dosłowną listę, więc WHERE id IN (SELECT …) jest nieprawidłowe. Wyniki można od razu zapisać w Arkuszu lub Dokumencie Google.

Jakie stawki i targetowanie może ustawić?

Sześć strategii stawek, harmonogram kampanii oraz targetowanie geograficzne i językowe, a find_google_ads_locations rozwiązuje lokalizacje po nazwie. Budżety ustawia set_google_ads_budget, a słowa kluczowe obsługują wykluczenia i stawkę CPC dla każdego słowa.

Czy agent dostaje moje hasło do Google?

Nie. Łączysz Google Ads przez własny przepływ OAuth Google w Ustawieniach Hermoso, w sekcji Łączniki, a Hermoso przechowuje uzyskany token. Agent wywołuje wyłącznie narzędzia Hermoso. Połączenia z Google Ads są współdzielone na poziomie marki, więc cały zespół pracuje na jednym połączeniu.

Czy może też przygotować kreację reklamy?

Tak. Ten sam serwer bada reklamy konkurencji, planuje koncepcję, renderuje gotowe kreacje graficzne i wideo w ponad 100 modelach z Twoim prawdziwym produktem, a zasoby wgrywa narzędziem upload_google_ads_asset, więc badanie, kreacja i budowa kampanii dzieją się w jednej rozmowie.