Serwer MCP Loyalz

Co serwer daje agentowi

Większość marketingowych serwerów MCP daje asystentowi jedno konto reklamowe. Loyalz to warstwa, która już trzyma każdą podpiętą platformę reklamową obok rozliczonych zamówień sklepu, program lojalnościowy prowadzony przez sklep, pipeline kreacji zasilający reklamy i kalendarz, który planuje posty marki w social mediach. Serwer MCP wystawia wszystkie cztery przez jedno połączenie, w zakresie jednego konta merchanta:

• Insights — zapytania o wydatki, kliknięcia, konwersje, przychód, zamówienia, POAS/ROAS i każdą metrykę wyliczaną w Meta, Google, TikTok, LinkedIn, WooCommerce, Shopify, Sellasist i e-mailu; budowanie i edycja dashboardów; własne metryki z formuł; lista kampanii i pojedynczych reklam z wynikami i kreacją; zasięg i częstotliwość zdeduplikowane przez platformę reklamową; wyszukiwane hasła, ustawienia kampanii, działania konwersji i strategie ustalania stawek odczytywane na żywo z Google Ads, a z Meta na żywo umiejscowienia, nowi i powracający klienci, godziny, okna atrybucji zestawów reklam, wielkość grupy odbiorców i stan piksela.
• Lojalność — odczyt i kształtowanie programu (poziomy, questy, zadania, kolekcje benefitów, rankingi), przyznawanie punktów, cashbacku lub benefitów wskazanemu klientowi, odczyt ksiąg.
• Creative Studio — profil marki i referencje, runy konceptów dla statyków i wideo z ludzką bramką przeglądu promptów, teksty reklam z kontrolą zgodności, akceptacje, publikacja zatwierdzonych kreacji do istniejącego zestawu reklam Meta jako reklamy wstrzymane oraz playbook marki wyuczony na jej własnych wynikach.
• Kalendarz treści — podpięte konta społecznościowe marki (Facebook, Instagram, LinkedIn, TikTok, YouTube, X), biblioteka mediów zasilana wgraniami, linkami albo kreacjami ze Studio oraz zaplanowane posty. Agent pisze szkice, a zatwierdza je człowiek.

Prompty, które działają od pierwszego dnia

• "Compare Meta and Google spend against store revenue for the last 30 days, by week, and tell me which channel has the better POAS."
• "Add a KPI card with blended CAC to the Weekly dashboard."
• "Create a quest worth 200 points for customers who follow us on Instagram."
• "Show the three best-performing ads in our summer campaign and draft a static concept run from the winner."
• "Put the approved summer creative on Instagram and Facebook for Friday at 6 pm, as a draft I can approve."

Podłączenie

Potrzebujesz konta merchanta Loyalz i tokena MCP. Tokeny tworzy się w panelu merchanta w Ustawienia → Agents API; każdy token jest przypisany do jednego merchanta i można go tam w każdej chwili unieważnić. Wysyłaj go jako nagłówek Bearer przy żądaniu SSE i przy każdej wiadomości. Tokeny w adresie URL nie są akceptowane.

Claude Code

claude mcp add --transport sse loyalz https://api.loyalz.io/api/mcp/sse --header "Authorization: Bearer <token>"

Claude Desktop, Cursor, Windsurf i inne klienty z mcpServers clients

{
  "mcpServers": {
    "loyalz": {
      "type": "sse",
      "url": "https://api.loyalz.io/api/mcp/sse",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Dowolny klient lub SDK MCP

GET https://api.loyalz.io/api/mcp/sse
Authorization: Bearer <token>
Accept: text/event-stream

# the server advertises the messages URL in the first event;
# POST every JSON-RPC message there with the same Authorization header

Po połączeniu wywołaj raz tools/list . Katalog poniżej to dokładnie to, co zwraca. Narzędzia Creative Studio przyjmują obiekt input , także odczyty bez pól ({"input": {}}); pozostałe narzędzia przyjmują argumenty bezpośrednio.

Katalogi konektorów Claude.ai i ChatGPT

Hostowane katalogi Claude i ChatGPT logują użytkowników przez OAuth 2.1 i oczekują transportu Streamable HTTP; statyczny token w nagłówku akceptują Claude Code, Claude Desktop, Cursor, Windsurf, SDK i własne agenty, ale nie te dwa katalogi. Logowanie OAuth i Streamable HTTP dla serwera Loyalz są w przygotowaniu. Do tego czasu łącz się przez klienta obsługującego nagłówki, jak wyżej; ta strona wskaże wpisy w katalogach w dniu ich uruchomienia.

Uwierzytelnianie, zakres i dziennik

• Jeden token, jeden merchant. Kontekstem połączenia jest merchant, do którego należy token. Żadne narzędzie nie przyjmuje id merchanta, id użytkownika ani argumentu „przełącz konto”; żeby pracować na innym koncie, połącz się tokenem tego konta.
• Tylko Bearer. Token podróżuje w nagłówku Authorization żądania SSE i każdego POST do endpointu wiadomości. Adresy sesji nie są poświadczeniami, a sesja nie przeżyje swojego tokena: unieważnienie jest sprawdzane ponownie przed każdym wywołaniem narzędzia.
• Bramki planów działają jak w aplikacji. Narzędzia Insights wymagają włączonego Insights na koncie; narzędzia Creative Studio wymagają planu Shark lub wyższego; narzędzia Kalendarza treści wymagają włączonego kalendarza na koncie. Zablokowane wywołanie zwraca jasną odmowę, nigdy częściowe dane.
• Zapisy są idempotentne. Narzędzia zmieniające stan lub wydające kredyty przyjmują idempotency_key; ponowione wywołanie z tym samym kluczem zwraca pierwotny wynik zamiast działać dwa razy.
• Dziennik. Działania wykonane przez serwer są logowane per merchant i dostępne przez get_mcp_history. Studio i publikacja prowadzą własne rejestry operacji.

Katalog narzędzi

113 narzędzi · 55 w Creative Studio · wygenerowane z rejestru serwera 28 października 2026

read bez zmiany stanu writes zmienia dane na Twoim koncie wydaje kredyty pobiera lub rezerwuje kredyty Studio

Co może pójść nie tak, a co nie może

• Pieniądze. Żadne narzędzie nie przelewa pieniędzy ani nie zmienia subskrypcji. Kroki Studio oznaczone „wydaje kredyty” korzystają z prepaidowych kredytów; studio_list_credit_packs zwraca tylko linki do checkoutu, nigdy nie kupuje.
• Reklamy. studio_publish tworzy reklamy w istniejącym zestawie reklam Meta w stanie paused ; nic nie idzie na żywo, dopóki człowiek nie włączy tego w Ads Managerze. Narzędzia odczytu nigdy nie zmieniają konta reklamowego, także te, które odczytują Google Ads i Meta na żywo.
• Posty w social mediach. Narzędzia kalendarza tworzą i edytują szkice, a szkic nigdy się nie publikuje. Post wychodzi o swojej godzinie dopiero po zatwierdzeniu: w panelu Loyalz albo przez calendar_approve_post na wyraźną prośbę użytkownika o zatwierdzenie tego posta. Edycja zatwierdzonego posta cofa go do szkicu.
• Klienci. Przyznanie punktów, cashbacku lub benefitów zmienia saldo prawdziwego klienta i jest logowane z podanym przez Ciebie powodem. Używaj kluczy idempotencji.
• Dane. Odpowiedzi narzędzi zawierają dane marketingowe Twojego konta, agregaty zamówień, e-maile klientów z ksiąg lojalnościowych i zasoby kreacji. To, co Twój klient AI zrobi z odpowiedzią narzędzia, regulują zasady tego klienta; Loyalz nie wysyła Twoich danych do żadnego dostawcy modeli jako efekt uboczny wywołania.
• Limity. Wywołania Studio uruchamiające pracę wizyjną lub generowanie są ograniczane per konto; ograniczone wywołanie zwraca wskazówkę o ponowieniu zamiast cicho zawodzić. Odczyty Meta na żywo na jednym koncie reklamowym są rozdzielone co najmniej 8 sekundami, więc duże zapytanie chwilę trwa.

Dla recenzentów katalogów i integratorów

• First-party API. Serwer działa na api.loyalz.io, tym samym backendzie, który obsługuje panel merchanta Loyalz. Każde narzędzie czyta lub zapisuje własne konto Loyalz merchanta; narzędzia odczytu na żywo Google Ads i Meta czytają też własne konta reklamowe merchanta, przez połączenie, które merchant założył w Loyalz, i nic poza nimi.
• Konta i plany. Wymagane jest konto merchanta (umów demo , żeby je dostać). Narzędzia Insights wymagają włączonego Insights na koncie; narzędzia Creative Studio wymagają planu Shark. W pełni przygotowane konto testowe do przeglądu wydajemy na prośbę wysłaną na majewski@loyalz.io.
• Odczyt i zapis to osobne narzędzia. Nie ma narzędzia „do wszystkiego”; każde robi jedną rzecz i jest oznaczone powyżej jako odczyt, zapis lub wydaje kredyty. Zapisy przyjmują klucz idempotencji. Narzędzia odczytu na żywo Google Ads i Meta mają też readOnlyHint: true w tools/list.
• Efekty uboczne z pieniędzmi lub zasięgiem. Narzędzia generowania Studio wydają prepaidowe kredyty. studio_publish tworzy wyłącznie wstrzymane reklamy. Narzędzia kalendarza piszą szkice; calendar_approve_post to jedyne narzędzie, które pozwala opublikować post, i wolno go użyć tylko na wyraźną prośbę użytkownika. Nic nie przelewa pieniędzy, nie zmienia subskrypcji ani nie wysyła wiadomości do klientów.
• Znane ograniczenia. Jeden merchant na token; brak przełączania kont w sesji. Wywołania wizyjne i generujące Studio są ograniczane per konto. Dane z platform reklamowych są tak świeże, jak ostatnia synchronizacja (dobowa, ze śróddziennymi synchronizacjami sklepu), poza narzędziami odczytu na żywo Google Ads i Meta, które pytają platformę w chwili wywołania.
• Kategorie. Analityka marketingowa · Reklama · E-commerce · Lojalność i CRM · Produkcja kreacji · Planowanie postów w social mediach.

Prywatność, regulamin i wsparcie

• Polityka prywatności: loyalz.io/legal/privacy/
• Regulamin: loyalz.io/legal/terms/ i Terms for Brands
• Usuwanie Twoich danych, w tym danych Meta: loyalz.io/legal/data-deletion/
• Wsparcie i pytania o katalogi: majewski@loyalz.io; sprawy prywatności: privacy@loyalz.io
• Stan serwera: ta strona jest aktualizowana przy zmianie katalogu; bieżący build odpowiada na tools/list 113 narzędziami.

Historia zmian

• 2026-10-28 — katalog liczy teraz 113 narzędzi. Meta Ads odczytywane na żywo w Insights (2 narzędzia): wiersze insights z umiejscowieniami, demografią, nowymi i powracającymi klientami oraz godzinami, a także pola jednego zestawu reklam, kampanii, konta reklamowego, piksela albo szacunek wielkości grupy odbiorców zestawu reklam. Oba odrzucają pola spoza listy dozwolonych. Narzędzia odczytu na żywo Google Ads i Meta mają readOnlyHint w tools/list.
• 2026-10-24 — katalog liczy teraz 111 narzędzi. Google Ads odczytywane na żywo w Insights (5 narzędzi): wyszukiwane hasła, ustawienia kampanii, działania konwersji, strategie ustalania stawek i zapytanie GAQL tylko do odczytu. Creative Studio mówi, czego brakuje w profilu marki, i odmawia płatnego runu na niepełnym profilu, dopóki użytkownik tego nie potwierdzi; zatwierdzenie promptów może nanieść logo marki na obrazy.
• 2026-10-23 — katalog liczy teraz 106 narzędzi. Kalendarz treści (14 narzędzi); kampanie, pojedyncze reklamy i zasięg na żywo w Insights (3 narzędzia); w Creative Studio (12 narzędzi) playbook marki, mapa pokrycia, grupy odbiorców, brief marki, umieszczanie logo, kontrola zgodności tekstów reklam i wyniki opublikowanych reklam.
• 2026-09-23 — dodano Creative Studio (43 narzędzia); uwierzytelnianie tylko nagłówkiem, parametr zapytania ?token= został wycofany; katalog liczy 77 narzędzi.
• 2026-07-17 — narzędzia Insights: katalog metryk, silnik zapytań, dashboardy i metryki wyliczane.
• 2026-06 — pierwsza publiczna wersja: narzędzia programu lojalnościowego.

Załóż konto merchanta Przeczytaj: dlaczego jeden MCP dla reklam i sklepu