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 i pipeline kreacji zasilający reklamy. Serwer MCP wystawia wszystkie trzy 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ł.
• 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, akceptacje oraz publikacja zatwierdzonych kreacji do istniejącego zestawu reklam Meta jako reklamy wstrzymane.

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."

Connect

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. Każde narzędzie przyjmuje obiekt input , także odczyty bez pól ({"input": {}}).

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. Zablokowane wywołanie zwraca jasną odmowę z nazwą wymaganego planu, 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

77 narzędzi · 43 w Creative Studio · wygenerowane z rejestru serwera 23 września 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 dotykają konta reklamowego.
• 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ć.

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. Żadne dane zewnętrzne nie są proxowane; każde narzędzie czyta lub zapisuje własne konto Loyalz merchanta.
• 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.
• Efekty uboczne z pieniędzmi lub zasięgiem. Narzędzia generowania Studio wydają prepaidowe kredyty. studio_publish tworzy wyłącznie wstrzymane reklamy. 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).
• Kategorie. Analityka marketingowa · Reklama · E-commerce · Lojalność i CRM · Produkcja kreacji.

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 77 narzędziami.

Changelog

• 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