Jak podłączyć agenta AI do SyncSphere przez MCP
Serwer MCP SyncSphere to punkt dostępu, przez który asystent AI wykonuje w Twoim koncie te same operacje co Ty w panelu: wyszukuje produkty, publikuje je w sklepie, pisze opisy, importuje towar z hurtowni i przygotowuje wpisy na blog. Agent łączy się tokenem, który tworzysz w panelu, i widzi wyłącznie sklepy i uprawnienia przypisane do tego tokenu.
Które asystenty AI mogę podłączyć
Serwer działa w otwartym standardzie Model Context Protocol, więc współpracuje z każdym klientem MCP. Obsługujemy między innymi:
- Claude
- ChatGPT
- Gemini
- Microsoft Copilot
- Cursor
- Mistral Le Chat
- Viktor
Klient musi umieć połączyć się ze zdalnym serwerem MCP i wysłać nagłówek autoryzacji z tokenem. Klient, który uruchamia tylko lokalne serwery (na przykład Claude Desktop albo Claude Code), łączysz przez mostek HTTP mcp-remote, opisany niżej.
Jak utworzyć token dostępu
- Zaloguj się do panelu SyncSphere i otwórz Ustawienia > Dostęp MCP.
- Kliknij Nowe poświadczenie i nadaj mu nazwę, która powie Ci później, do czego służy.
- Zaznacz sklepy, na których agent może działać.
- Zaznacz uprawnienia. Możesz nadać tylko te, które masz sam.
- Opcjonalnie ustaw datę wygaśnięcia. Puste pole oznacza poświadczenie bez wygaśnięcia.
- Skopiuj token od razu. Panel pokazuje go tylko raz i nie da się go odzyskać.
Jeśli zgubisz token, odwołaj poświadczenie i utwórz nowe. Nazwę, sklepy i uprawnienia aktywnego poświadczenia zmienisz później bez zmiany tokenu, a zmiana obowiązuje od następnego zapytania agenta. Daty wygaśnięcia nie zmienisz po utworzeniu.
Jak skonfigurować klienta AI
Serwer przyjmuje zapytania pod adresem https://platform-api.syncsphere.pl/api/mcp. Token wysyłasz w nagłówku Authorization: Bearer, po słowie Bearer wklejasz token z panelu.
- W ustawieniach klienta AI dodaj nowy serwer MCP (w części klientów nazywa się to konektorem lub integracją).
- Wpisz adres serwera.
- Dodaj nagłówek
Authorizationz wartościąBeareri Twoim tokenem. - Dla klienta, który uruchamia tylko lokalne serwery, ustaw polecenie
npx -y mcp-remotez adresem serwera i tym samym nagłówkiem. - Poproś agenta o listę Twoich sklepów. Odpowiedź potwierdza, że połączenie i uprawnienia działają.
Odpowiedź 401 oznacza, że token jest nieznany, odwołany albo wygasł.
Jakie uprawnienia nadać agentowi
Każde wywołanie narzędzia przechodzi dwie kontrole: czy token ma wymagane uprawnienie i czy sklep, na którym agent chce działać, jest na liście sklepów tokenu. Agent nie wybiera konta: konto jest przypisane do tokenu i żadne narzędzie nie przyjmuje go jako parametru. Lista narzędzi, którą widzi agent, zawiera tylko te, na które pozwalają nadane uprawnienia, więc token tylko do odczytu nie widzi narzędzi zapisujących.
Uprawnienia, które usuwają dane, importują towar, ustawiają ceny lub marże albo zużywają kredyty TypeSafe, są w formularzu domyślnie odznaczone. Zacznij od odczytu i dodawaj zapis tam, gdzie agent ma pracować.
Co agent może zrobić przez MCP
| Obszar | Przykładowe działania |
|---|---|
| Magazyn | wyszukiwanie produktów po nazwie, SKU lub EAN, dodawanie nowych produktów do magazynu |
| Hurtownie | przeglądanie katalogu Platon lub Dressler, import wybranych pozycji do magazynu |
| Sklep | publikacja produktów, kategorie i filtry, tytuły, opisy, FAQ, zdjęcia, widoczność |
| Ceny | odczyt i ustawienie marży sklepu w macierzy cen, trwałe przypięcie ceny na kanale |
| Allegro | wystawienie oferty z ceną z macierzy cenowej |
| Blog | szkice wpisów, kategorie bloga, publikacja |
| Oceny AI | kontrola jakości opisu i weryfikacja twierdzeń przez TypeSafe |
| Zgłoszenia | wysłanie prośby o funkcję lub zgłoszenia problemu do zespołu SyncSphere |
Serwer nie obsługuje zamówień, klientów ani ustawień wysyłki. Nie zmienia też stanu magazynowego istniejących produktów; stan początkowy nowego produktu trafia do historii ruchów magazynowych jak przy ręcznym dodaniu.
Jakie zabezpieczenia chronią moje dane
- Każda zmiana wykonana przez agenta i każda odmowa uprawnień trafia do dziennika audytu.
- Nowy wpis na blogu powstaje jako szkic. Publikacja to osobne wywołanie i osobne uprawnienie.
- Cena w sklepie nie zejdzie poniżej kosztu ani poniżej ceny wynikającej z marży.
- Opis z niebezpiecznym kodem HTML zostaje odrzucony w całości.
- Oferta Allegro dostaje cenę z macierzy cenowej, nie od agenta.
- Kategorii, która ma podkategorie, nie da się usunąć.
Jak agent pisze opisy produktów i jak je sprawdzamy, opisujemy w artykule Opisy produktów pisane przez AI. Przykład pełnej pracy agenta znajdziesz we wpisie Agent AI w sprzedaży wielokanałowej.
Najczęstsze pytania
Gdzie w SyncSphere znajdę token MCP dla agenta AI?
Token tworzysz w panelu w Ustawienia > Dostęp MCP, przyciskiem Nowe poświadczenie. Panel pokazuje go tylko raz, więc skopiuj go od razu; zgubiony token odwołujesz i tworzysz nowy.
Czy mogę podłączyć ChatGPT albo Gemini, a nie tylko Claude?
Tak. Serwer działa w standardzie MCP, więc podłączysz Claude, ChatGPT, Gemini, Microsoft Copilot, Cursor, Mistral Le Chat, Viktor i każdego innego klienta, który łączy się ze zdalnym serwerem MCP z nagłówkiem autoryzacji.
Czy agent AI może usunąć produkty albo kategorie bez mojej zgody?
Nie, jeśli nie nadasz mu uprawnienia do usuwania. Uprawnienia usuwające są w formularzu domyślnie odznaczone, a każda zmiana agenta trafia do dziennika audytu.
Czy agent widzi zamówienia i dane klientów?
Nie. Serwer MCP nie obsługuje zamówień, klientów ani ustawień wysyłki.
Jak ograniczyć agenta do jednego sklepu?
Przy tworzeniu poświadczenia zaznacz tylko ten sklep. Wywołanie, które wskazuje inny sklep, zostaje odrzucone.