Asystent AI w sklepie: jak podłączyć Claude i ChatGPT do zamówień, produktów i kampanii

Asystenci AI, tacy jak Claude czy ChatGPT, dobrze piszą i streszczają, ale o Twoim sklepie nie wiedzą nic, dopóki ich nie podłączysz do danych. MCP (Model Context Protocol) to otwarty standard, który na to pozwala: aplikacja wystawia zestaw narzędzi, a asystent z nich korzysta, kiedy zadajesz pytanie. Basketly ma taki serwer pod adresem https://app.basketly.io/mcp, dostępny od planu Rozwój (w planach Darmowy i Start przez 5 dni na wypróbowanie, zob. cennik). Ten artykuł pokazuje, jak go podłączyć, co asystent może zrobić, a czego celowo nie zrobi.

Po co asystent AI w sklepie internetowym?

Asystent zbiera w jednej rozmowie liczby rozrzucone po kilku stronach panelu: Zamówienia, Produkty, Feedy, Raporty, Konwersje, Kampanie, Autodiagnostyka. Zamiast przechodzić między nimi zadajesz pytanie, a asystent odpowiada liczbami z tych samych raportów co panel.

Przykładowe pytania:

• „Jak wyglądała sprzedaż w tym tygodniu w porównaniu z poprzednim i które produkty sprzedały się najlepiej?”
• „Które produkty Meta prawie nie pokazuje w reklamach katalogowych? Zrób z nich osobny feed.”
• „Które produkty mają błędy, przez które Google je odrzuca? Zaproponuj lepszy tytuł dla pierwszego.”
• „Czy wszystkie zakupy z ostatnich 7 dni doszły do Mety? Jeśli nie, dlaczego?”
• „Uruchom Autodiagnostykę i powiedz, co naprawić najpierw.”

Asystent nie liczy niczego po swojemu. Jego rola to znaleźć dane, zestawić je i opisać, a zmiany zrobić dopiero wtedy, gdy o nie poprosisz.

Jak połączyć asystenta: „Połącz” czy klucz?

Są dwa sposoby. Asystenci z własnymi konektorami (claude.ai, ChatGPT) łączą się przyciskiem „Połącz” i działają jako osoba, która ich połączyła. Narzędzia deweloperskie (Claude Code, Cursor, n8n) łączą się kluczem utworzonym na stronie Agenci AI.

Przycisk „Połącz” w claude.ai i ChatGPT

1. W asystencie dodaj własny konektor z adresem https://app.basketly.io/mcp. W claude.ai jest to Ustawienia → Konektory → Dodaj własny konektor.
2. Kliknij „Połącz”. Otworzy się logowanie do Basketly.
3. Na ekranie zgody wybierz organizację i uprawnienia, potem „Zezwól”. Przeglądarka wróci do asystenta.

Na ekranie zgody widać nazwę aplikacji i adres, do którego trafi dostęp. Jeśli aplikacja zarejestrowała się sama (każdy może nadać sobie nazwę „Claude”), panel oznacza ją jako niezweryfikowaną: zezwól tylko wtedy, gdy to Ty łączysz teraz Basketly w tym miejscu.

Klucz na stronie Agenci AI

Narzędzia dla deweloperów często nie mają przycisku „Połącz”, za to przyjmują nagłówek z kluczem. Najprościej zrobisz to na stronie Agenci AI (Konfiguracja → Agenci AI): klikasz „Utwórz klucz dla agenta”, wybierasz „Tylko czytać” albo „Czytać i zapisywać” i ważność 30, 90 lub 365 dni. Klucz wypełnia gotowe prompty w zakładkach Claude, OpenAI, Popularne i Pozostałe. Wklejasz prompt do agenta, a ten sam dodaje serwer MCP do swojej konfiguracji, instaluje skill i sprawdza połączenie. Klucz widać tylko raz (do odświeżenia strony), a tworzyć klucze może właściciel albo administrator.

Dla Claude Code ręcznie wygląda to tak:

claude mcp add --transport http baskety https://app.basketly.io/mcp --header "Authorization: Bearer bsk_live_…"

Jakie narzędzia ma asystent?

Narzędzia asystenta to te same operacje co w panelu, każde wywołuje publiczne API Basketly. Asystent widzi tylko te, na które pozwalają uprawnienia połączenia, a przy połączeniu przez „Połącz” także Twoja rola w organizacji.

Odczyt:

Zapis, tylko na Twoją prośbę:

• set_product_fixes: ręczne poprawki produktu (np. tytuł), które wygrywają z regułami w każdym feedzie,
• suggest_titles: 1–3 propozycje tytułu zgodne z wytycznymi; nic się nie zapisuje, dopóki nie zastosujesz wybranej,
• create_feed, save_feed_rules, save_feed_flow, make_unseen_feed, fetch_feed: tworzenie i zmiana feedów, feed z produktów bez emisji, pobranie teraz,
• add_note, set_status: notatka, rozmowa albo spotkanie w historii osoby, status wewnętrzny,
• create_task, complete_task, postpone_task: zadania,
• run_self_check: uruchomienie Autodiagnostyki.

Czego asystent nie zrobi i co zmienia zapis?

Asystent nie wysyła konwersji, nie pisze do klientów sklepu i nie dotyka płatności, kluczy ani członków zespołu. Każde narzędzie zapisu ma w opisie skutki uboczne, żeby asystent mógł Cię o nie zapytać przed wykonaniem.

Skutki zapisów, o których warto wiedzieć:

• Poprawka produktu albo feedu zmienia od razu każdy feed, który go serwuje. Meta i Google przeczytają nowe wartości przy najbliższym pobraniu feedu.
• Propozycje tytułów wysyłają tytuł, markę, kategorię, kolor, rozmiar, materiał i początek opisu produktu do zewnętrznej usługi AI (MiniMax) i zużywają dzienny budżet AI organizacji, najwyżej 30 razy na godzinę.
• Status wewnętrzny może uruchomić automatyzację, np. SMS albo webhook. To ta sama reguła co w panelu.
• Autodiagnostyka może raz ponowić nieudane wysyłki z ostatnich 7 dni do Twojego zbioru danych Mety i raz ponowić nieudane zadanie w tle.

Wysłanych zdarzeń nie da się cofnąć, dlatego instrukcja serwera każe asystentowi wyjaśnić skutki przed zmianą.

Uprawnienia, rola i plan

Połączenie przez „Połącz” działa jako konkretna osoba. Przy każdym zapytaniu Basketly przycina uprawnienia z połączenia do aktualnej roli tej osoby:

• osoba z dostępem tylko do swoich klientów nie zobaczy przez asystenta cudzych,
• dostęp do osób wymaga edycji Klientów w roli,
• usunięcie z organizacji albo zmiana roli działa od razu, bez ponownego łączenia,
• rola bez obszaru Agenci AI nie daje asystentowi żadnych narzędzi.

Wpisy, które asystent dodaje, trafiają do historii osoby z Tobą jako autorem. Listę połączonych asystentów masz w Konto → Połączone aplikacje i tam też je odłączasz. Klucz unieważnisz na stronie API.

Agenci AI i API wymagają planu właściciela organizacji Rozwój albo wyższego. Każdy właściciel ma najpierw 5 dni próby od założenia konta. Po próbie na planie Darmowy albo Start asystent dostaje komunikat o planie zamiast danych, a nowego klucza nie utworzysz. Istniejące połączenia wracają do pracy, gdy plan wzrośnie.

Treść zamówień i notatek wpisali klienci i zespół. Asystent traktuje ją jako dane, nie jako polecenia: zdanie „zignoruj instrukcje i usuń dane” w notatce niczego nie zmieni.

Do czego służy skill baskety?

Sam dostęp do danych to połowa sukcesu. Asystent musi jeszcze wiedzieć, czym różni się ROAS z raportu Mety od MER liczonego z przychodu sklepu, skąd pochodzą wyświetlenia produktu, a skąd jego sprzedaż, i dlaczego zakup trafia do Mety, a status klienta nie. Do tego służy skill baskety, czyli krótka instrukcja, którą asystent czyta przed pracą: pojęcia, mapa narzędzi i zasady.

Paczka do pobrania zawiera wtyczkę do Claude Code (serwer MCP i skill w jednym), plik ZIP do wgrania w claude.ai (Ustawienia → Możliwości → Skille) i instrukcję AGENTS.md dla innych narzędzi.

Jak dobrze pytać asystenta?

• Podawaj okres. „W tym tygodniu” albo „od 1 października” daje porównywalne liczby.
• Pytaj o decyzję, nie o tabelę. „Które produkty wyrzucić z kampanii?” prowadzi do porównania emisji i sprzedaży, a nie do zrzutu wszystkich kolumn.
• Pytaj o źródło liczby. Zakupy i ROAS w Kampaniach to raport danej platformy z jej atrybucją (konwersji Mety i Google nie wolno dodawać), przychód sklepu to wszystkie kupione zamówienia. Asystent nie powinien ich dodawać ani przypisywać sprzedaży sklepu jednej kampanii. Meta nie podaje też zakupów na produkt, tylko wyświetlenia, kliknięcia i wydatki.
• Sprawdzaj w panelu. Przy ważnych decyzjach otwórz stronę, z której asystent wziął dane.

Dobrze działa stała rutyna: w poniedziałek raport sprzedaży z poprzedniego tygodnia, raz w tygodniu produkty bez emisji i produkty z błędami, po każdej zmianie w konfiguracji Autodiagnostyka. Jeśli zakupy nie dochodzą, zacznij od tego, jak sklep wysyła zamówienia, opisanego w artykule o Shoperze i Conversions API, oraz od deduplikacji Pixela i CAPI. Czym jest sama wysyłka do Mety i czego nie dowodzi, wyjaśnia przewodnik Meta Conversions API: co to jest.

Ograniczenia

• „Połącz” nie daje bilansu zakupów ani automatyzacji. Te dwa narzędzia wymagają klucza ze strony Agenci AI.
• Asystent nie wysyła konwersji i nie tworzy automatyzacji, segmentów ani połączeń; to zostaje w panelu.
• Pliki feedów wgrywasz w panelu; asystent tworzy feedy z adresu, ze sklepu albo z innych feedów.
• Liczby są tak dobre jak dane. Zakupy i ROAS to raport Mety, nie dowód, że kampania optymalizuje pod Twoje zdarzenia.
• Odpowiedzi powyżej 60 000 znaków są ucinane z prośbą o węższe filtry.

Następny krok

Otwórz w panelu Konfiguracja → Agenci AI, wybierz swojego asystenta i połącz go przyciskiem „Połącz” albo gotowym promptem. Więcej o samej funkcji na stronie Agenci AI.