Shopify MCP: pytaj o dane swojego sklepu w Claude i innych aplikacjach AI

Serwer MCP dla Shopify łączy dane twojego sklepu z asystentem AI przez Model Context Protocol (MCP). Zadajesz pytanie zwykłym językiem, na przykład „Która kampania przyniosła najwięcej zysku w zeszłym miesiącu?”, a asystent odpowiada na podstawie rzeczywistych liczb twojego sklepu, a nie z pamięci. ROASaurus prowadzi serwer MCP z 24 narzędziami analitycznymi tylko do odczytu, a te same narzędzia zasilają Ask AI w dashboardzie.

Ten poradnik wyjaśnia, czym jest MCP, dlaczego warto zadawać pytania analityczne w ten sposób, jak działają Ask AI i serwer MCP, jak podłączyć klienta i które pytania sprawdzają się dobrze, a także co warto wiedzieć o prywatności, bezpieczeństwie i ograniczeniach.

Czym jest MCP?

MCP to otwarty standard (open source) do łączenia aplikacji AI z zewnętrznymi systemami. Aplikacja AI, taka jak Claude, jest klientem. Usługa, która oferuje dane lub akcje, jest serwerem. Serwer opisuje swoje narzędzia: każde narzędzie ma nazwę, opis i schemat danych wejściowych.

Gdy zadajesz pytanie, klient pyta serwer, jakie narzędzia istnieją (tools/list). Model wybiera pasujące narzędzie, a klient je wywołuje (tools/call). Wynik wraca do modelu, który pisze odpowiedź. Nie musisz znać nazw narzędzi. Po prostu zadajesz pytanie.

Shopify również prowadzi serwery MCP. Skupiają się one na agentach zakupowych i programistach: wyszukiwaniu produktów, koszykach, checkoucie, kontach klientów i dokumentacji dla programistów. Analityczny serwer MCP odpowiada na inny rodzaj pytań: zysk po reklamach, atrybucję i wartość klienta, obliczane z twoich zamówień, kosztów i wydatków na kontach reklamowych.

Po co pytać o dane sklepu w asystencie AI?

Większość pytań o sklep wymaga liczb z kilku raportów. „Czy Meta przyniosła zysk w zeszłym miesiącu?” wymaga przychodu, kosztów produktów, wysyłki, opłat i wydatków na reklamy w jednym miejscu. W dashboardzie otwierasz właściwy raport, ustawiasz daty i sam liczysz. W asystencie AI połączonym z twoimi danymi zadajesz pytanie i dostajesz odpowiedź wraz z liczbami, które za nią stoją.

• Zwykły język. Bez filtrów, kreatorów raportów i formuł arkusza.
• Pytania uzupełniające. Zapytaj „a dla TikToka?” albo „która kampania to spowodowała?” bez zaczynania od nowa.
• Kilka raportów w jednej odpowiedzi. Zysk, atrybucja i wartość klienta mogą być połączone w jednej odpowiedzi.
• Twój własny język. Ask AI odpowiada w języku, w którym piszesz.
• Obok innej pracy. Dzięki MCP liczby ze sklepu są dostępne w aplikacji AI, w której już piszesz aktualizacje lub plany.

Odpowiedź jest tak kompletna, jak dane, na których się opiera. Najpierw podłącz server-side tracking, swoje konta reklamowe i koszty produktów, żeby narzędzia miały zamówienia, wydatki i marże, na których mogą pracować.

Jak działają Ask AI i serwer MCP ROASaurus?

Ask AI to strona czatu w dashboardzie ROASaurus. Działa na Claude, modelu Anthropic. Serwer MCP oferuje te same 24 narzędzia klientowi AI, którego wybierzesz. W obu przypadkach narzędzia odczytują twoje raporty ROASaurus i zwracają liczby jako JSON. Model pisze odpowiedź na podstawie tych wyników.

Każde narzędzie analityczne tylko odczytuje. Żadne narzędzie nie może zmienić twojego sklepu, kampanii, kosztów ani ustawień. Serwer MCP oznacza każde z nich jako tylko do odczytu i każe klientowi odpowiadać wyłącznie na podstawie wyników narzędzi. Klucz z zakresem actions:write dostaje też propose_action, które dodaje proponowaną zmianę w reklamie do skrzynki Actions; nic się nie zmienia, dopóki właściciel lub administrator jej nie zatwierdzi. Ask AI w dashboardzie też ma to narzędzie.

W Ask AI jedno pytanie może wykorzystać do 8 rund wywołań narzędzi. Jeśli pytanie wymaga więcej, asystent prosi cię o większą szczegółowość. Ask AI przechowuje twoją rozmowę dla każdego użytkownika i sklepu oraz używa ostatnich 12 wiadomości jako kontekstu dla pytania uzupełniającego. Możesz w każdej chwili wyczyścić rozmowę.

Jakie pytania możesz zadawać?

Dobre pytania wskazują metrykę i jeden z obsługiwanych okresów. Tabela pokazuje przykładowe pytania, narzędzie, które odpowiada na każde z nich, oraz to, na czym opiera się odpowiedź.

Oto przykład krok po kroku. Pytasz: „Czy Meta zarobiła w ostatnich 30 dniach?” Model wywołuje campaign_profit z okresem ustawionym na 30 dni i domyślnym modelem last click. Dla przykładowego sklepu wiersz Meta w wyniku wygląda tak:

W Ask AI odpowiedź zaczyna się od „Tak”, potem podaje zysk po reklamach i POAS oraz sugeruje najwyżej trzy kolejne kroki. Jeśli chcesz zobaczyć to inaczej, zadaj pytanie uzupełniające, na przykład „a w modelu Total Impact?”. Nasze poradniki o POAS i modelach atrybucji wyjaśniają te liczby dokładniej.

Jak podłączyć serwer MCP ROASaurus?

Serwer korzysta z transportu Streamable HTTP protokołu MCP i zwraca odpowiedzi JSON, bez server-sent events. Aplikacje AI, takie jak Claude i ChatGPT, logują się przez OAuth: logujesz się do ROASaurus, wybierasz sklep i zezwalasz na połączenie. Klienci, w których możesz ustawić nagłówek żądania, tacy jak Claude Code, mogą zamiast tego użyć klucza API, jak w krokach poniżej.

1. Utwórz klucz API

   Otwórz Store settings › API & data w ROASaurus i utwórz nazwany klucz z zakresem mcp. Skopiuj go: jest pokazywany tylko raz. Tylko właściciele i administratorzy mogą tworzyć klucze.

2. Albo użyj ponownie klucza Orders API

   Możesz też użyć klucza z karty Orders API, na przykład tego, którego używa wtyczka WooCommerce. Ten klucz może też wysyłać zamówienia. Regenerate API key zastępuje go i odłącza wszystko, co używa starego.

3. Zanotuj klucz sklepu

   Nazwany klucz trafia do nagłówka samodzielnie. Przy kluczu Orders API dodaj klucz sklepu: wartość X-Roasaurus-Key z tej samej karty, której sekcja MCP pokazuje pełny nagłówek.

4. Dodaj serwer do swojego klienta MCP

   Wpisz endpoint i nagłówek Authorization pokazane poniżej. Klient musi obsługiwać Streamable HTTP i niestandardowe nagłówki żądań.

5. Zadaj pytanie testowe

   Zapytaj „Jaki był mój przychód wczoraj?” i porównaj liczbę z dashboardem.

# Endpoint
POST https://app.roasaurus.com/mcp
Authorization: Bearer <named key with the mcp scope>
# or, with the Orders API key
Authorization: Bearer <store key>:<API key>

# Claude Code
claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \
  --header "Authorization: Bearer <named key with the mcp scope>"

Możesz też wysłać klucz sklepu w nagłówku X-Roasaurus-Key, a jako token bearer tylko klucz API. W Claude Code zostaw domyślny zakres lokalny. Serwer o zakresie projektu jest zapisywany w pliku .mcp.json, który jest współdzielony przez system kontroli wersji, a to ujawniłoby twój klucz.

Aby zalogować się zamiast tego, dodaj https://app.roasaurus.com/mcp jako niestandardowy konektor w Claude lub ChatGPT i zaloguj się, gdy aplikacja o to poprosi. Tylko właściciele i administratorzy mogą zezwolić na połączenie. Store settings › API & data pokazuje każdą połączoną aplikację, którą możesz tam odłączyć, a połączenie wygasa też, gdy ta osoba opuści obszar roboczy.

Czy to bezpieczne? Prywatność i bezpieczeństwo

Ponieważ narzędzia analityczne tylko odczytują, aplikacja AI nie może przez ROASaurus wstrzymać kampanii, edytować kosztu ani zmienić ustawienia; z actions:write może jedynie zaproponować zmianę w reklamie do zatwierdzenia przez właściciela lub administratora. Narzędzia przyjmują też tylko stałe dane wejściowe, takie jak okres lub model atrybucji z listy. Mimo to kilka kwestii wymaga ostrożności.

• Dokąd trafiają dane. Ask AI wysyła twoje pytanie i zagregowane metryki sklepu do firmy Anthropic, która prowadzi Claude. Nie wysyła danych kontaktowych twoich klientów. Przez MCP wyniki narzędzi trafiają do klienta AI, którego podłączysz, na warunkach tego klienta. Sprawdź jego ustawienia przechowywania danych i trenowania.
• Co zwracają narzędzia. Sumy według okresu, kanału, kampanii, reklamy, produktu, kohorty i segmentu. Nie zwracają imion i nazwisk klientów, adresów e-mail ani numerów telefonów.
• Kto może pytać. Każdy, kto ma dostęp do aplikacji AI, w której dodajesz połączenie, może odpytywać sklep. Dodaj je do własnego konta, a nie do wspólnego.
• Inne konektory. Specyfikacja MCP mówi, że zawsze powinien być człowiek w pętli, który może odrzucać wywołania narzędzi, oraz że klienci muszą traktować adnotacje narzędzi jako niezaufane, chyba że serwer jest zaufany. Jeśli twoja aplikacja AI ma też narzędzia, które wysyłają e-maile lub publikują wiadomości, zostaw dla nich włączone monity o potwierdzenie.

Jakie są ograniczenia?

• Stałe okresy. Dziś, wczoraj albo ostatnie 7, 14, 30 lub 90 dni, w strefie czasowej sklepu. Zakres niestandardowy, na przykład jeden tydzień w marcu, nie jest obsługiwany. Narzędzia wartości klienta i kohort nie przyjmują okresu: pracują na historii twoich zamówień, z maksymalnie 12 kohortami miesięcznymi.
• 7-dniowe okno dla tabeli reklam. Narzędzie reklam używa 7-dniowego okna atrybucji, niezależnie od okna ustawionego w Store settings. Narzędzia atrybucji i zysku kampanii, tak jak raporty atrybucji w dashboardzie, używają twojego ustawienia albo okna, o które poprosisz.
• Skrócone listy. Listy kampanii zwracają najwyżej 25 kampanii, tabela reklam 30 wierszy z największymi wydatkami, a lista produktów 25 najlepszych produktów.
• Jeden sklep na połączenie. Dla kilku sklepów utwórz klucz i połączenie dla każdego z nich.
• Limit pytań w Ask AI. Każdy użytkownik może domyślnie zadać 40 pytań dziennie, liczonych w ciągu ostatnich 24 godzin. Przez MCP obowiązują zamiast tego własne limity użycia twojego klienta AI.
• Odpowiedzi mogą być błędne. Model może źle odczytać wynik. Sprawdzaj ważne liczby w raportach, zanim na ich podstawie zadziałasz, na przykład w analityce zysku.

Źródła

1. Model Context Protocol: What is the Model Context Protocol (MCP)?
2. Model Context Protocol specification (2025-06-18): Tools
3. Claude Code Docs: Connect Claude Code to tools via MCP
4. Claude Docs: Authentication for connectors
5. OpenAI: Building MCP servers for plugins and API integrations

W ROASaurus

• Ask AI i MCP
• Analityka zysku
• Kalkulator POAS

Czytaj dalej