Allegro MCP: jak połączyć Claude z danymi sprzedawcy z Allegro i BaseLinkera (Base)

Allegro nie ma oficjalnego serwera MCP (stan na 3 listopada 2026 r.). Claude dostanie dane sprzedawcy z Allegro na dwa sposoby: przez oficjalny MCP BaseLinkera (Base), jeśli zamówienia z Allegro już tam trafiają, albo przez serwer MCP na REST API Allegro, podłączony do własnej aplikacji sprzedawcy. Pierwsza droga daje zamówienia i stany ze wszystkich kanałów, druga także opłaty, wyświetlenia ofert i kampanie Allegro Ads.

Droga	Co widzi Claude	Logowanie	Zmiany na koncie	Kiedy wybrać
MCP Base	Zamówienia z Allegro i innych kanałów, katalog, stany, koszt zakupu	Konto Base (OAuth)	Osobne narzędzie, z potwierdzeniem	Sprzedajesz przez BaseLinkera (Base)
Serwer MCP na API Allegro	Oferty i ich wyświetlenia, zamówienia, opłaty, Allegro Ads	Własna aplikacja w Allegro i konto sprzedawcy	Tylko operacje, które włączysz	Potrzebujesz opłat i wyświetleń ofert
Asystent AI w Sales Center	Dane konta Allegro w panelu	Bez MCP	Nie, tylko czyta i radzi	Pytasz o jedno konto Allegro

Na koncie demo sprawdziliśmy, na co odpowiada pierwsza droga i gdzie się kończy. Pytanie brzmiało: który produkt sprzedaje się w sklepie internetowym, a na Allegro przestał.

Czy Allegro ma oficjalny MCP

Nie ma. W aktualnościach Allegro Developer Portal z września i października 2026 r. są zmiany w zamówieniach, zwrotach, ocenach, Centrum wiadomości i Allegro Ads, ale nie ma serwera MCP ani konektora do Claude czy ChatGPT. Źródło: Allegro Developer Portal, aktualności Które systemy sprzedaży oficjalny MCP już mają, zestawiliśmy w artykule o MCP dla e-commerce.

Allegro ma własnego asystenta w panelu. Asystent AI w Sales Center odpowiada na pytania o sprzedaż i od 3 września 2026 r. podpowiada m.in. przy opłatach i cenach, ale niczego nie zmienia i nie da się go podłączyć do Claude. Co potrafi, opisaliśmy w artykule o Asystencie AI Allegro w Sales Center.

Droga 1: MCP Base, gdy zamówienia z Allegro są w BaseLinkerze

Jeśli Allegro jest podpięte do BaseLinkera (Base), Claude czyta zamówienia z Allegro tam, gdzie są już razem ze sklepem, innymi marketplace’ami i katalogiem. Base udostępnia oficjalny serwer MCP pod adresem https://mcp.base.com/mcp, z logowaniem kontem Base. Źródło: pomoc Base, MCP w Base.com W Claude Code to jedno polecenie:

claude mcp add --transport http base https://mcp.base.com/mcp

Pomoc Base opisuje jedno narzędzie, Ask Sidebar. W naszym teście połączenia z 22 października 2026 r. Claude Code widział trzy: asystenta, wywołania metod odczytu API i wywołania wszystkich metod, oznaczone jako zmieniające dane.

Serwer base w Claude Code, polecenie /mcp, test z 22 października 2026 r. 1 Serwer i trzy narzędzia. 2 Run API call (read-only): metody get, z których korzysta przykład niżej. 3 Run API call (all methods), oznaczone jako destructive, bo może zmieniać dane.

Czego ta droga nie da: Base przechowuje zamówienia, katalog i stany, ale nie opłaty Allegro, wyświetlenia ofert ani wydatki na Allegro Ads. Szczegóły podłączenia i różnice między narzędziami są w artykule o BaseLinker (Base) MCP w Claude i ChatGPT.

Pytanie na koncie demo: co sprzedaje się w sklepie, a na Allegro nie

Sprawdziliśmy to na Ochrze, sklepie z ceramiką, który sprzedaje na Allegro, w sklepie internetowym i na Erli. Pytanie zadaliśmy tak, jak zadałby je kierownik e-commerce:

Które produkty w ostatnich czterech tygodniach (28.09–25.10.2026) sprzedawały
się w sklepie internetowym i na Erli, a na Allegro wyraźnie słabiej niż
w czterech tygodniach wcześniej (31.08–27.09)? Anulowane zamówienia pomiń.
Danych kupujących nie cytuj.

Odpowiedź policzyliśmy metodami API Base tokenem tylko do odczytu. To te same metody, które Claude wywołuje przez MCP Base narzędziem do odczytu:

1. getOrderSources: lista kanałów, żeby wiedzieć, który identyfikator to Allegro, sklep i Erli.
2. getOrders z date_from i stronicowaniem po date_add ostatniego zamówienia plus jedna sekunda: sześć wywołań, 581 zamówień od 1 września do 25 października 2026 r.
3. getInventoryProductsList: stan i cena produktu w katalogu.

Z zamówień wzięliśmy pola order_source_id (kanał), order_status_id (żeby pominąć anulowane) i z listy products pola sku, quantity i price_brutto.

Wynik dla produktu, który odstaje:

Filiżanka espresso „Ziarno” 90 ml	31.08–27.09	28.09–25.10
Allegro	27 szt. (22 zamówienia)	11 szt. (9 zamówień)
Sklep internetowy	4 szt. (4 zamówienia)	20 szt. (17 zamówień)
Erli	6 szt. (5 zamówień)	11 szt. (8 zamówień)
Razem	37 szt.	42 szt.
Cena w zamówieniach	45 zł we wszystkich kanałach	45 zł we wszystkich kanałach

Allegro jako całość nie spadło: sztuk wszystkich produktów sprzedało się tam 266 w pierwszym okresie i 283 w drugim. Filiżanka sprzedaje się dalej, tyle że kupujący biorą ją teraz w sklepie i na Erli. Cena się nie zmieniła, towar jest (w katalogu 6 sztuk przy cenie 45 zł). Coś zmieniło się po stronie oferty na Allegro.

Przy okazji wyszedł drugi produkt, który na Allegro sprzedaje się słabo od początku danych: zestaw 4 talerzy za 299 zł. Od 1 września na Allegro poszły 4 z 20 sprzedanych zestawów, a w sklepie 14.

Sprawdzenie drugim sposobem

1. Zamówienia zamiast sztuk. Liczba zamówień z filiżanką daje ten sam obraz: na Allegro z 22 do 9, w sklepie z 4 do 17. Wynik nie bierze się z jednego dużego zamówienia.
2. Ceny z arkusza. Cena filiżanki w osobnym pliku z katalogiem sklepu to 45 zł, tyle samo co w każdym zamówieniu z obu okresów i w polu ceny w Base. Zmiana ceny odpada.
3. Anulowane zamówienia. Żadne anulowane zamówienie nie zawierało filiżanki, więc pominięcie anulowanych nie przesuwa wyniku.

Gdzie Base się kończy: dane z API Allegro

Dlaczego filiżanka przestała się sprzedawać na Allegro, z danych Base się nie dowiesz. Do tego potrzebne są dane z samego Allegro: liczba osób, które oglądały ofertę, cena konkurencji, koszty Allegro Ads i opłaty. Część z nich daje REST API Allegro. Lista ofert sprzedawcy (GET /sale/offers) zwraca dla każdej oferty pole visitsCount, czyli liczbę unikalnych użytkowników, którzy oglądali ofertę w ostatnich 30 dniach, i liczbę obserwujących. Źródło: specyfikacja Allegro REST API Opłaty i koszty kampanii są w operacjach billingowych.

Cen konkurencji przez API nie sprawdzisz. Na pytanie sprzedawcy, który chciał je czytać w swojej aplikacji do Claude’a, Allegro odpowiedziało w październiku 2026 r., że wyszukiwarka ofert (GET /offers/listing) nie jest już dostępna w publicznym API. Źródło: GitHub, allegro/allegro-api, zgłoszenie 14142

Takie pytanie najprościej zadać w Sales Center albo przez serwer MCP na API Allegro. Jeśli nie wiesz, którą drogą pójść przy swoim koncie, napisz, o co chcesz pytać, a podpowiemy, czy wystarczy Base.

Droga 2: serwer MCP na REST API Allegro

Serwer MCP na API Allegro działa na Twojej aplikacji i Twoim koncie sprzedawcy. Token zostaje u Ciebie, a Ty decydujesz, które operacje model może wywołać. Do pytań o sprzedaż wystarczą narzędzia odczytu: oferty z liczbą wyświetleń, zamówienia, opłaty i kampanie. Taki serwer budujemy w ramach integracji e-commerce. Niżej cztery kroki do uruchomienia.

Krok 1: aplikacja w Allegro

Dostęp do API dostajesz po zarejestrowaniu własnej aplikacji na apps.developer.allegro.pl. Źródło: Allegro Developer Portal, informacje podstawowe Serwer MCP uruchomiony w terminalu loguje się bez przeglądarki, więc aplikacja musi być typu device.

Opisz cel aplikacji konkretnie i zaznacz tylko te zakresy, których serwer naprawdę potrzebuje (więcej w kroku 2).

Allegro wymaga w każdym zapytaniu nagłówka User-Agent w formie NazwaAplikacji/Wersja (+AdresURL), z nazwą zgodną z zarejestrowaną aplikacją. Limit to 9000 zapytań na minutę na Client ID. Źródło: Allegro Developer Portal, informacje podstawowe

Krok 2: zakresy dostępu

Przy autoryzacji aplikacja prosi o zakresy (scope). Dokumentacja Allegro zaleca wystąpić tylko o te, które są potrzebne. Źródło: Allegro Developer Portal, uwierzytelnianie i autoryzacja Do pytań o sprzedaż wystarczą zakresy odczytu ofert, zamówień i opłat.

Zakresy dla zamówień w dokumentacji Allegro. 1 allegro:api:orders:read: tylko odczyt zamówień i przesyłek. 2 allegro:api:orders:write: zmiana statusów i tworzenie przesyłek, czego do analizy sprzedaży nie potrzebujesz.

Nie każdy obszar ma osobny zakres do odczytu.

Dwa zakresy z tej samej tabeli. 1 allegro:api:messaging: jeden zakres na odczyt i wysyłanie wiadomości w Centrum wiadomości. 2 allegro:api:billing:read: opłaty Allegro tylko do odczytu.

Krok 3: logowanie kontem sprzedawcy

Serwer wysyła prośbę o kod i pokazuje link. Otwierasz go zalogowany na konto sprzedawcy i potwierdzasz kod. Kod jest ważny godzinę, token dostępu 12 godzin, a refresh token przedłuża autoryzację do 3 miesięcy. Źródło: Allegro Developer Portal, uwierzytelnianie i autoryzacja

Odpowiedź z dokumentacji Allegro dla device flow. Sprzedawca widzi kod użytkownika i adres allegro.pl/skojarz-aplikacje. Dostęp aplikacji odbierzesz w Moim Allegro, w zakładce „Powiązane aplikacje”.

Krok 4: zapis wyłączony na start

Zmiana ceny, tytułu albo statusu oferty wymaga zakresu allegro:api:sale:offers:write. Na start serwer nie powinien pokazywać modelowi żadnego narzędzia zapisu. Gdy zapis jest potrzebny, włącz go dla konkretnych operacji, z potwierdzeniem przed wywołaniem i wpisem w logu. Zmiany, które zrobi model, kupujący widzą jako Twoje, a płatne opcje promowania mogą naliczyć opłaty.

Co zauważyliśmy

• Pierwsze liczenie ukryło zmianę. Za cały okres od 1 września filiżanka miała na Allegro 48% sprzedanych sztuk, przy średniej sklepu 56%. Nic nie odstawało. Dopiero podział na dwa okresy po cztery tygodnie pokazał spadek udziału Allegro z 73% do 26%. Pytaj zawsze o dwa okresy, a nie o średnią z całości.
• Lista kanałów zawiera nazwy kont. getOrderSources zwraca też nazwę konta Allegro podpiętego do Base. Claude zobaczy ją w rozmowie. Nam do odpowiedzi wystarczyły identyfikatory kanałów.
• Jedno zamówienie było spoza kanałów sprzedaży, z produktem, którego nie ma w katalogu. Pominęliśmy je. W swoim sklepie poproś model, żeby wypisał zamówienia, których nie przypisał do żadnego kanału.
• Wyświetlenia ofert są bez historii. visitsCount w API to unikalni oglądający z ostatnich 30 dni. Żeby porównać miesiąc do miesiąca, trzeba ten licznik zapisywać samemu, np. co tydzień.
• Małe liczby się wahają. 11 sztuk zamiast 27 to wyraźna różnica, ale przy kilku sztukach tygodniowo jeden tydzień nic nie znaczy. Tu różnica trzymała się przez cztery tygodnie.

Od czego zacząć

1. Jeśli Allegro jest w BaseLinkerze (Base), zacznij od MCP Base i pytań o zamówienia, kanały i stany. Przykład krok po kroku jest w artykule o spadku sprzedaży na Allegro w danych z Base.
2. Gdy pytania dotyczą opłat, wyświetleń i Allegro Ads, dołóż serwer na API Allegro z zakresami odczytu. Jeśli wolisz skrypt bez MCP, metody Base opisaliśmy w artykule o API BaseLinkera (Base) i raporcie sprzedaży.
3. Zapis (ceny, statusy, oferty) włączaj osobno, po teście na jednym produkcie. Gdy dane w Base nie zgadzają się z ERP albo magazynem, model odpowie pewnie na złych liczbach. Wtedy zacznij od audytu integracji Base i Apilo z ERP.