Kto co robi
| Etap | Ty | Ja |
|---|---|---|
| 1. Zakres | Wskazujesz platformy i konta oraz osoby, które mają pracować z ADOS. | Przygotowuję instalację z ustalonym zakresem. |
| 2. Dostęp do kont | Nadajesz dostęp do kont reklamowych po stronie Google i Meta. | Autoryzuję połączenia i sprawdzam, które konta są widoczne. |
| 3. Token | Odbierasz osobisty plik z adresem i tokenem. | Generuję osobny token dla każdej osoby. |
| 4. Podłączenie | Wklejasz jedną komendę w swoim kliencie AI i robisz test. | Pomagam, jeśli test nie przechodzi. |
Co przygotować
- Klient AI obsługujący MCP. Instrukcja opisuje Claude Code; dla Claude Desktop dostajesz ode mnie gotowy wpis do pliku konfiguracyjnego.
- Listę kont — które konta Google Ads, Meta Ads i TikTok Ads oraz które usługi dodatkowe (GA4, Search Console, Merchant Center, GTM) mają być dostępne.
- Uprawnienia administratora na tych kontach — bez nich nie nadasz dostępu.
Krok 1. Token
Każda osoba dostaje własny token, ograniczony do uzgodnionych kont i platform. Dzięki temu wiadomo, kto wykonał operację, a aktywne konto wybrane przez jedną osobę nie zmienia się u pozostałych.
Token działa jak hasło do kont reklamowych. Nie wklejaj go do rozmów z AI, na Slacka, do zgłoszeń ani do repozytorium. Jeśli mógł wyciec — napisz, wymienię go na nowy; stary przestaje działać.
Krok 2. Podłączenie w Claude Code
Otwórz terminal i wklej komendę z otrzymanego pliku. Ma taką postać:
claude mcp add --transport http -s user ados <ADRES> --header "Authorization: Bearer <TOKEN>"Zwróć uwagę na
-s user. Bez tego wpis działa tylko w katalogu, w którym uruchomiono komendę — w innych projektach ADOS nie będzie widoczny.Uruchom Claude Code i wpisz
/mcp. ADOS powinien być na liście jako połączony.
Jeśli masz dostęp do kilku instancji (np. osobno Google Ads i Meta), plik zawiera osobną komendę dla każdej.
Krok 3. Test
Test narzędzi. Napisz asystentowi: „Pokaż moje konta”. Powinna wrócić lista kont z ustalonego zakresu.
Test samego tokena — gdy asystent nie widzi ADOS. W terminalu:
curl -s -o /dev/null -w '%{http_code}' -H "Authorization: Bearer <TOKEN>" <ADRES>Wynik
406oznacza, że token został przyjęty. Wynik401— token jest błędny albo niepełny.
Dostęp do kont Google
Połączenie z Google idzie przez oficjalne logowanie Google (OAuth) — bez przekazywania haseł. Zakres uprawnień jest dobierany do tego, co ma działać:
| Usługa | Zakres | Uwagi |
|---|---|---|
| Google Ads | odczyt i zmiany | Zawsze włączony. |
| Google Analytics 4 | odczyt albo odczyt i edycja | Dwa osobne poziomy. |
| Search Console | odczyt albo odczyt i zapis | Dwa osobne poziomy. |
| Merchant Center | dostęp do konta sprzedawcy | |
| Google Tag Manager | edycja kontenerów | Publikacja na żywo to osobne uprawnienie. |
| Arkusze Google | dostęp do arkuszy | Do eksportu raportów. |
Możemy zacząć od samego odczytu i dołożyć kolejne zakresy później — wcześniej przyznane uprawnienia zostają.
Dostęp do kont Meta
Po stronie Meta ADOS działa jako użytkownik systemowy w Menedżerze firmy (Business Manager). Kolejność ma znaczenie — token generuje się dopiero po przypisaniu zasobów.
Udostępnij zasoby. W Ustawieniach firmy przypisz użytkownikowi systemowemu ADOS z pełną kontrolą: konta reklamowe, strony na Facebooku, konta Instagram, piksele i katalogi produktów.
Zasób należy do innej firmy? Właściciel dodaje moją firmę jako partnera: Ustawienia → Partnerzy → Dodaj, z identyfikatorem partnera, który podam.
Token. Generuje się go w Ustawieniach firmy → Użytkownicy systemowi, z ważnością „Nigdy” i uprawnieniami z tabeli niżej. Kopiuj go przyciskiem „Kopiuj” — zaznaczenie myszą potrafi uciąć końcówkę.
| Brak tego zasobu | Skutek |
|---|---|
| Konto reklamowe | Konto jest niewidoczne w ADOS. |
| Strona na Facebooku | Nie da się czytać postów ani tworzyć reklam z postów. |
| Konto Instagram | Brak dostępu do treści z Instagrama. |
| Piksel / zbiór danych | Brak zdarzeń z witryny. |
| Katalog produktów | Brak reklam katalogowych. |
| Uprawnienie tokena | Do czego | Status |
|---|---|---|
ads_management | Tworzenie i edycja kampanii, zestawów reklam, reklam i kreacji. | wymagane |
ads_read | Odczyt i statystyki. | wymagane |
business_management | Strony, piksele, katalogi i konta Instagram z Menedżera firmy. | wymagane |
pages_show_list | Lista stron. | wymagane |
pages_read_engagement | Posty strony. | wymagane |
pages_manage_ads | Reklamy z postów strony. | wymagane |
instagram_basic | Treści z Instagrama i konto Instagram w kreacji. | wymagane |
catalog_management | Katalogi i zestawy produktów. | zalecane |
leads_retrieval | Leady z formularzy. | zalecane |
read_insights, instagram_manage_insights | Statystyki stron i Instagrama. | zalecane |
instagram_manage_comments | Komentarze pod reklamami na Instagramie. | zalecane |
Aplikacja Meta, przez którą działa połączenie, musi być w trybie „Live”. W trybie deweloperskim Meta blokuje tworzenie reklam.
TikTok Ads: kroki autoryzacji zależą od konta — ustalamy je indywidualnie przy uruchomieniu.
Praca na wielu kontach
- Każde konto Google Ads ma krótki alias — używasz go w rozmowie zamiast numeru, np. „zdiagnozuj konto sklep-demo”.
- Konto Meta wybierasz na czas rozmowy: „ustaw aktywne konto Meta na…”. Wybór jest zapamiętany osobno dla każdej osoby.
- Nowe konto, do którego nadano dostęp, pojawia się na liście po synchronizacji — jeśli go nie widzisz, napisz do mnie.
Jak ADOS zapisuje zmiany
Najpierw podgląd. Każde narzędzie, które coś zmienia, domyślnie tylko pokazuje plan: co zostanie zmienione i na jakie wartości. Na koncie nic się nie dzieje.
Potem Twoja decyzja. Zmiana jest wykonywana dopiero po wyraźnym potwierdzeniu w rozmowie.
Na końcu sprawdzenie. Po zapisie ADOS podaje, gdzie zweryfikować zmianę w panelu platformy.
- Etykieta zmian w Google Ads. Zmienione kampanie dostają etykietę z datą w formacie
ADOS:DD.MM. W panelu Google Ads odfiltrujesz po niej wszystko, co danego dnia zmienił asystent. - Nowe kampanie startują wstrzymane. Narzędzia tworzące kampanie i reklamy zakładają je ze statusem wstrzymanym — włączasz je świadomie.
- Usuwanie jest domyślnie zablokowane na poziomie konta. Zamiast usuwać, ADOS wstrzymuje.
- Budżety. Budżet dzienny powyżej progu ustawionego dla konta (domyślnie 500) oraz obniżka budżetu o więcej niż 75% są zatrzymywane i wymagają osobnej decyzji.
- Publikacja GTM na żywo wymaga osobnego uprawnienia i osobnego potwierdzenia. Powrót do starszej wersji kontenera wymaga dodatkowego potwierdzenia.
- Włączona kampania nie zawsze emituje. ADOS odróżnia status ustawiony od faktycznej emisji — zapytaj „czy ta kampania realnie się wyświetla?”.
Cofanie zmian. Zmianę na koncie reklamowym cofa się kolejną zmianą — np. przywróceniem poprzedniego budżetu — po takim samym podglądzie i potwierdzeniu. Etykieta z datą pomaga znaleźć, co było zmieniane. Wersje kontenera GTM można przywracać bezpośrednio.
Pierwsze polecenia
| Co napisać | Co się stanie | Tryb |
|---|---|---|
| „Pokaż moje konta” | Lista kont w Twoim zakresie. | odczyt |
| „Zdiagnozuj konto sklep-demo” | Przegląd konta z listą problemów według wagi. | odczyt |
| „Jakie frazy marnują budżet?” | Wyszukiwane hasła z kosztem bez konwersji — kandydaci do wykluczenia. | odczyt |
| „Porównaj ten tydzień z poprzednim” | Zestawienie wyników w dwóch okresach. | odczyt |
| „Podnieś budżet kampanii Brand o 20%” | Podgląd zmiany; zapis po Twoim potwierdzeniu. | zmiana |
| „Wyklucz frazy: darmowe, torrent” | Podgląd listy wykluczeń; zapis po potwierdzeniu. | zmiana |
| „Pokaż zmiany ADOS z 03.11” | Kampanie z etykietą z tego dnia. | odczyt |
| „Sprawdź limity API i ustawienia bezpieczeństwa” | Zużycie dziennego limitu Google Ads API i aktualne ograniczenia instalacji. | odczyt |
Pełna lista narzędzi z przykładami poleceń: ADOS — możliwości.
Typowe problemy
| Objaw | Przyczyna | Co zrobić |
|---|---|---|
W /mcp ADOS raz jest „authenticated”, raz „needs authentication”, a ponowne logowanie nic nie daje | ADOS używa stałego tokena, nie logowania. Brak nagłówka, błędny token albo wpis dodany tylko dla jednego katalogu. | W /mcp wybierz „Clear authentication” (nie „Re-authenticate”). Potem claude mcp remove ados i dodaj wpis ponownie komendą z kroku 2. |
Test tokena zwraca 401 | Token błędny, ucięty przy kopiowaniu albo wymieniony na nowy. | Skopiuj token ponownie z pliku; jeśli dalej 401 — napisz do mnie. |
| „Pokaż moje konta” zwraca pustą listę | Konto Google użyte do autoryzacji nie ma dostępu do żadnego konta reklamowego albo autoryzacja wygasła. | Sprawdź, czy dostęp został nadany; resztę odnawiam po stronie serwera. |
| Meta: komunikat o trybie deweloperskim aplikacji | Aplikacja Meta nie jest w trybie „Live”. | Przełącz aplikację na „Live” w panelu Meta for Developers. |
| Meta: „Application does not have permission” | W tokenie brakuje instagram_basic albo konto Instagram nie jest przypisane. | Przypisz konto, dodaj uprawnienie i wygeneruj nowy token. |
| Meta: „page access token is required” | Strona na Facebooku nie jest przypisana do użytkownika systemowego. | Przypisz stronę w Ustawieniach firmy. |
| Meta: „session invalidated” | Użyto tokena osobistego — unieważnia się po zmianie hasła. | Wygeneruj token użytkownika systemowego. |
| Meta: „could not be decrypted” przy wklejaniu tokena | Token ucięty przy kopiowaniu. | Użyj przycisku „Kopiuj” w panelu Meta. |
| Zmiana budżetu została zatrzymana | Przekroczony próg budżetu dziennego albo obniżka większa niż 75%. | Potwierdź ją osobno albo podziel na mniejsze kroki; próg zmieniam na życzenie. |
| Publikacja GTM odrzucona z informacją o cofnięciu wersji | Publikowana wersja jest starsza niż najnowsza. | Potwierdź, że to zamierzony powrót do starszej wersji. |
Odcięcie dostępu
- Jedna osoba: usuwam jej token — przestaje działać od razu, pozostali pracują dalej.
- Google: odbierz dostęp aplikacji na stronie zabezpieczeń konta Google albo usuń użytkownika w ustawieniach konta Google Ads.
- Meta: odbierz zasoby użytkownikowi systemowemu albo usuń partnera w Ustawieniach firmy.
Odpowiedzialność za zatwierdzone zmiany jest po Twojej stronie — asystent pokazuje propozycję i jej zakres, a decyzję podejmujesz Ty.