Какво е Shopify MCP сървър?

Това е сървър, който използва Model Context Protocol, за да дава на AI приложения инструменти за магазин в Shopify. MCP сървърът на ROASaurus дава на AI клиент инструменти само за четене за печалбата, атрибуцията, рекламите, стойността на клиента, наличностите, целите, еталоните и известията на един магазин.

Може ли AI да променя моите кампании или моя магазин?

Не самостоятелно. Аналитичните инструменти в Ask AI и в MCP сървъра само четат. Ask AI и MCP клиент, чийто ключ има обхвата actions:write, могат да предложат промяна в кампания във входящата кутия Actions, и нищо не се променя, докато собственик или администратор не я одобри. Никой от двата не може да редактира вашия магазин, разходи или настройки.

Кои AI приложения могат да се свържат с MCP сървъра на ROASaurus?

Claude, ChatGPT и други MCP клиенти, които поддържат OAuth, влизат с вашия ROASaurus акаунт. Клиентите, в които можете да зададете хедър Authorization, като Claude Code, могат вместо това да използват API ключ.

Изпращат ли се данни за клиенти към AI?

Инструментите връщат агрегирани метрики, а не данни за контакт на клиенти. Ask AI изпраща въпроса ви и тези метрики към Anthropic; през MCP резултатите отиват към AI клиента, който свързвате.

Защо не мога да питам за персонализиран период?

Инструментите приемат само фиксирани периоди: днес, вчера или последните 7, 14, 30 или 90 дни по часовата зона на магазина. Въпросите за стойност на клиента и кохорти не приемат период и използват историята на поръчките ви.

Броят ли се въпросите през MCP към лимита от 40 въпроса?

Не. Дневният лимит важи за Ask AI в таблото. През MCP важат лимитите за използване на вашия собствен AI клиент.

Shopify MCP: задавайте въпроси за данните на магазина си в Claude и други AI приложения

Основни изводи

MCP (Model Context Protocol) е отворен стандарт, който позволява на AI приложения да извикват инструменти на други услуги, така че асистентът да може да отговаря по реалните данни на вашия магазин.
Ask AI и MCP сървърът на ROASaurus споделят 24 инструмента само за четене – от печалба, атрибуция и стойност на клиента до разходи, лийдове, абонаменти, модела на маркетинговия микс и аномалии.
AI приложение се свързва, като влиза в ROASaurus чрез OAuth, или с API ключ в хедър Authorization.
Именуван ключ само с обхвата mcp може само да чете; ключът за Orders API може да изпраща и поръчки, затова пазете всеки ключ в тайна и го отменете, ако изтече.
Периодите са фиксирани (днес, вчера или последните 7, 14, 30 или 90 дни), а Ask AI позволява по подразбиране 40 въпроса на потребител на ден.

Shopify MCP сървър свързва данните на магазина ви с AI асистент чрез Model Context Protocol (MCP). Задавате въпрос на разговорен език, като „Коя кампания донесе най-много печалба миналия месец?“, и асистентът отговаря по реалните числа на магазина ви, а не по памет. ROASaurus поддържа MCP сървър с 24 аналитични инструмента само за четене, а същите инструменти захранват и Ask AI в таблото.

Това ръководство обяснява какво е MCP, защо е полезно да задавате аналитични въпроси по този начин, как работят Ask AI и MCP сървърът, как да свържете клиент, кои въпроси работят добре и каква поверителност, сигурност и ограничения трябва да знаете.

Какво е MCP?

MCP е стандарт с отворен код за свързване на AI приложения с външни системи. AI приложение като Claude е клиентът. Услуга, която предлага данни или действия, е сървърът. Сървърът описва своите инструменти: всеки инструмент има име, описание и схема за входните си данни.

Когато зададете въпрос, клиентът пита сървъра кои инструменти съществуват (tools/list). Моделът избира подходящия инструмент и клиентът го извиква (tools/call). Резултатът се връща към модела, който пише отговора. Не е нужно да знаете имената на инструментите. Само задавате въпроса.

Shopify също управлява MCP сървъри. Те са насочени към агенти за пазаруване и разработчици: търсене на продукти, колички, плащане, клиентски акаунти и документация за разработчици. Аналитичният MCP сървър отговаря на друг вид въпроси: печалба след реклами, атрибуция и стойност на клиента, изчислени от вашите поръчки, вашите разходи и разходите във вашите рекламни акаунти.

Защо да питате данните на магазина си в AI асистент?

Повечето въпроси за магазина изискват числа от няколко отчета. „Спечели ли Meta пари миналия месец?“ изисква приходи, разходи за продукти, доставка, такси и разходи за реклама на едно място. В таблото отваряте правилния отчет, задавате датите и правите изчисленията. В AI асистент, свързан с данните ви, задавате въпроса и получавате отговора с числата зад него.

Разговорен език. Без филтри, конструктори на отчети или формули за електронни таблици.
Допълнителни въпроси. Попитайте „а за TikTok?“ или „коя кампания причини това?“, без да започвате отначало.
Няколко отчета в един отговор. Печалба, атрибуция и стойност на клиента могат да се комбинират в един отговор.
Вашият собствен език. Ask AI отговаря на езика, на който пишете.
До другата ви работа. През MCP числата на магазина са налични в AI приложението, където вече пишете доклади или планове.

Отговорът е толкова пълен, колкото са пълни данните зад него. Първо свържете проследяването от страна на сървъра, рекламните си акаунти и разходите за продукти, така че инструментите да имат поръчки, разходи и маржове, с които да работят.

Как работят Ask AI и MCP сървърът на ROASaurus?

Ask AI е чат страница в таблото на ROASaurus. Работи с Claude, модела на Anthropic. MCP сървърът предлага същите 24 инструмента на AI клиент по ваш избор. И в двата случая инструментите четат отчетите ви в ROASaurus и връщат числата като JSON. Моделът пише отговора от тези резултати.

Задавате въпросВ Ask AI или в собствения ви MCP клиент

Моделът избира инструментНапример campaign_profit за последните 30 дни

ROASaurus изпълнява инструментаСамо за четене, върху данните на един магазин

Моделът пише отговораСамо от върнатите числа

Моделът никога не чете директно вашата база данни. Вижда само това, което връща инструментът.

Всеки аналитичен инструмент само чете. Никой инструмент не може да променя вашия магазин, кампании, разходи или настройки. MCP сървърът маркира всеки от тях като само за четене и казва на клиента да отговаря само от резултатите на инструментите. Ключ с обхвата actions:write получава и propose_action, който добавя предложена промяна в рекламите във входящата кутия Actions; нищо не се променя, докато собственик или администратор не я одобри. Ask AI в таблото също го има.

В Ask AI един въпрос може да използва до 8 рунда извиквания на инструменти. Ако въпросът изисква повече, асистентът ви моли да бъдете по-конкретни. Ask AI пази разговора ви за всеки потребител и магазин и използва последните 12 съобщения като контекст за допълнителен въпрос. Можете да изчистите разговора по всяко време.

24инструмента само за четене, едни и същи в Ask AI и MCP

6фиксирани периода: днес, вчера, 7, 14, 30 и 90 дни

40въпроса към Ask AI на потребител на ден, по подразбиране

1магазин на API ключ и на връзка

Какви въпроси можете да задавате?

Добрите въпроси назовават метрика и един от поддържаните периоди. Таблицата показва примерни въпроси, инструмента, който отговаря на всеки от тях, и на какво се основава отговорът.

Въпрос	Инструмент	Какво показва отговорът
Как се сравняват последните 7 дни с предходните 7 дни?	`profit_summary`	Приходи, поръчки, разходи за реклама, MER, POAS и печалба, спрямо предходния период със същата дължина
Коя кампания е имала най-добър POAS през последните 30 дни?	`campaign_profit`	По кампании: приписани приходи, брутна печалба, разходи за реклама, печалба след реклами, ROAS, POAS и CAC
Кои реклами имат висок CPM и малко покупки?	`ads_table`	Разходи, импресии, кликвания, CTR и CPM до проследените покупки, ROAS и CPA
За колко месеца една кохорта изплаща своя CAC?	`ltv_insights`	Месечни кохорти, месец на изплащане на CAC и прогнозна LTV
Кои продукти връщат най-много повторни клиенти?	`products`	Топ продукти и делът на купувачите с първа покупка, които са поръчали отново
На път ли сме с целта за приходи за този месец?	`goals_forecast`	Цели, досегашни резултати и прогноза за края на месеца
Какво да поръчам отново тази седмица?	`inventory`	Налично количество, скорост на продажбите, оставащи дни запас и статус на повторна поръчка

Моделът избира инструмента. Вие само задавате въпроса.

Ето разработен пример. Питате: „Спечели ли Meta пари през последните 30 дни?“ Моделът извиква campaign_profit с период 30 дни и модела по подразбиране последен клик. За един примерен магазин редът за Meta от резултата изглежда така:

Ред	Meta, последните 30 дни	Как се изчислява
Приписани приходи	$24,000	Приходи от поръчките, приписани на кликванията от Meta
Брутна печалба (contribution в резултата)	$13,440	Приходи минус себестойност на продуктите, доставка, такси за плащане и обработка (56%)
Разходи за реклама	$8,000	Синхронизирано от рекламния акаунт в Meta
Печалба след реклами	$5,440	$13,440 − $8,000
ROAS	3.00	$24,000 ÷ $8,000
POAS	1.68	$13,440 ÷ $8,000

Примерен магазин. POAS над 1.0 означава, че рекламите са върнали повече брутна печалба, отколкото са стрували.

В Ask AI отговорът започва с „Да“, после дава печалбата след реклами и POAS и предлага най-много три следващи стъпки. Ако искате друг поглед, задайте допълнителен въпрос като „а с модела Total Impact?“. Нашите ръководства за POAS и моделите за атрибуция обясняват тези числа по-подробно.

Как да свържете MCP сървъра на ROASaurus?

Сървърът използва транспорта Streamable HTTP на MCP и връща JSON отговори, без server-sent events. AI приложения като Claude и ChatGPT влизат чрез OAuth: влизате в ROASaurus, избирате магазин и разрешавате връзката. Клиентите, в които можете да зададете хедър на заявката, като Claude Code, могат вместо това да използват API ключ, както в стъпките по-долу.

Създайте API ключ
Отворете Store settings › API & data в ROASaurus и създайте именуван ключ с обхвата mcp. Копирайте го: показва се само веднъж. Само собствениците и администраторите могат да създават ключове.
Или използвайте отново ключа за Orders API
Можете да използвате и ключа в картата Orders API, например този, който използва плъгинът за WooCommerce. С този ключ могат да се изпращат и поръчки. Regenerate API key го заменя и прекъсва връзката на всичко, което използва стария.
Запишете ключа на магазина
Именуваният ключ се поставя самостоятелно в хедъра. С ключа за Orders API добавете и ключа на магазина: стойността X-Roasaurus-Key в същата карта, чиято MCP секция показва пълния хедър.
Добавете сървъра към вашия MCP клиент
Въведете endpoint и заглавката Authorization, показани по-долу. Клиентът трябва да поддържа Streamable HTTP и персонализирани заглавки на заявките.
Задайте тестов въпрос
Попитайте „Какви бяха приходите ми вчера?“ и сравнете числото с таблото си.

Endpoint и пример за Claude Code

# 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>"

Можете да изпратите ключа на магазина и в заглавка X-Roasaurus-Key, а като bearer токен да използвате само API ключа. В Claude Code оставете локалния обхват по подразбиране. Сървър с обхват на проекта се записва във файл .mcp.json, който се споделя чрез система за контрол на версиите, и това би споделило ключа ви.

За да влезете вместо това, добавете https://app.roasaurus.com/mcp като персонализиран конектор в Claude или ChatGPT и влезте, когато приложението поиска. Само собственици и администратори могат да разрешат връзка. Store settings › API & data показва всяко свързано приложение, където можете да прекъснете връзката, а връзката спира и когато този човек напусне работното пространство.

initialize · 2025-06-18Клиентът и сървърът се уговарят за версията на протокола

tools/list · 24 tools · readOnlyHint: trueКлиентът научава кои инструменти съществуват

tools/call · campaign_profit · period 30Моделът иска печалбата по кампании за 30 дни

result · isError: falseJSON с един ред за всеки канал и кампания

401 · Invalid store key or API key.Какво връща грешен или генериран наново ключ

Как изглежда един въпрос между клиента и MCP сървъра на ROASaurus.

Безопасно ли е? Поверителност и сигурност

Тъй като аналитичните инструменти само четат, AI приложение не може да спре кампания, да редактира разход или да промени настройка през ROASaurus; с actions:write то може само да предложи промяна в рекламите, която собственик или администратор да одобри. Инструментите приемат и само фиксирани входни данни, като период или модел за атрибуция от списък. Въпреки това няколко неща изискват внимание.

Къде отиват данните. Ask AI изпраща въпроса ви и агрегирани метрики на магазина към Anthropic, компанията, която управлява Claude. Не изпраща данни за контакт на вашите клиенти. През MCP резултатите от инструментите отиват към AI клиента, който свързвате, при условията на този клиент. Проверете настройките му за съхранение на данни и обучение.
Какво връщат инструментите. Общи суми по период, канал, кампания, реклама, продукт, кохорта и сегмент. Те не връщат имена на клиенти, имейл адреси или телефонни номера.
Кой може да пита. Всеки, който има достъп до AI приложението, където добавяте връзката, може да заявява данните на магазина. Добавете я към собствения си акаунт, а не към споделен.
Други конектори. Спецификацията на MCP казва, че винаги трябва да има човек в процеса, който може да отхвърля извикванията на инструменти, и че клиентите трябва да третират анотациите на инструментите като ненадеждни, освен ако сървърът не е доверен. Ако вашето AI приложение има и инструменти, които изпращат имейл или публикуват съобщения, оставете включени подканите за потвърждение за тези инструменти.

Какви са ограниченията?

Фиксирани периоди. Днес, вчера или последните 7, 14, 30 или 90 дни, по часовата зона на магазина. Персонализиран диапазон, например една седмица през март, не се поддържа. Инструментите за стойност на клиента и кохорти не приемат период: те работят от историята на поръчките ви, с до 12 месечни кохорти.
7-дневен прозорец за таблицата с реклами. Инструментът за реклами използва 7-дневен прозорец за атрибуция, независимо какъв прозорец сте задали в Store settings. Инструментите за атрибуция и за печалба по кампании, както и отчетите за атрибуция в таблото, използват вашата настройка или прозорец, който поискате.
Съкратени списъци. Списъците с кампании връщат най-много 25 кампании, таблицата с реклами връща 30-те реда с най-големи разходи, а списъкът с продукти връща топ 25 продукта.
Един магазин на връзка. За няколко магазина създайте ключ и връзка за всеки.
Лимитът на въпросите в Ask AI. Всеки потребител може да задава по подразбиране 40 въпроса на ден, броени за последните 24 часа. През MCP важат собствените лимити за използване на вашия AI клиент.
Отговорите могат да са грешни. Моделът може да изтълкува погрешно резултат. Проверявайте важните числа в отчетите, преди да действате по тях, например в анализа на печалбата.

Източници

В ROASaurus

Продължете да четете

Креативи, имейл и AIУмора на креативите във Facebook реклами: кога да смените рекламаУмората на креативите във Facebook реклами се проявява като растяща честота на показване и спадащ CTR. Научете как да я измервате за всяка реклама, как да четете hook rate и hold rate и как да планирате редовно обновяване.Креативи, имейл и AIПотоци за изоставени колички в Klaviyo: разпознавайте повече купувачиПотоците за изоставени колички и за разглеждане в Klaviyo достигат само до купувачи, които Klaviyo може да идентифицира. Научете как ги идентифицира и как да разпознавате повече от тях на страницата за плащане.ПроследяванеБлокери на реклами и проследяване: какво губи вашият магазинБлокерите на реклами спират пикселите за проследяване, затова рекламните платформи пропускат покупки. Вижте кои събития се губят, защо събитията от страна на сървъра не се губят и как да измерите своята разлика.