Shopify MCP: ptejte se na data svého obchodu v Claude a dalších AI aplikacích

Server Shopify MCP propojuje data vašeho obchodu s AI asistentem přes Model Context Protocol (MCP). Položíte otázku běžným jazykem, například „Která kampaň měla minulý měsíc nejvyšší zisk?“, a asistent odpoví ze skutečných čísel vašeho obchodu, ne z paměti. ROASaurus provozuje server MCP s 24 analytickými nástroji jen pro čtení a stejné nástroje pohánějí Ask AI uvnitř dashboardu.

Tento průvodce vysvětluje, co je MCP, proč se vyplatí klást analytické otázky tímto způsobem, jak fungují Ask AI a server MCP, jak připojit klienta, které otázky fungují dobře a co byste měli vědět o soukromí, zabezpečení a omezeních.

Co je MCP?

MCP je open-source standard pro propojení AI aplikací s externími systémy. AI aplikace, například Claude, je klient. Služba, která nabízí data nebo akce, je server. Server popisuje své nástroje: každý nástroj má název, popis a schéma svých vstupů.

Když položíte otázku, klient se serveru zeptá, jaké nástroje existují (tools/list). Model vybere nástroj, který se hodí, a klient ho zavolá (tools/call). Výsledek se vrátí modelu, který napíše odpověď. Názvy nástrojů znát nemusíte. Jen položíte otázku.

Shopify také provozuje servery MCP. Zaměřují se na nákupní agenty a vývojáře: vyhledávání produktů, košíky, pokladnu, zákaznické účty a vývojářskou dokumentaci. Analytický server MCP odpovídá na jiný druh otázek: zisk po reklamách, atribuci a hodnotu zákazníků, vypočítané z vašich objednávek, vašich nákladů a útraty ve vašich reklamních účtech.

Proč se ptát na data obchodu v AI asistentovi?

Většina otázek o obchodu potřebuje čísla z několika reportů. „Vydělalo Meta minulý měsíc?“ potřebuje na jednom místě tržby, náklady na produkty, dopravu, poplatky a útratu za reklamu. V dashboardu otevřete správný report, nastavíte data a spočítáte to. V AI asistentovi připojeném k vašim datům položíte otázku a dostanete odpověď s čísly, která za ní stojí.

• Běžný jazyk. Žádné filtry, nástroje na tvorbu reportů ani vzorce v tabulkách.
• Doplňující otázky. Zeptejte se „a pro TikTok?“ nebo „která kampaň to způsobila?“, aniž byste začínali znovu.
• Několik reportů v jedné odpovědi. Zisk, atribuci a hodnotu zákazníků lze spojit v jedné odpovědi.
• Váš vlastní jazyk. Ask AI odpovídá v jazyce, ve kterém píšete.
• Vedle vaší další práce. Přes MCP jsou čísla obchodu dostupná v AI aplikaci, ve které už píšete průběžné zprávy nebo plány.

Odpověď je jen tak úplná, jak úplná jsou data za ní. Nejdřív připojte server-side tracking, své reklamní účty a náklady na produkty, aby nástroje měly s čím pracovat: objednávky, útratu a marže.

Jak fungují Ask AI a server ROASaurus MCP?

Ask AI je chatovací stránka v dashboardu ROASaurus. Běží na Claude, modelu od Anthropic. Server MCP nabízí stejných 24 nástrojů AI klientovi, kterého si zvolíte. V obou případech nástroje čtou vaše reporty ROASaurus a vracejí čísla jako JSON. Model z těchto výsledků napíše odpověď.

Každý analytický nástroj jen čte. Žádný nástroj nemůže změnit váš obchod, kampaně, náklady ani nastavení. Server MCP každý z nich označuje jako určený jen pro čtení a klientovi sděluje, aby odpovídal pouze z výsledků nástrojů. Klíč s oprávněním actions:write dostane také propose_action, který přidá navrženou změnu reklamy do schránky Actions; nic se nezmění, dokud ji vlastník nebo správce neschválí. Má ho i Ask AI v dashboardu.

V Ask AI může jedna otázka využít až 8 kol volání nástrojů. Pokud otázka potřebuje víc, asistent vás požádá, abyste byli konkrétnější. Ask AI uchovává vaši konverzaci podle uživatele a obchodu a jako kontext pro doplňující otázku používá posledních 12 zpráv. Konverzaci můžete kdykoli smazat.

Na co se můžete ptát?

Dobré otázky uvádějí metriku a jedno z podporovaných období. Tabulka ukazuje příklady otázek, nástroj, který na každou odpovídá, a na čem je odpověď založena.

Tady je propočítaný příklad. Zeptáte se: „Vydělalo Meta za posledních 30 dní?“ Model zavolá campaign_profit s obdobím nastaveným na 30 dní a výchozím modelem posledního kliknutí. U ukázkového e-shopu vypadá řádek Meta ve výsledku takto:

V Ask AI odpověď začíná „Ano“, pak uvede zisk po reklamách a POAS a navrhne nejvýše tři další kroky. Pokud chcete jiný pohled, zeptejte se doplňující otázkou, například „a s modelem Total Impact?“. Tato čísla podrobněji vysvětlují naše průvodci POAS a atribučními modely.

Jak připojit server ROASaurus MCP?

Server používá transport Streamable HTTP protokolu MCP a vrací odpovědi JSON, bez server-sent events. AI aplikace jako Claude a ChatGPT se přihlašují přes OAuth: přihlásíte se do ROASaurus, zvolíte obchod a povolíte připojení. Klienti, ve kterých lze nastavit hlavičku požadavku, například Claude Code, mohou místo toho použít API klíč podle kroků níže.

1. Vytvořte klíč API

   Otevřete v ROASaurus Store settings › API & data a vytvořte pojmenovaný klíč s oprávněním mcp. Zkopírujte ho: zobrazí se jen jednou. Klíče mohou vytvářet jen vlastníci a správci.

2. Nebo znovu použijte klíč Orders API

   Můžete použít i klíč na kartě Orders API, například ten, který používá plugin WooCommerce. Tento klíč může také odesílat objednávky. Regenerate API key ho nahradí a odpojí vše, co používá starý.

3. Poznamenejte si klíč obchodu

   Pojmenovaný klíč se do hlavičky vkládá samostatně. S klíčem Orders API přidejte klíč obchodu: hodnotu X-Roasaurus-Key na stejné kartě, jejíž sekce MCP ukazuje celou hlavičku.

4. Přidejte server do svého klienta MCP

   Zadejte endpoint a hlavičku Authorization uvedené níže. Klient musí podporovat Streamable HTTP a vlastní hlavičky požadavků.

5. Položte zkušební otázku

   Zeptejte se „Jaké byly moje tržby včera?“ a porovnejte číslo se svým 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>"

Klíč obchodu můžete poslat i v hlavičce X-Roasaurus-Key a jako bearer token jen klíč API. V Claude Code ponechte výchozí lokální rozsah. Server s rozsahem projektu se ukládá do souboru .mcp.json, který se sdílí přes správu verzí, a tím byste sdíleli svůj klíč.

Chcete-li se místo toho přihlásit, přidejte https://app.roasaurus.com/mcp jako vlastní konektor v Claude nebo ChatGPT a přihlaste se, když o to aplikace požádá. Povolit připojení mohou jen vlastníci a administrátoři. Store settings › API & data zobrazuje každou připojenou aplikaci, kterou tam můžete odpojit, a připojení skončí také, když tato osoba opustí pracovní prostor.

Je to bezpečné? Soukromí a zabezpečení

Protože analytické nástroje jen čtou, AI aplikace nemůže přes ROASaurus pozastavit kampaň, upravit náklad ani změnit nastavení; s actions:write může jen navrhnout změnu reklamy ke schválení vlastníkem nebo správcem. Nástroje také přijímají jen pevné vstupy, například období nebo atribuční model ze seznamu. Několik bodů ale vyžaduje pozornost.

• Kam data jdou. Ask AI posílá vaši otázku a agregované metriky obchodu společnosti Anthropic, která provozuje Claude. Neposílá žádné kontaktní údaje vašich zákazníků. Přes MCP jdou výsledky nástrojů AI klientovi, kterého připojíte, podle jeho podmínek. Zkontrolujte jeho nastavení uchovávání dat a trénování.
• Co nástroje vracejí. Součty podle období, kanálu, kampaně, reklamy, produktu, kohorty a segmentu. Nevracejí žádná jména zákazníků, e-mailové adresy ani telefonní čísla.
• Kdo se může ptát. Kdokoli, kdo má přístup k AI aplikaci, ve které připojení přidáte, se může na obchod dotazovat. Přidejte ho do svého vlastního účtu, ne do sdíleného.
• Další konektory. Specifikace MCP říká, že by vždy měl být zapojen člověk, který může volání nástrojů zamítnout, a že klienti musí brát anotace nástrojů jako nedůvěryhodné, pokud server není důvěryhodný. Pokud má vaše AI aplikace také nástroje, které odesílají e-maily nebo zveřejňují zprávy, nechte u těchto nástrojů zapnutá potvrzovací upozornění.

Jaká jsou omezení?

• Pevná období. Dnes, včera nebo posledních 7, 14, 30 či 90 dní, v časovém pásmu obchodu. Vlastní rozsah, například jeden týden v březnu, není podporován. Nástroje pro hodnotu zákazníků a kohorty období nepřijímají: pracují z vaší historie objednávek, s až 12 měsíčními kohortami.
• 7denní okno pro tabulku reklam. Nástroj pro reklamy používá 7denní atribuční okno, ať v Store settings nastavíte jakékoli. Nástroje pro atribuci a zisk kampaní, stejně jako reporty atribuce v dashboardu, používají vaše vlastní nastavení nebo atribuční okno, o které požádáte.
• Zkrácené seznamy. Seznamy kampaní vracejí nejvýše 25 kampaní, tabulka reklam 30 řádků s nejvyšší útratou a seznam produktů 25 nejlepších produktů.
• Jeden obchod na připojení. Pro více obchodů vytvořte pro každý klíč a připojení.
• Limit otázek Ask AI. Každý uživatel může ve výchozím nastavení klást 40 otázek denně, počítáno za posledních 24 hodin. Přes MCP platí místo toho vlastní limity využití vašeho AI klienta.
• Odpovědi mohou být chybné. Model může výsledek špatně pochopit. Důležitá čísla zkontrolujte v reportech, než podle nich budete jednat, například v analýze zisku.

Zdroje

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

V ROASaurus

• Ask AI a MCP
• Analýza zisku
• Kalkulačka POAS

Čtěte dál