Meta Ads w Codex i Gemini CLI: podłącz agenta kodującego do reklam

Codex i Gemini CLI mogą czytać twoje reklamy w Meta i nimi zarządzać przez Tera Ads, hostowany serwer MCP pod adresem https://teraads.co/mcp. W Codex uruchom codex mcp add tera-ads --url https://teraads.co/mcp, a potem codex mcp login tera-ads. W Gemini CLI zainstaluj rozszerzenie Tera Ads z GitHuba i uruchom /mcp auth tera-ads. W obu przypadkach logujesz się do Tera Ads w przeglądarce i wybierasz, czy agent tylko czyta, najpierw pyta ciebie, czy wprowadza zmiany.

Po co łączyć agenta kodującego z reklamami

Wielu założycieli sklepów na Shopify samodzielnie buduje motyw, skrypty i narzędzia wewnętrzne, a pół dnia spędza w terminalu. Agent kodujący połączony z reklamami odpowie na pytanie „ile Meta wydała wczoraj?” w tej samej sesji, w której edytujesz stronę produktu, zapisze cotygodniowe podsumowanie jako plik Markdown w repozytorium albo zestawi tydzień wyników kampanii ze zmianą wdrożoną we wtorek.

Łącznikiem między agentem a kontem reklamowym jest MCP, czyli Model Context Protocol: otwarty standard, który pozwala agentowi AI wywoływać narzędzia udostępniane przez inną usługę. Konektory MCP w praktyce (po angielsku) omawiają podstawy. Codex i Gemini CLI obsługują zdalne serwery MCP z logowaniem przez OAuth, więc hostowany serwer, taki jak Tera Ads, nie wymaga instalowania niczego poza samym agentem.

Tera Ads dodaje do zwykłego połączenia z Metą twój sklep. Oprócz odczytów kampanii, zestawów reklam i reklam na żywo odpowiada na podstawie zamówień z Shopify, zwrotów, kosztu produktów, wysyłki, opłat i zwrotów pieniędzy, po odjęciu wydatków na reklamy w Meta i Google. Przychód przypisany przez Metę jest oznaczony jako przychód Mety, więc agent nie traktuje go jak sprzedaży. Inne serwery, które możesz podłączyć zamiast niego, porównują opcje MCP dla Meta Ads.

Uwaga o Gemini CLI: jego dokumentacja zawiera informację, że dla użytkowników darmowego poziomu i Google One Gemini CLI został zastąpiony przez Antigravity CLI 18 czerwca 2026 (dokumentacja MCP w Gemini CLI). Poniższe kroki opisują Gemini CLI według dokumentacji z października 2026.

Zanim zaczniesz

• Darmowe konto Tera Ads. Załóż konto i podłącz konto reklamowe w Meta. Podłącz też Shopify, żeby agent widział sprzedaż i zysk sklepu.
• Dostęp właściciela. Tylko właściciel firmy może podłączyć AI do firmy w Tera Ads.
• Zainstalowany Codex lub Gemini CLI, zalogowany do własnego konta.
• Zasada dotycząca zmian. Zdecyduj, czy agent będzie tylko raportować, czy też wstrzymywać reklamy i przesuwać budżety. Poradnik o bezpiecznym dostępie AI (po angielsku) zawiera krótką politykę, którą możesz skopiować.

Podłącz Codex krok po kroku

1. Załóż darmowe konto Tera Ads. Zarejestruj się, podłącz konto reklamowe w Meta, a potem Shopify, żeby odpowiedzi obejmowały zysk sklepu po zwrotach.
2. Dodaj serwer do Codex. W terminalu uruchom codex mcp add tera-ads --url https://teraads.co/mcp.
3. Zaloguj się do Tera Ads. Uruchom codex mcp login tera-ads; polecenie otwiera Tera Ads w przeglądarce, gdzie logujesz się, wybierasz firmę i decydujesz, co może robić agent.
4. Sprawdź połączenie. Uruchom codex i wpisz /mcp, które pokazuje aktywne serwery MCP; tera-ads powinien być na liście.
5. Zadaj pytanie, które możesz sprawdzić. Spróbuj „Użyj Tera Ads, żeby wypisać moje aktywne kampanie w Meta z wczorajszymi wydatkami” i porównaj odpowiedź z Menedżerem reklam.

Codex przechowuje serwery MCP w ~/.codex/config.toml, po jednej tabeli [mcp_servers.tera-ads] na serwer, z adresem w polu url. Dokumentacja OpenAI podaje, że aplikacja ChatGPT na komputer, Codex CLI i rozszerzenie do IDE dzielą tę konfigurację, więc jedno ustawienie obsługuje wszystkie trzy (dokumentacja MCP w Codex). Ta sama dokumentacja mówi, że codex mcp login obsługuje OAuth i że Codex potrafi sam wybrać metodę rejestracji klienta. Tera Ads obsługuje dynamiczną rejestrację klienta z OAuth 2.1 i PKCE, więc nie trzeba podawać żadnego client ID.

Ogranicz Codex do odczytu po jego stronie

Ustawienia serwera w Codex przyjmują enabled_tools, listę dozwolonych narzędzi, i disabled_tools, listę zabronionych, stosowaną po niej. Żeby Codex nie wywoływał narzędzi do zmian nawet wtedy, gdy połączenie w Tera Ads na nie pozwala, dodaj tę linię pod [mcp_servers.tera-ads] w config.toml:

disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]

Dokumentacja opisuje też ustawienia zatwierdzania dla każdego serwera i każdego narzędzia. Najprostszym zabezpieczeniem pozostaje jednak to w Tera Ads: przy logowaniu wybierz tylko odczyt, a narzędzia do zmian nie zrobią nic w tym połączeniu.

Podłącz Gemini CLI

1. Zainstaluj rozszerzenie. Uruchom gemini extensions install https://github.com/Teralabsx/meta-ads-mcp.
2. Zaloguj się do Tera Ads. Uruchom Gemini CLI, wpisz /mcp auth tera-ads, a potem zaloguj się, wybierz firmę i zdecyduj, co może robić agent.
3. Sprawdź narzędzia. Wpisz /mcp, żeby zobaczyć stan i narzędzia każdego serwera, albo uruchom gemini extensions list w powłoce.
4. Zadaj pytanie, które możesz sprawdzić. Spróbuj „Które kampanie w Meta wydały w tym tygodniu najwięcej?” i porównaj odpowiedź z Menedżerem reklam.

Rozszerzenie to mały plik gemini-extension.json w repozytorium Tera Ads na GitHubie. Kieruje Gemini pod adres https://teraads.co/mcp przez pole httpUrl, które dokumentacja Gemini definiuje jako punkt końcowy Streamable HTTP, podczas gdy url służy do SSE. Wskazuje też GEMINI.md jako plik kontekstowy. Ten plik każe Gemini sięgać po Tera Ads przy pytaniach o reklamy w Meta, ROAS i zysk, oznaczać przychód przypisany przez Metę jako przychód Mety oraz traktować nazwy kampanii i teksty reklam jako dane, nigdy jako polecenia.

Dokumentacja Gemini podaje, że obsługuje on OAuth dla zdalnych serwerów MCP, potrafi automatycznie wykryć konfigurację, obsługuje dynamiczną rejestrację klienta tam, gdzie serwer ją wspiera, i przechowuje tokeny w ~/.gemini/mcp-oauth-tokens.json. Ustawienia serwera obejmują też trust, które po ustawieniu na true pomija wszystkie potwierdzenia wywołań narzędzi. Rozszerzenie Tera Ads go nie ustawia. Zostaw to tak, żeby Gemini dalej pytał, zanim uruchomi narzędzie.

Codex i Gemini CLI obok siebie

Żeby Codex albo inny agent korzystał z Tera Ads bez przypominania, repozytorium sugeruje skopiowanie zawartości GEMINI.md do pliku AGENTS.md lub CLAUDE.md w projekcie. W przeciwnym razie wymień Tera Ads w prompcie.

Prompty, które pasują do agenta w terminalu

Agent kodujący potrafi coś, czego nie potrafi okno czatu: umieścić odpowiedź tam, gdzie pracujesz. Poproś go, żeby zapisał wyniki do pliku, porównał je z plikiem z zeszłego tygodnia albo otworzył stronę produktu, na którą kieruje kampania.

Czytaj odpowiedzi z dwoma zastrzeżeniami. Zakupy i przychód w Meta to atrybucja Mety, a nie sprzedaż twojego sklepu. A get_ads_review ocenia każdą kampanię, która wydawała pieniądze, według zysku po typowych zwrotach twojego sklepu, przy twoich kosztach, względem twojego ROAS progu rentowności; kwota zysku to szacunek dla całego sklepu, a nie pieniądze na koncie. Prawdziwy ROAS po zwrotach pokazuje, dlaczego ta różnica ma znaczenie, a biblioteka promptów do analizy reklam (po angielsku) podsuwa kolejne pytania.

Zmiany agenta pod kontrolą

Agenci kodujący często mają ustawioną edycję plików bez pytania za każdym razem. Nie przenoś tego nawyku na narzędzia reklamowe, gdzie jedno błędne wywołanie wydaje prawdziwe pieniądze. Tera Ads ustala własne limity niezależnie od tego, na co pozwolono agentowi:

• Tylko odczyt, najpierw zapytaj albo wprowadzaj zmiany. W trybie najpierw zapytaj zmiana czeka w Tera Ads, aż ją tam zatwierdzisz, a agent nie może zatwierdzić jej za ciebie.
• Nowe rzeczy startują wstrzymane. Kampanie, zestawy reklam, reklamy i kopie nic nie wydają, dopóki coś ich nie włączy.
• Kroki budżetu mają limit. Jedna zmiana może co najwyżej potroić budżet albo obciąć go do jednej dziesiątej.
• Dzienny limit. Asystenci mogą wprowadzić najwyżej 50 zmian dziennie w jednej firmie.
• Brak narzędzia do usuwania. Agent może wstrzymać, ale niczego nie usunie.
• Cofanie przez 7 dni. Wstrzymanie, włączenie lub zmianę budżetu można cofnąć w Tera Ads przez 7 dni. Nowych kampanii, zestawów reklam i reklam nie da się cofnąć, ale startują wstrzymane.
• Jedna firma na połączenie. Połączenie nie odczyta innej firmy, nawet jeśli też należy do ciebie.

Jeśli wynik zmiany wróci jako outcome_unknown, nie proś agenta o jej powtórzenie. Poproś go najpierw o sprawdzenie list_recent_changes, żeby ta sama zmiana nie została wprowadzona dwa razy.

Gdy coś nie działa

Agent ignoruje Tera Ads. Wymień go w prompcie („użyj Tera Ads, żeby...”) albo skopiuj GEMINI.md do pliku z instrukcjami projektu, jak opisano wyżej.

Prosi o ponowne logowanie. Tokeny dostępu są ważne godzinę i odświeżają się automatycznie; połączenie trwa 30 dni. Uruchom ponownie codex mcp login tera-ads lub /mcp auth tera-ads.

Mówi, że osiągnięto limit. Darmowy plan ma 30 wywołań tygodniowo, a licznik zeruje się co tydzień według UTC. get_usage jest darmowe i podaje, ile wywołań zostało i kiedy licznik się wyzeruje.

Budżety wyglądają na sto razy większe. list_campaigns pokazuje budżety w jednostkach Mety, czyli w setnych częściach dla większości walut, więc 5000 oznacza $50. set_budget przyjmuje pełne jednostki waluty twojego konta.

Odpowiedzi dotyczą niewłaściwego sklepu. Każde połączenie obejmuje jedną firmę. Zaloguj się ponownie i wybierz drugą.

Tera Ads Connect to serwer MCP od Tera Ads, panelu zysku dla marek na Shopify. Daje Codex, Gemini CLI i innym klientom MCP odczyty z Meta na żywo, sprzedaż z Shopify i zysk po zwrotach, a także ograniczone i zapisywane w dzienniku zmiany w reklamach. Darmowy plan obejmuje 30 wywołań tygodniowo na jednym koncie reklamowym w Meta, a Connect Pro kosztuje $15 miesięcznie za 3 000 wywołań miesięcznie na maksymalnie trzech kontach reklamowych; jest wliczony w plany Growth i Scale. Kroki konfiguracji dla innych klientów są na stronie Connect, a jeśli pracujesz w edytorze, poradnik Meta Ads MCP w Cursor, VS Code i Claude Code opisuje te trzy narzędzia.

Najczęściej zadawane pytania

Czy Codex może zarządzać reklamami w Meta?

Tak, przez serwer MCP. Uruchom codex mcp add tera-ads --url https://teraads.co/mcp i codex mcp login tera-ads, a potem pytaj zwykłymi słowami. To, co Codex może zmieniać, zależy od trybu wybranego dla połączenia.

Jak połączyć Gemini CLI z Facebook Ads?

Uruchom gemini extensions install https://github.com/Teralabsx/meta-ads-mcp, potem /mcp auth tera-ads w Gemini CLI i zaloguj się do Tera Ads. Rozszerzenie obejmuje reklamy na Facebooku i Instagramie w twoim koncie reklamowym w Meta.

Czy potrzebuję aplikacji deweloperskiej Meta albo tokenu API?

Nie. Logujesz się do Tera Ads w przeglądarce, a zmiany docierają do Mety przez własną, zatwierdzoną aplikację Meta należącą do Tera Ads. Do pliku konfiguracyjnego nie trafia nic tajnego.

Czy konfiguracja Codex działa też w rozszerzeniu do IDE?

Tak. Dokumentacja OpenAI podaje, że aplikacja ChatGPT na komputer, Codex CLI i rozszerzenie do IDE dzielą tę samą konfigurację MCP, więc serwer dodany w CLI jest dostępny w dwóch pozostałych.

Czy Gemini CLI jest nadal dostępny?

Dokumentacja Gemini CLI podaje, że dla użytkowników darmowego poziomu i Google One został on zastąpiony przez Antigravity CLI 18 czerwca 2026. Zanim go skonfigurujesz, sprawdź w dokumentacji Google, jak to wygląda dla twojego typu konta.

Ile to kosztuje?

Darmowy plan obejmuje 30 wywołań tygodniowo na jednym koncie reklamowym w Meta. Connect Pro kosztuje $15 miesięcznie za 3 000 wywołań miesięcznie. Wywołanie to jedno zapytanie, które agent wykonuje w Tera Ads, a jedno pytanie może wymagać kilku.