Konto reklamowe Meta w Claude Code i Codexie. Instrukcja

Jak podłączyć oficjalny connector Meta Ads do Claude Code i Codexa, jak zablokować włączanie reklam, jak sprawdzić, że połączenie działa naprawdę, i jak uruchomić w terminalu AdFlow.

Ten wpis jest dla osób z poziomu 4 z siedmiu poziomów pracy z AI, czyli dla tych, którzy pracują w Claude Code albo Codexie. Jeśli zarządzasz reklamami z czatu w Claude albo ChatGPT, instrukcja jest w pierwszym wydaniu newslettera i w pliku polaczenie/connector.md w folderze AdFlow. Tu jest to, co wyciąłem z maila, bo w czacie nie jest potrzebne.

Od kwietnia 2026 Meta ma oficjalny connector do swojego konta reklamowego. To serwer MCP pod adresem https://mcp.facebook.com/ads. Nic nie instalujesz, nie zakładasz aplikacji w Meta for Developers i nie trzymasz tokenu. Logujesz się kontem Facebooka i od tej chwili agent w terminalu czyta Twoje kampanie, wydatki i wyniki, a jeśli mu pozwolisz, buduje w koncie rzeczy wstrzymane.

Sam prowadzę reklamy, które zbierają zapisy na mój newsletter, przez skrypty pod API Mety w sesji Claude Code. Zaczynałem, zanim connector był dostępny. Dziś zacząłbym od connectora, bo oszczędza tydzień na tokenach i uprawnieniach.

Claude Code

Dwie drogi, wybierz jedną.

Przez konto claude.ai. Jeśli logujesz się do Claude Code kontem claude.ai, dodaj connector w ustawieniach Claude (Customize, Connectors, Add, Custom, Web, nazwa dokładnie Meta Ads, adres wyżej). Claude Code zalogowany tym samym kontem zobaczy go sam, ale dopiero w nowej sesji. Jeśli go nie widać, zamknij Claude Code i otwórz ponownie. Sprawdzisz to komendą /mcp.

Bezpośrednio w terminalu. Ta droga jest dla osób, które logują się do Claude Code kluczem API, a nie kontem claude.ai.

W terminalu wpisz claude mcp add --transport http -s user meta-ads https://mcp.facebook.com/ads. Dopisek -s user sprawia, że connector działa w każdym Twoim projekcie, nie tylko w folderze, w którym go dodałeś.
Uruchom Claude Code, wpisz /mcp, wybierz meta-ads i zaloguj się w przeglądarce kontem Facebooka, które ma dostęp do konta reklamowego. Zaznacz tylko te portfolia i konta reklamowe, którymi chcesz zarządzać przez agenta.

Dokumentacja Mety podaje tę komendę z dodatkowym parametrem --client-id i numerem własnej aplikacji w Meta for Developers. To wariant dla firm, które mają taką aplikację. Bez niej logowanie idzie przez OAuth Mety. Jeśli po zalogowaniu dostaniesz komunikat, że connector nie jest jeszcze włączony dla Twojego konta reklamowego, napisz do mnie, podam Ci skrypty pod API i jak wyciągnąć token.

Codex

W terminalu wpisz codex mcp add meta-ads --url https://mcp.facebook.com/ads.
Potem codex mcp login meta-ads i zaloguj się w przeglądarce kontem Facebooka.

Uczciwie. Komendy są z pomocy Codexa w wersji 0.154, sprawdziłem, że istnieją i przyjmują adres. Logowania do Mety w Codexie jeszcze nie przeszedłem do końca, bo pracuję w Claude Code. Jeśli u Ciebie zadziałało albo nie, napisz mi, dopiszę tu wynik.

Zablokuj włączanie reklam, zanim zadasz pierwsze pytanie

Connector ma ponad sto narzędzi. Większość czyta konto. Kilkanaście zmienia je. Jedno z nich, ads_activate_entity, włącza kampanię, zestaw albo reklamę, i od tej chwili płyną pieniądze. Wszystko, co connector buduje, powstaje wstrzymane, więc to jedyne narzędzie, które może wydać Twoje pieniądze bez kliknięcia w Menedżerze reklam.

W Claude Code blokadę trzyma plik .claude/settings.json w folderze, w którym pracujesz. W folderze AdFlow jest już gotowy. Wymaga zgody na każde narzędzie zapisu i blokuje całkiem włączanie oraz usuwanie, w obu wariantach nazw, mcp__claude_ai_Meta_Ads__… dla connectora z konta claude.ai i mcp__meta-ads__… dla connectora z terminala. Dlatego nazwa connectora ma być dokładnie Meta Ads w claude.ai albo meta-ads w terminalu. Przy innej nazwie blokada go nie obejmie.

Jeśli pracujesz we własnym folderze, skopiuj ten plik z AdFlow. W Codexie takiego pliku nie ma, więc zasada „nigdy nie włączaj reklam” musi stać w AGENTS.md i musisz czytać potwierdzenia. Druga blokada jest po stronie Mety. W ustawieniach firmy, w sekcji connectorów AI, możesz zostawić agentowi samo czytanie i tam też go odłączasz.

Sprawdź, czy połączenie działa

Zielona lampka przy connectorze to nie test. Zadaj pytanie, na które odpowiedź zna tylko prawdziwe konto.

Jak nazywa się moje konto reklamowe i ile wydałem w ostatnich 7 dniach?

Jeśli nazwa konta jest obca albo liczby są dziwne, zalogowałeś się nie tym profilem Facebooka. Potem porównaj kilka pierwszych odpowiedzi z Menedżerem reklam. Dopiero gdy się zgadzają, pozwalasz agentowi na zmiany.

Gdy nie działa

Co widzisz	Powód
Okno logowania się nie otwiera	Blokada wyskakujących okien w przeglądarce. Zezwól i spróbuj ponownie.
Zalogowany, ale nie widać konta reklamowego	Nie ten profil Facebooka. Wyloguj się i użyj tego, który ma dostęp do reklam.
„Brak uprawnień” albo pusta lista kont	Nie masz dostępu w ustawieniach firmy. Ktoś z uprawnieniami administratora musi go nadać.
Łączy się, ale liczby są puste	Często nowe konto bez wydatków. Sprawdź, kiedy ostatnio działała reklama.
Czyta, ale budowanie nie działa	Brak uprawnień administratora do konta reklamowego, nie tylko do strony.

Jeśli po tej liście nadal nie działa, nie trać na to wieczoru. Wyeksportuj raport z Menedżera reklam do CSV i pracuj na nim. W AdFlow ta ścieżka jest w polaczenie/eksport.md.

Trzy rzeczy, o które rozbija się pierwsza sesja

Nazwy pól. Connector ma własne nazwy metryk, inne niż w panelu. Unikalne kliknięcia linku to unique_link_click, wydatki to amount_spent, leady to lead. Zanim agent pobierze metryki, każ mu sprawdzić nazwy przez ads_get_field_context. Kosztu unikalnego kliknięcia linku connector nie podaje, agent liczy go sam, wydatki podzielone przez unikalne kliknięcia.
Zmiana budżetu wstrzymuje reklamę. Każda zmiana działającej kampanii, zestawu albo reklamy przez connector, poza nazwą, wstrzymuje ją. Budżety zmieniasz sam w Menedżerze reklam.
Kwoty w groszach. Connector przyjmuje budżet w najmniejszej jednostce waluty konta. 50 zł to 5000. Każ agentowi sprawdzić walutę konta i podawać Ci kwoty w złotych.

Connector widzi to, co widzi Meta

U mnie z pierwszych 5 zapisów z jednej reklamy Meta zobaczyła 1, bo większość ludzi ignoruje baner cookies, a bez zgody nie wysyłam Mecie informacji o zapisie. Panel pokazywał, że reklama idzie trzy razy gorzej, niż szła naprawdę. Connector czyta ten sam panel, więc jego wnioski są tak samo zaniżone.

W terminalu masz na to lekarstwo, którego nie ma w czacie. Agent zestawia zakupy z Mety z eksportem zamówień ze sklepu w pliku CSV i pokazuje, ile sprzedaży z reklam Meta nie widzi. Raport zapisuje do pliku, więc co tydzień masz porównanie z poprzednim, a nie jedną odpowiedź w czacie. Tak działa diagnoza w AdFlow, dlatego na start pyta, gdzie widzisz prawdziwą sprzedaż.

Ten wpis to podstawowy setup, czyli podłączenie connectora w terminalu. Jak spiąć go z eksportem z Twojej platformy sklepowej, jak oczyścić dane i jak zbudować z tego cotygodniowy raport, opiszę w kolejnych wydaniach newslettera.

AdFlow w terminalu

AdFlow to folder z plikami, który zamienia agenta w asystenta od reklam na Mecie dla sklepu. Na start tylko czyta konto, podaje liczbę i mówi, gdzie kliknąć. Pobierasz go z github.com/Macqq15/adflow, zielony przycisk Code, potem Download ZIP, albo przez git clone.

Otwórz terminal w folderze AdFlow.
Uruchom claude albo codex.
Napisz „start”.

Agent czyta AGENTS.md, zadaje cztery pytania o sklep (średnia wartość zamówienia, marża, gdzie widzisz prawdziwą sprzedaż) i robi pierwszą diagnozę. Wyniki lądują w twoja-praca/, więc następna sesja wie, na czym skończyliście. Jeśli po „start” nic się nie dzieje, napisz „Przeczytaj START-HERE.md i AGENTS.md, potem zacznij ze mną od początku”.

Pytania

Czy connector może włączyć reklamę i wydać moje pieniądze?

Connector ma narzędzie do włączania reklam. Wszystko, co buduje, powstaje wstrzymane, a włączanie blokujesz w ustawieniach. W Claude Code robi to plik .claude/settings.json w folderze AdFlow, w Claude ustawienia Tool permissions przy connectorze.

Czy potrzebuję klucza API Mety?

Nie. Logujesz się kontem Facebooka przez OAuth. Klucz i własna aplikacja w Meta for Developers są potrzebne dopiero wtedy, gdy connector nie jest jeszcze włączony dla Twojego konta reklamowego.

Czy connector widzi wszystkie moje zakupy?

Widzi tyle, ile widzi Meta. Jeśli część zakupów nie dociera do Mety, na przykład przez baner cookies, odpowiedzi connectora są tak samo zaniżone jak panel. Dlatego diagnoza porównuje Metę ze sprzedażą w sklepie.