Dokumentacja AdSparky

AdSparky to zdalny serwer MCP (Model Context Protocol) i panel w przeglądarce dla specjalistów PPC, freelancerów i agencji, które prowadzą Google Ads i Meta Ads dla wielu klientów. Pracujesz na kontach klientów zwykłym językiem w Claude, ChatGPT, Claude Code, Codex albo innym kliencie MCP. Panel na www.adsparky.com pokazuje klientów, alerty, zmiany do zatwierdzenia, historię zmian i raporty.

Obsługiwane platformy:

• Google Ads
• Meta Ads (Facebook i Instagram)
• Google Analytics 4 (tylko odczyt)
• Google Tag Manager
• Google Merchant Center
• Opcjonalnie strona klienta przez wtyczkę AdSparky do WordPressa

Jedno konto agencji mieści wielu klientów. Profil klienta spina jego konta Google Ads, Meta, GA4, Tag Managera i Merchant Center, więc asystent zawsze pracuje na jednym wybranym kliencie.

Liczby pochodzą z API platform i liczy je silnik AdSparky według stałych reguł (np. okna 7, 14 i 28 dni, minimalna liczba konwersji przed werdyktem). Twój asystent AI opisuje wyniki i proponuje kolejne kroki - sam AdSparky nie uruchamia ani nie wywołuje żadnego modelu AI.

1. Załóż konto

AdSparky jest w zamkniętej becie, bezpłatnej do 4 listopada 2026. Konta zakłada się z zaproszenia: zapisz się na listę na adsparky.com, a dostaniesz e-mail z osobistym linkiem do rejestracji. Nic nie jest pobierane bez Twojej zgody. Zapisz się na listę

Członkowie zespołu dołączają z zaproszenia wysłanego z panelu agencji (Ustawienia → Zespół).

2. Podłącz Google i/lub Metę

W panelu otwórz Ustawienia → Połączenia: Google, Meta. Konta podłącza tylko właściciel albo administrator agencji. Wystarczy jedna platforma - drugą możesz dodać później.

Oba połączenia używają oficjalnego logowania OAuth Google i Mety przez zweryfikowane aplikacje. AdSparky nigdy nie prosi o hasło do Google ani Mety.

Google: jedno logowanie obejmuje Google Ads, GA4, Tag Managera i Merchant Center. Ekran zgody Google ma pole wyboru przy każdym zakresie. Jeśli odznaczysz któryś, połączenie działa, a panel pokaże, które funkcje bez niego nie zadziałają. AdSparky prosi o te zakresy:

Meta: logujesz się przez Facebooka i wybierasz, do których kont reklamowych i stron AdSparky ma dostęp. Strony są potrzebne tylko do formularzy kontaktowych - bez wybranej strony AdSparky nie odczyta jej leadów.

Uprawnienia, o które prosimy w Meta: ads_read, ads_management, business_management, pages_show_list, pages_read_engagement, pages_manage_ads, leads_retrieval

3. Dodaj klienta

Po podłączeniu konta, do których masz dostęp, pojawią się w Ustawienia → Połączenia. Kliknij „Dodaj jako klienta” przy koncie. AdSparky podpowiada konta Google i Meta o podobnych nazwach, żeby jeden klient miał oba. Gdy ktoś udostępni Ci nowe konto, użyj „Odśwież listę kont”.

Adres serwera jest taki sam dla wszystkich:

https://adsparky.onrender.com/mcp

Logujesz się kontem AdSparky (OAuth) i klikasz „Zezwól”. Asystent pracuje wtedy na klientach Twojej agencji i w granicach Twojej roli - nic ponad to. Korzystasz z własnej subskrypcji Claude albo ChatGPT.

Claude (claude.ai i Claude Desktop)

1. 1

   Otwórz Customize → Connectors (Dostosuj → Konektory). W planie Team/Enterprise konektor dodaje właściciel w Organization settings → Connectors.

2. 2

   Kliknij „+” → Add custom connector (Dodaj własny konektor).

3. 3

   Wpisz nazwę AdSparky i wklej adres serwera. Pola OAuth Client ID/Secret zostaw puste.

4. 4

   Kliknij Add, potem Connect - otworzy się logowanie AdSparky. Zaloguj się i kliknij „Zezwól”.

5. 5

   W rozmowie włącz AdSparky przez „+” → Connectors. Konektor działa też w aplikacji Claude Desktop i na telefonie.

ChatGPT

1. 1

   W przeglądarce otwórz ChatGPT → Plugins → „+” → Add custom MCP server. Dostęp zależy też od uprawnień Twojego obszaru roboczego.

2. 2

   Wpisz nazwę AdSparky i w polu Server URL wklej adres serwera z tej strony. Wybierz Authentication: OAuth.

3. 3

   Wybierz Create as a plugin i połącz konto - zaloguj się w AdSparky i kliknij „Zezwól”. Zainstaluj utworzoną wtyczkę.

4. 4

   W nowej rozmowie wpisz @ i wybierz AdSparky, potem poproś o sprawdzenie swojego klienta.

Claude Code

1. 1

   Dodaj serwer jedną komendą. Wklej w terminalu:

   claude mcp add -s user --transport http adsparky https://adsparky.onrender.com/mcp

2. 2

   Uruchom Claude Code. Wpisz /mcp, wybierz adsparky i Authenticate.

3. 3

   Zaloguj się i zezwól. Otworzy się logowanie AdSparky w przeglądarce. Zaloguj się i kliknij „Zezwól”.

Codex

1. 1

   Dodaj serwer jedną komendą. Wklej w terminalu:

   codex mcp add adsparky --url https://adsparky.onrender.com/mcp

2. 2

   Uruchom logowanie. Ta komenda otworzy logowanie AdSparky w przeglądarce:

   codex mcp login adsparky

3. 3

   Zaloguj się i zezwól. Zaloguj się w AdSparky i kliknij „Zezwól”. Potem uruchom Codex.

Inne klienty MCP i klucze API

Każdy klient, który obsługuje zdalne serwery MCP przez HTTP z logowaniem OAuth, połączy się tym samym adresem. Jeśli Twój klient nie umie logować się przez OAuth, utwórz klucz API w Ustawienia → Asystent AI (Claude / ChatGPT) → „Klucz API - dla Claude Code i Codex (opcja zaawansowana)” i wklej pokazaną tam komendę. Klucze są zapisane tylko jako skrót (hash) i można je odwołać na tej samej stronie.

Pierwsza wiadomość

Napisz „intro”. Asystent sprawdzi, co masz podłączone, i zaproponuje pierwsze polecenia z nazwami Twoich klientów.

Pisz zwykłym językiem, po polsku albo po angielsku. Kilka przykładów:

• “Zrób audyt konta Google Ads klienta X”
• “Dlaczego koszt konwersji wzrósł w zeszłym tygodniu?”
• “Które kreacje w Mecie się wypalają?”
• “Gdzie przepalamy budżet - miejsca docelowe i wyszukiwane hasła bez konwersji?”
• “Przejrzyj docelowy ROAS kampania po kampanii”
• “Zrób poranny przegląd wszystkich klientów”
• “Utwórz wstrzymaną kampanię w sieci wyszukiwania pod nową ofertę i pokaż podgląd”
• “Zduplikuj najlepszą reklamę w Mecie do nowego zestawu”
• “Podmień kreację w tej reklamie w Mecie”
• “Przygotuj raport miesięczny dla klienta”

Proste pojedyncze zmiany (np. wstrzymanie jednego słowa kluczowego) od razu trafiają do podglądu. Przy większych zadaniach - nowa kampania, zmiany w wielu kampaniach, strategia stawek - asystent najpierw ustala z Tobą krótkie zlecenie: cel, zakres, granice i oczekiwany wynik. Narzędzia zmieniające konta bez niego odmawiają.

AdSparky ma ponad 300 narzędzi do Google Ads, Meta Ads, GA4, Tag Managera, Merchant Center i strony klienta. Żeby lista narzędzi asystenta była krótka, widzi on rdzeń około 30 narzędzi do głównych ścieżek pracy (przeglądy, audyty, raporty, zmiany, historia i cofanie) oraz bramę: pozostałe narzędzia asystent wyszukuje po opisie i uruchamia przez bramę z tymi samymi zabezpieczeniami co przy wywołaniu bezpośrednim.

Każde narzędzie należy do jednego z trzech rodzajów:

Odczyt

Pobiera i analizuje dane. Niczego nie zmienia.

Zapis w AdSparky

Zapisuje w AdSparky notatki, wiedzę o kliencie, cele albo zlecenie. Nie dotyka kont reklamowych.

Zmiana na koncie

Zmienia konto reklamowe, kontener Tag Managera, Merchant Center albo stronę klienta. Zawsze z podglądem i potwierdzeniem (patrz Bezpieczeństwo).

Nazwy narzędzi i skład rdzenia zmieniają się razem z silnikiem. Aktualną listę możliwości z opisami pokazuje panel.

Próba na sucho i podgląd

Każda zmiana na koncie jest najpierw liczona na sucho i pokazana jako podgląd przed/po. Na tym etapie na koncie nic się nie zmienia.

Wyraźne potwierdzenie

Zmiana trafia na konto dopiero po Twoim potwierdzeniu - w czacie albo w kolejce do zatwierdzenia w panelu.

Dziennik zmian

Każda zmiana jest zapisana z autorem, czasem, źródłem (panel albo asystent), powodem i poprzednim stanem. Widać ją w Historii zmian.

Cofnięcie jednym krokiem

Prawie każdą zmianę da się cofnąć jednym krokiem. Nieliczne wyjątki podgląd oznacza, zanim potwierdzisz.

Bez usuwania

AdSparky nie usuwa kampanii, zestawów reklam ani reklam - najwyżej je wstrzymuje. Nowe kampanie i reklamy powstają wstrzymane.

Bezpiecznik budżetu

Jedna operacja może podnieść budżet najwyżej o 30% albo obniżyć najwyżej o 50%.

Limity klienta

Twarde granice dla klienta, np. maksymalny budżet dzienny, kampanie, których nie wolno ruszać, albo dozwolone platformy. Asystent nie może ich obejść. Z czatu można je tylko zaostrzyć, poluzować - tylko w panelu (Ustawienia klienta → Limity).

Automaty

Domyślnie automat tylko przygotowuje zmianę do zatwierdzenia. Samodzielne wykonywanie włącza właściciel albo administrator - i nadal obowiązują limity klienta oraz dzienny limit działań.

Role w zespole

Właściciel, Administrator, Specjalista i Podgląd. Podgląd tylko czyta: widzi dane i porady, ale nie przygotowuje ani nie zatwierdza zmian. Google i Metę podłącza tylko właściciel albo administrator.

• Każdy użytkownik sam autoryzuje swoje konta Google i Meta przez OAuth. AdSparky widzi tylko konta i zakresy, które udostępnisz.
• Tokeny Google i Mety są zaszyfrowane (AES-256-GCM). Klucze API i tokeny dostępu konektorów są zapisane tylko jako skróty (hash).
• Dane agencji są odizolowane: każde zapytanie jest ograniczone do agencji zalogowanego użytkownika, a dane nigdy nie trafiają do innych agencji korzystających z AdSparky.
• AdSparky sam nie wywołuje żadnego modelu AI. Rozumowanie odbywa się w Twoim Claude, ChatGPT, Claude Code albo Codex. Wyniki uruchomionych narzędzi wracają do tego asystenta i przetwarza je jego dostawca na podstawie Twojej umowy z nim.
• Dane służą wyłącznie do świadczenia usługi. Nie sprzedajemy ich, nie używamy do reklam ani do trenowania modeli AI. Dane z API Google przetwarzamy zgodnie z Google API Services User Data Policy, w tym z wymogami Limited Use.

Szczegóły, podmioty przetwarzające i okresy przechowywania:

• Polityka prywatności
• Regulamin
• Umowa powierzenia

Google albo Meta

Ustawienia → Połączenia: Google, Meta → Rozłącz. AdSparky unieważnia token w Google albo Mecie i go usuwa.

Na koncie Google

Usuń AdSparky na myaccount.google.com/permissions.

Na koncie Facebook

Usuń aplikację AdSparky w ustawieniach Facebooka. Meta wysyła wtedy do AdSparky żądanie usunięcia danych, a połączenie z Metą jest usuwane.

Aplikacje AI

Ustawienia → Asystent AI (Claude / ChatGPT) → Połączone aplikacje AI → Odwołaj. Aplikacja traci dostęp w ciągu 30 sekund. Klucze API odwołuje się na tej samej stronie. Konektor możesz też usunąć w Claude albo ChatGPT.

Wszystko

Właściciel agencji może usunąć agencję ze wszystkimi danymi w Ustawienia → Konto → Usunięcie agencji i danych.

Dostępy w Google: myaccount.google.com/permissions

Pytania albo problemy: napisz na kontakt@adsparky.com albo poproś asystenta o zgłoszenie problemu. Strona wsparcia