Integracje AI (MCP): Claude, ChatGPT i Cursor w Snomi
Na tej stronie
W skrócie
- MCP pozwala podłączyć asystenta AI, na przykład Claude albo ChatGPT, do Twojego konta Snomi. Potem pracujesz na katalogu poleceniami w zwykłej rozmowie.
- Asystent czyta dane (jakość, produkty, kanały, metryki, strategie, testy A/B) i proponuje zmiany. Każda zmiana i każdy koszt kredytów wymaga Twojej zgody w rozmowie.
- Asystent działa z Twoimi uprawnieniami. Nie zmieni cen, dostępności ani linków, nie usunie produktów, a każdą jego zmianę widać w Historii zmian i można ją cofnąć.
Czym jest MCP
MCP (Model Context Protocol) to otwarty standard łączenia asystentów AI z aplikacjami. Snomi ma własny serwer MCP, więc asystent, którego już używasz, może zajrzeć do Twojego katalogu i wykonać w Snomi to, o co poprosisz.
Przykład: zamiast otwierać Jakość katalogu, filtrować produkty i uruchamiać Optimizer Agent, piszesz w Claude „Pokaż, co najbardziej obniża jakość w sklepie Aviro, i zaproponuj poprawę tytułów w marce Kestro”. Asystent zbiera dane ze Snomi, pokazuje plan i koszt, a po Twojej zgodzie uruchamia zadanie.
Asystent pomaga, ale decyzje zostają po Twojej stronie: zmiany zatwierdzasz w rozmowie, a propozycje Optimizer Agent akceptujesz w panelu Snomi.
Zanim zaczniesz
- Plan: odczyt danych przez MCP działa we wszystkich planach, także w trialu. Zmiany przez MCP są dostępne w planach płatnych, od Starter. W trialu asystent może tylko czytać.
- Rola: asystent działa jako Ty, z Twoją rolą i dostępem do sklepów. Widz nic nie zmieni, nawet z połączeniem z zakresem zmian.
- Ustawienia firmy: właściciel albo administrator może wyłączyć MCP dla całej firmy albo zostawić tylko odczyt. Opis niżej w sekcji Ustawienia firmy.
- Asystent: potrzebujesz konta w aplikacji, która obsługuje MCP: Claude (claude.ai, Claude Desktop, aplikacja mobilna), ChatGPT w trybie dewelopera, Claude Code albo Cursor lub VS Code. To, czy możesz dodać własny konektor, zależy od planu w tej aplikacji.
Adres serwera MCP Snomi to https://mcp.snomi.app. Ten sam adres z przyciskiem Kopiuj znajdziesz w panelu w sekcji Integracje AI (MCP).
Ustawienia firmy
Sekcja Integracje AI (MCP) jest na stronie Organizacja, którą otworzysz z rozwijanej sekcji Ustawienia na dole menu. Zmienia ją właściciel albo administrator z uprawnieniem do zarządzania organizacją. Pozostałe osoby widzą ustawienia bez możliwości edycji.
| Ustawienie | Co robi |
|---|---|
| Adres serwera MCP | Adres do wklejenia w asystencie, z przyciskiem Kopiuj |
| MCP włączone dla firmy | Wyłączenie natychmiast blokuje wszystkie tokeny i połączone aplikacje w koncie firmowym |
| Zezwalaj na zmiany przez MCP | Wyłączone = asystenci mogą tylko odczytywać dane |
| Maks. produktów w jednej operacji | Od 1 do 10 000, domyślnie 500. Większą zmianę asystent musi podzielić albo trzeba ją zrobić w panelu |
Pod ustawieniami jest lista Tokeny i połączone aplikacje w firmie: kto ma dostęp, przez jaką aplikację, z jakim zakresem, do których sklepów, kiedy ostatnio z niego korzystał i kiedy dostęp wygasa. Przycisk Usuń odbiera dostęp od razu.
Podłączenie Claude
Tak podłączysz Claude na claude.ai. Konektor dodany na claude.ai działa też w Claude Desktop i w aplikacji mobilnej.
Dodaj konektor. W Claude otwórz Ustawienia → Konektory i wybierz Dodaj własny konektor. Wpisz nazwę
Snomii adreshttps://mcp.snomi.app.Zaloguj się do Snomi. Claude otworzy okno logowania Snomi. Zaloguj się jak do panelu, z kodem 2FA, jeśli masz je włączone.
Zatwierdź dostęp. Na ekranie Połącz aplikację ze Snomi wybierz Konto firmowe, Zakres dostępu (Tylko odczyt albo Odczyt i zmiany) i Sklepy (wszystkie albo wybrane), a potem kliknij Zezwól.
Sprawdź połączenie. Napisz w nowej rozmowie: „Użyj Snomi i pokaż moje sklepy”.
Na początek wybierz Tylko odczyt. Asystent pokaże wtedy, co potrafi, bez ryzyka zmian. Zakres zmienisz, usuwając połączenie i dodając je ponownie.
Podłączenie ChatGPT
ChatGPT łączy się z własnymi serwerami MCP w trybie dewelopera. Akcje, które zmieniają dane, są dostępne tylko w części planów ChatGPT.
Włącz tryb dewelopera. W ChatGPT otwórz Ustawienia → Aplikacje i konektory i włącz Tryb dewelopera.
Utwórz konektor. Wybierz Utwórz, wpisz adres
https://mcp.snomi.appi jako uwierzytelnianie wybierz OAuth.Zaloguj się i zatwierdź. Zaloguj się do Snomi i na ekranie Połącz aplikację ze Snomi kliknij Zezwól, tak jak przy Claude.
Claude Code
W Claude Code dodasz Snomi jednym poleceniem. Logowanie przez przeglądarkę:
claude mcp add --transport http snomi https://mcp.snomi.app
Potem w Claude Code wpisz /mcp, wybierz snomi i zaloguj się do Snomi.
Na serwerze albo w automatyzacji, gdzie nie ma przeglądarki, użyj tokenu API (opis w sekcji Token API):
claude mcp add --transport http snomi https://mcp.snomi.app --header "Authorization: Bearer snomi_pat_..."
Cursor i VS Code
W pliku konfiguracji MCP (w Cursorze .cursor/mcp.json, w VS Code w ustawieniach MCP) dodaj serwer Snomi z tokenem API:
{
"mcpServers": {
"snomi": {
"url": "https://mcp.snomi.app",
"headers": { "Authorization": "Bearer snomi_pat_..." }
}
}
}
Bez nagłówka Authorization edytor uruchomi logowanie w przeglądarce, jeśli je obsługuje.
Token API
Token API to klucz dla Claude Code, Cursora i automatyzacji. Claude i ChatGPT go nie potrzebują, bo łączą się przez logowanie.
Otwórz Moje konto. Kliknij swoje inicjały w prawym górnym rogu panelu, wybierz Moje konto i przejdź do sekcji Moje tokeny API i połączone aplikacje.
Ustaw token. Podaj Nazwę tokenu (na przykład „Claude Code - laptop”), Zakres (Odczyt albo Odczyt i zapis), Sklepy (puste pole = wszystkie dostępne) i Ważność w dniach: domyślnie 90, najwyżej 365.
Skopiuj token. Kliknij Utwórz token. Pełny token pokazujemy tylko raz, w oknie Skopiuj token teraz. Zapisz go w bezpiecznym miejscu i kliknij Gotowe.
Na tej samej liście widzisz też aplikacje połączone przez logowanie, na przykład Claude, z datą ostatniego użycia. Usuń odbiera dostęp natychmiast.
Token daje dostęp do Twoich danych w Snomi. Nie wklejaj go w rozmowie, nie wysyłaj e-mailem i nie zapisuj w repozytorium kodu. Jeśli trafił w niepowołane ręce, usuń go i utwórz nowy.
Jak pracować w rozmowie
Zacznij od „Użyj Snomi” i opisz, co chcesz osiągnąć. Asystent sam wybierze potrzebne dane. Przykłady:
| Cel | Przykładowe polecenie |
|---|---|
| Przegląd sklepu | „Użyj Snomi. Pokaż moje sklepy i jakość katalogu w sklepie Aviro.” |
| Plan poprawek | „Co najbardziej obniża jakość w sklepie Aviro? Zaproponuj kolejność poprawek.” |
| Poprawa treści | „Dla marki Kestro popraw tytuły w Optimizer Agent. Najpierw pokaż, ile to kosztuje.” |
| Kanały | „Dlaczego część produktów nie trafia do ChatGPT Ads?” |
| Google Ads | „Które produkty mają koszt bez konwersji w ostatnich 30 dniach?” |
| Testy A/B | „Które pary w testach A/B mają już wynik?” |
| Raport | „Przygotuj audyt strategiczny dla klienta dla sklepu Aviro.” |
| Historia | „Co zmieniło się w sklepie w tym tygodniu? Cofnij masową zmianę z wtorku.” |
W aplikacjach, które obsługują gotowe polecenia (prompty), na przykład w Claude Code, znajdziesz też komendy: przeglad-sklepu, raport-dla-klienta, plan-poprawy-tresci, produkty-przepalajace-budzet i przeglad-propozycji.
Asystent szuka też odpowiedzi w tym Centrum pomocy. Jeśli zapytasz, jak działa jakaś funkcja Snomi, poda wyjaśnienie z artykułów pomocy.
Zmiany z potwierdzeniem
Każda zmiana danych i każde uruchomienie, które zużywa kredyty, przebiega w dwóch krokach. Pilnuje tego serwer Snomi, więc asystent nie może tego kroku pominąć.
Podgląd. Asystent pokazuje, co zamierza zrobić: ile produktów obejmie zmiana, przykłady przed i po, koszt w kredytach i saldo po operacji. Produkty z blokadą zmienianego pola (kłódka) są pomijane i liczone w podglądzie.
Twoja zgoda. Zmiana dzieje się dopiero, gdy potwierdzisz ją w rozmowie. Jeśli asystent zmieni parametry, na przykład zakres produktów, musi pokazać nowy podgląd.
Gdy operacja obejmuje więcej produktów, niż pozwala ustawienie Maks. produktów w jednej operacji, Snomi ją odrzuca. Zawęź zakres albo podziel zmianę na części.
Część operacji asystent może przygotować, ale decyzję podejmujesz w panelu. Asystent wyjaśni wtedy powód i poda link:
- Optimizer Agent: asystent uruchomi generowanie propozycji, ale akceptujesz i odrzucasz je w panelu. Dostaniesz link do przeglądu tego uruchomienia. Otwórz go w przeglądarce, w której jesteś zalogowany do Snomi. Snomi nie wysyła maili o działaniach asystenta. Opis przeglądu w artykule Optimizer Agent.
- Testy A/B: asystent zastosuje wariant albo zostawi oryginał przy werdyktach „lepszy”, „gorszy” i „bez różnicy”. Werdykt „do sprawdzenia” i decyzję wbrew werdyktowi podejmujesz w panelu.
- Wstrzymanie i wznowienie AI sklepu oraz zatwierdzenie wstrzymanego importu są tylko w panelu.
Co asystent może, a czego nie
| Obszar | Przez MCP | Tylko w panelu albo wcale |
|---|---|---|
| Katalog | Wyszukiwanie produktów, odczyt kart, zmiana treści (tytuł, opis, atrybuty, etykiety), masowe zmiany treści | Cena, cena promocyjna, dostępność, linki, zdjęcia, GTIN, pola z blokadą; usuwanie i duplikowanie produktów |
| Jakość | Wynik, historia, problemy, grupy produktów, przeliczenie (osobny limit, opis niżej), audyt strategiczny | - |
| Optimizer Agent | Uruchomienie z podglądem kosztu, lista uruchomień i propozycji, anulowanie oczekujących propozycji z Twoich uruchomień | Akceptacja i odrzucanie propozycji, wstrzymanie AI |
| Import i kanały | Historia importu, ręczna synchronizacja, gotowość kanałów i produkty z problemami, podsumowanie zdjęć | Zmiana źródła feedu i mapowania, ustawienia i linki eksportu, zatwierdzenie wstrzymanego importu |
| Google Ads i Strategie | Stan połączenia, wybór konta reklamowego, Metryki, rozkład bucketów, strategie z podglądem skutków, zmiana statusu strategii, marże | Pierwsze połączenie konta Google (logowanie w przeglądarce, asystent poda link) |
| Testy A/B | Lista testów, wyniki par, decyzje przy jednoznacznym werdykcie | Werdykt „do sprawdzenia”, decyzja wbrew werdyktowi |
| Konto | Pula kredytów AI | Płatności, zespół, ustawienia organizacji i MCP, usuwanie sklepów |
Strategie i marże przez MCP działają tylko wtedy, gdy masz je w planie: w planie Agency albo z dodatkiem Strategie i marże.
Kredyty i koszty
Sama rozmowa z asystentem nie zużywa kredytów Snomi. Płacisz za nią w ramach swojego planu w Claude, ChatGPT albo innej aplikacji.
Kredyty Snomi schodzą tylko wtedy, gdy asystent uruchamia AI po stronie Snomi:
- Optimizer Agent: tyle samo co w panelu, opis w artykule Kredyty AI,
- Audyt strategiczny: 100 kredytów za raport.
Koszt zawsze widzisz w podglądzie przed potwierdzeniem. Jeśli w puli brakuje kredytów, Snomi odrzuci uruchomienie, zanim cokolwiek się zacznie.
Przeliczenie jakości katalogu przez asystenta ma osobny dzienny limit: 1 na sklep, w planie Agency 2. Każde takie przeliczenie liczy się też do limitu przeliczeń w panelu.
Historia zmian i cofanie
Każda zmiana wartości produktu, z panelu i od asystenta, trafia do Historii zmian i jest tam przez 30 dni. Historię otworzysz z menu profilu (Historia zmian, z zakładką dla każdego sklepu) albo w sklepie w grupie Katalog.
- W kolumnie Źródło zmiany od asystenta mają opis Asystent AI z nazwą aplikacji, na przykład Claude. Filtr Źródło → Asystent AI (MCP) pokazuje tylko je.
- Szczegóły pokazują produkty i pola przed i po zmianie.
- Cofnij przywraca poprzednie wartości. Pola, które ktoś później zmienił, zostają bez zmian, a podgląd cofnięcia je wymienia.
Swoje zmiany wprowadzone przez asystenta cofniesz też w rozmowie, na przykład „Cofnij ostatnią zmianę”. Zmiany z panelu i zmiany innych osób cofasz w panelu. Widz może przeglądać historię, ale nie cofa zmian. Pełny opis w artykule Historia zmian i cofanie zmian.
Bezpieczeństwo
- Asystent ma dokładnie Twoje uprawnienia: tę samą rolę i dostęp do tych samych sklepów co w panelu. Zakres połączenia może je tylko zawęzić.
- Tokeny i połączenia wygasają. Token API działa najwyżej 365 dni.
- Wyloguj wszędzie, zmiana hasła i reset hasła unieważniają wszystkie Twoje tokeny i połączone aplikacje. Usunięcie osoby z zespołu odbiera jej dostęp natychmiast.
- Połączenie usuniesz w Moje konto → Moje tokeny API i połączone aplikacje. Właściciel firmy usunie dowolne połączenie w Organizacja → Integracje AI (MCP).
- Treści produktów, na przykład tytuły i opisy z feedu, trafiają do asystenta jako dane. Mimo to zawsze czytaj podgląd zmian przed potwierdzeniem.
Gdy coś nie działa
Asystent nie widzi Snomi albo pisze o braku autoryzacji
Połączenie wygasło albo zostało unieważnione, na przykład po zmianie hasła albo Wyloguj wszędzie. Usuń konektor w asystencie i dodaj go ponownie, a przy tokenie API utwórz nowy token.
Asystent może tylko czytać dane
Sprawdź kolejno: zakres połączenia (Tylko odczyt albo Odczyt i zmiany), ustawienie Zezwalaj na zmiany przez MCP w Organizacji, swoją rolę (Widz nie zmienia danych) i plan (w trialu MCP działa tylko w trybie odczytu).
Asystent nie widzi któregoś sklepu
Przy połączeniu wybrano tylko część sklepów albo nie masz dostępu do tego sklepu w zespole. Dodaj połączenie ponownie z właściwymi sklepami albo poproś właściciela o dostęp.
Zmiana została odrzucona przez limit produktów
Operacja obejmuje więcej produktów, niż pozwala Maks. produktów w jednej operacji. Poproś asystenta o podział na mniejsze części albo zrób zmianę w panelu.
Asystent nie może zmienić ceny albo dostępności
To celowe. Cena, dostępność, linki, zdjęcia i GTIN pochodzą z feedu sklepu i Snomi ich nie nadpisuje przez asystenta.
Nie widzę sekcji Integracje AI (MCP) w panelu
Twój plan nie obejmuje MCP albo funkcja nie jest jeszcze dostępna na Twoim koncie. Napisz do nas.
Dodałem konektor Snomi, ale asystent go nie używa
Sprawdź, czy konektor Snomi jest włączony w tej rozmowie (w menu narzędzi czatu). Najlepiej zacznij nową rozmowę i napisz wprost „Użyj Snomi i pokaż moje sklepy”.
Okno logowania do Snomi się nie otwiera albo wraca do początku
Przeglądarka mogła zablokować wyskakujące okno. Zezwól na okna dla aplikacji asystenta i spróbuj jeszcze raz. Jeśli masz włączone 2FA, przygotuj kod z aplikacji. Pomaga też wcześniejsze zalogowanie do panelu Snomi w tej samej przeglądarce.
Na ekranie zgody widzę „Nie należysz do żadnego konta firmowego”
Twoje konto Snomi nie jest jeszcze przypisane do firmy, na przykład zaproszenie nie zostało przyjęte. Zaloguj się do panelu, dokończ dołączanie do konta firmowego i połącz asystenta ponownie.
Potwierdziłem zmianę, ale asystent pokazuje podgląd jeszcze raz
Asystent zmienił coś w parametrach (na przykład zakres produktów) albo potwierdzenie wygasło. Każda inna wersja zmiany wymaga nowego podglądu. Przeczytaj go i potwierdź jeszcze raz.
Zmiana została odrzucona, bo pole jest zablokowane
Produkt ma kłódkę na tym polu. Przy masowej zmianie takie produkty są pomijane, a gdy wszystkie mają blokadę, zmiana jest odrzucona. Zdejmij blokadę na karcie produktu, jeśli chcesz zmienić to pole.
Asystent zrobił złą zmianę albo zmianę, której nie chciałem
Napisz w rozmowie „Cofnij ostatnią zmianę” albo otwórz Historię zmian, wybierz Źródło: Asystent AI (MCP) i kliknij Cofnij. Opis w artykule Historia zmian i cofanie zmian.
Asystent uruchomił Optimizer Agent. Gdzie zaakceptować propozycje?
W panelu Snomi. Asystent podaje link do przeglądu tego uruchomienia. Otwórz go w przeglądarce, w której jesteś zalogowany do Snomi, albo przejdź do Optimizer Agent i otwórz przegląd propozycji. Snomi nie wysyła maila po zakończeniu.
Link od asystenta prosi o ponowne logowanie
Link otworzył się w przeglądarce wbudowanej w aplikację asystenta, gdzie nie jesteś zalogowany. Skopiuj go i otwórz w swojej zwykłej przeglądarce.
Asystent pisze, że brakuje kredytów
Optimizer Agent i audyt strategiczny zużywają kredyty AI Snomi z puli Twojej firmy. Zawęź zakres, poczekaj na odnowienie puli albo sprawdź stan w Zużycie AI. Opis w artykule Kredyty AI.
Asystent nie może przeliczyć jakości katalogu
Przeliczenie przez asystenta ma limit 1 na sklep dziennie (w planie Agency 2) i zużywa też limit z panelu. Poczekaj do następnego dnia albo przelicz jakość w panelu, jeśli zostało Ci tam przeliczenie.
Asystent nie może połączyć konta Google Ads
Pierwsze połączenie z Google wymaga logowania w przeglądarce. Asystent poda link do zakładki Integracje w sklepie. Połącz tam konto, a potem poproś asystenta o wybór konta reklamowego.
Asystent pisze o zbyt wielu zapytaniach
Jedno połączenie może wysłać do Snomi najwyżej 60 zapytań na minutę. Odczekaj chwilę i poproś o mniejszy zakres, na przykład jeden sklep albo jedną kategorię.
Odpowiedź asystenta jest niepełna przy dużym katalogu
Snomi zwraca asystentowi krótkie listy (zwykle do kilkudziesięciu pozycji), żeby rozmowa nie zwolniła. Zawęź pytanie filtrem, marką albo kategorią albo poproś o kolejną stronę wyników.
Asystent podaje informacje o Snomi, które się nie zgadzają
Asystent AI może się mylić. Poproś go, żeby sprawdził odpowiedź w Centrum pomocy Snomi, albo zajrzyj do panelu. Zmiany zawsze weryfikuj w podglądzie przed potwierdzeniem.
Token API przestał działać
Token wygasł (ważność ustawiasz przy tworzeniu, najwyżej 365 dni), został usunięty albo unieważniony po zmianie hasła lub Wyloguj wszędzie. Utwórz nowy token i podmień go w konfiguracji.
Częste pytania
Czy asystent może coś zmienić bez mojej zgody?
Nie. Każda zmiana i każdy koszt kredytów wymaga potwierdzenia w rozmowie, a pilnuje tego serwer Snomi, nie asystent.
Czy moje dane trafiają do Claude albo ChatGPT?
Tak, ale tylko te, o które asystent zapyta w trakcie rozmowy, na przykład lista produktów albo wynik jakości. Dalsze przetwarzanie zależy od zasad aplikacji, której używasz.
Ile kosztuje korzystanie z MCP?
Integracja jest częścią planu Snomi. Kredyty Snomi zużywają tylko Optimizer Agent i audyt strategiczny, tak jak w panelu. Rozmowę opłacasz w ramach planu aplikacji AI.
Czy kilka osób z zespołu może używać asystenta?
Tak. Każda osoba łączy asystenta ze swojego konta i pracuje ze swoimi uprawnieniami. Właściciel widzi wszystkie połączenia w Organizacji.
Czy asystent widzi dane innych firm albo innych klientów agencji?
Nie. Jedno połączenie działa w jednym koncie firmowym i tylko w sklepach, do których masz dostęp. Jeśli obsługujesz kilka kont firmowych, połącz asystenta osobno dla każdego z nich.
Jak zmienić zakres połączenia albo listę sklepów?
Usuń połączenie w Moje konto → Moje tokeny API i połączone aplikacje i połącz asystenta ponownie, wybierając nowy zakres i sklepy.
Jak całkowicie odłączyć asystenta?
Usuń połączenie w Moje konto → Moje tokeny API i połączone aplikacje. Dostęp znika natychmiast. Konektor w aplikacji asystenta możesz potem usunąć w jej ustawieniach.
Kto w firmie widzi, że korzystam z asystenta?
Właściciel i administrator z uprawnieniem do organizacji widzą listę połączeń w Organizacja → Integracje AI (MCP). Każda zmiana od asystenta jest też w Historii zmian z Twoim nazwiskiem i nazwą aplikacji.
Czy asystent może działać sam, na przykład co noc?
Asystent działa w rozmowie, a zmiany wymagają Twojego potwierdzenia. Do automatyzacji, na przykład w skryptach, użyj tokenu API z Claude Code albo innym klientem MCP, ale potwierdzenie zmian dalej jest wymagane.
Czy asystent wyśle e-mail albo powiadomienie?
Nie. Snomi nie wysyła maili o działaniach asystenta. Wyniki zobaczysz w rozmowie i w panelu.
Czy darmowy plan ChatGPT albo Claude wystarczy?
To zależy od aplikacji. Własne konektory i akcje zmieniające dane są dostępne tylko w części planów Claude i ChatGPT. Sprawdź to w ustawieniach aplikacji.