Что такое MCP-сервер Shopify?

Это сервер, который использует Model Context Protocol, чтобы давать ИИ-приложениям инструменты для магазина Shopify. MCP-сервер ROASaurus даёт ИИ-клиенту инструменты только для чтения по прибыли, атрибуции, рекламе, ценности клиентов, складским остаткам, целям, бенчмаркам и оповещениям одного магазина.

Может ли ИИ изменить мои кампании или мой магазин?

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

Какие ИИ-приложения можно подключить к MCP-серверу ROASaurus?

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

Передаются ли данные клиентов в AI?

Инструменты возвращают агрегированные метрики, а не контактные данные клиентов. Ask AI отправляет ваш вопрос и эти метрики в Anthropic; через MCP результаты уходят в ИИ-клиент, который вы подключаете.

Почему нельзя спросить про произвольный диапазон дат?

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

Входят ли вопросы через MCP в лимит 40 вопросов?

Нет. Дневной лимит относится к Ask AI в дашборде. Через MCP действуют лимиты использования вашего собственного ИИ-клиента.

Shopify MCP: задавайте вопросы о данных магазина в Claude и других ИИ-приложениях

Главное

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

MCP-сервер Shopify подключает данные вашего магазина к ИИ-ассистенту через Model Context Protocol (MCP). Вы задаёте вопрос простым языком, например «Какая кампания принесла больше всего прибыли в прошлом месяце?», а ассистент отвечает по реальным числам вашего магазина, а не по памяти. ROASaurus запускает MCP-сервер с 24 аналитическими инструментами только для чтения, и те же инструменты работают в Ask AI внутри дашборда.

В этом руководстве объясняется, что такое MCP, чем полезно задавать аналитические вопросы таким способом, как работают Ask AI и MCP-сервер, как подключить клиент, какие вопросы подходят лучше всего, а также что нужно знать о конфиденциальности, безопасности и ограничениях.

Что такое MCP?

MCP — это открытый стандарт подключения ИИ-приложений к внешним системам. ИИ-приложение, например Claude, — это клиент. Сервис, предоставляющий данные или действия, — это сервер. Сервер описывает свои инструменты: у каждого инструмента есть название, описание и схема входных данных.

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

У Shopify тоже есть MCP-серверы. Они ориентированы на агентов для покупок и разработчиков: поиск товаров, корзины, чекаут, аккаунты клиентов и документация для разработчиков. Аналитический MCP-сервер отвечает на вопросы другого рода: прибыль после рекламы, атрибуция и ценность клиентов — по вашим заказам, вашим расходам и затратам на рекламу в ваших рекламных аккаунтах.

Зачем спрашивать данные магазина у ИИ-ассистента?

Большинству вопросов о магазине нужны числа из нескольких отчётов. «Заработала ли Meta в прошлом месяце?» требует выручки, расходов на товар, доставки, комиссий и рекламных расходов в одном месте. В дашборде вы открываете нужный отчёт, задаёте даты и считаете. В ИИ-ассистенте, подключённом к вашим данным, вы задаёте вопрос и получаете ответ вместе с числами, на которых он основан.

Простой язык. Никаких фильтров, конструкторов отчётов и формул в таблицах.
Уточняющие вопросы. Спрашивайте «а по TikTok?» или «какая кампания это вызвала?», не начиная заново.
Несколько отчётов в одном ответе. Прибыль, атрибуцию и ценность клиентов можно объединить в одном ответе.
Ваш язык. Ask AI отвечает на том языке, на котором вы пишете.
Рядом с другой вашей работой. Через MCP числа магазина доступны в ИИ-приложении, где вы и так пишете рабочие отчёты или планы.

Ответ настолько полон, насколько полны данные за ним. Сначала подключите серверный трекинг, ваши рекламные аккаунты и расходы на товар, чтобы у инструментов были заказы, расходы и маржа для работы.

Как работают Ask AI и MCP-сервер ROASaurus?

Ask AI — это страница чата в дашборде ROASaurus. Он работает на Claude, модели Anthropic. MCP-сервер предлагает те же 24 инструмента выбранному вами ИИ-клиенту. В обоих случаях инструменты читают ваши отчёты 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. ИИ-приложения, такие как 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.

Безопасно ли это? Конфиденциальность и безопасность

Поскольку аналитические инструменты только читают, ИИ-приложение не может через ROASaurus поставить кампанию на паузу, изменить расход или настройку; с правом actions:write оно может только предложить изменение рекламы на утверждение владельцу или администратору. Инструменты принимают только фиксированные входные данные, например период или модель атрибуции из списка. Тем не менее несколько моментов требуют внимания.

Куда уходят данные. Ask AI отправляет ваш вопрос и агрегированные метрики магазина в Anthropic, которая запускает Claude. Контактные данные ваших клиентов он не отправляет. Через MCP результаты инструментов уходят в ИИ-клиент, который вы подключаете, на условиях этого клиента. Проверьте его настройки хранения данных и обучения.
Что возвращают инструменты. Итоги по периодам, каналам, кампаниям, объявлениям, товарам, когортам и сегментам. Они не возвращают имена клиентов, адреса email или номера телефонов.
Кто может спрашивать. Любой, у кого есть доступ к ИИ-приложению, где вы добавили подключение, может запрашивать данные магазина. Добавляйте его в свой собственный аккаунт, а не в общий.
Другие коннекторы. В спецификации MCP сказано, что всегда должен быть человек, который контролирует процесс и может отклонять вызовы инструментов, и что клиенты обязаны считать аннотации инструментов недоверенными, если сервер не является доверенным. Если в вашем ИИ-приложении есть и инструменты, которые отправляют email или публикуют сообщения, оставляйте для них запросы подтверждения включёнными.

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

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

Источники

В ROASaurus

Читайте дальше

Креативы, email и ИИУсталость креативов в рекламе Facebook: когда заменить объявлениеУсталость креативов в рекламе Facebook проявляется в росте частоты и падении CTR. Узнайте, как измерять её по каждому объявлению, читать hook rate и hold rate и выстроить регулярное обновление.Креативы, email и ИИЦепочки Klaviyo для брошенных корзин: узнавайте больше покупателейЦепочки Klaviyo для брошенных корзин и просмотров доходят только до тех покупателей, которых Klaviyo может идентифицировать. Узнайте, как он их идентифицирует и как узнавать больше покупателей на чекауте.ТрекингБлокировщики рекламы и трекинг: что теряет ваш магазинБлокировщики рекламы останавливают пиксели трекинга, поэтому рекламные платформы не видят часть покупок. Узнайте, какие события теряются, почему серверные события не теряются, и как измерить свой разрыв.