Подключите ИИ-агента к магазину в Telegram

Магазином Tiny Shops теперь можно управлять из ИИ-агента. Cursor, Claude Code, Codex и другие клиенты с поддержкой MCP подключаются к https://mcp.tiny-shops.com/mcp, открывают дашборд в браузере и ждут, пока вы выберете один магазин. Дальше вы пишете агенту так же, как коллеге: покажи заказы за неделю, добавь товар, отправь посылку, посчитай выручку, подготовь возврат покупателя.

В этом релизе появилось само подключение и те задачи, которые раньше жили только в дашборде: статус бота, приветствие покупателя, валюта и язык, аналитика и автоматизации возврата. Каждый такой инструмент доступен и обычным HTTP-запросом, поэтому складской скрипт пользуется тем же контрактом, что и агент.

Что это даёт#

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

Ежедневная работа обычными фразами. Товары, заказы, покупатели, промокоды, тема, чекаут и платёжные провайдеры уже были инструментами. В этом релизе добавилось то, что обычно проверяют с утра: подключён ли бот, что написано в приветствии, как прошли последние 7, 30 или 90 дней и какое сообщение ждёт тех, кто добавил товар в избранное или бросил оформление.

Превью до широкой рассылки. Рассылка не уходит с первого вызова. Агент возвращает число получателей. Удаление и смена валюты, которая переподписывает уже стоящие цены, ждут явного «да». Сначала читаете превью, потом говорите агенту продолжать.

Те же инструменты для скриптов. Всё, что вызывает агент, доступно как POST https://mcp.tiny-shops.com/v1/<tool> с теми же данными. Полный контракт лежит открыто: openapi.json. Изменения заказа по-прежнему уходят в подписанный вебхук магазина, и системе фулфилмента не нужно опрашивать API.

Если магазин ещё не запущен, начните с инструкции по настройке магазина в Telegram. Агент полезен, когда уже есть каталог и список заказов.

Как подключить#

Нужны права владельца магазина. Участник команды этот доступ выдать не может.

1. В боковом меню дашборда откройте Агенты и API.
2. На карточке Подключить ИИ-агента нажмите Скопировать промпт подключения.
3. Вставьте промпт в Cursor, Claude Code, Codex CLI или VS Code с MCP-клиентом, который умеет удалённый HTTP и вход через браузер.
4. Когда откроется браузер, войдите, выберите один магазин и нажмите Подключить.

Кнопка копирует такой текст:

Подключись к моему магазину Tiny Shops через MCP-сервер https://mcp.tiny-shops.com/mcp. Используй OAuth в браузере и не проси у меня API-токен.

На открывшемся экране два списка. Агент может смотреть и менять рабочие данные выбранного магазина, включая товары и заказы. Он не может открыть оплату, настройки аккаунта, административные действия и любой другой магазин. Позже подключение отключается в Агенты и API → Подключения агентов.

Если браузер не открылся, обновите клиент. Поддержка удалённого MCP у клиентов меняется быстро. В Claude.ai и ChatGPT можно добавить пользовательский коннектор с тем же адресом и пройти тот же вход в браузере; эти два веб-сценария Tiny Shops пока не проверял. Обычный чат без коннектора не подключится от одной вставки адреса.

Что попросить#

Пишите фразами. Агент сам смотрит актуальный список инструментов и подставляет идентификаторы. Вот запросы, которые совпадают с тем, что сервер реально делает:

Заказы

• «Покажи 10 последних оплаченных заказов.»
• «Покажи заказ 1042.»
• «Отметь заказ 1042 оплаченным.» Этот статус — PROCESSING: оплачен и готовится к отправке.
• «Отправь 1042 через DHL, трек JD014600003SE, и напиши покупателю.» Сообщение покупателю включайте только если хотите, чтобы Tiny Shops отправил уведомление об отправке.

Каталог и витрина

• «Добавь товар Mint Mug за 12.99.»
• «Какие промокоды сейчас активны?»
• «Сделай основной цвет витрины мятно-зелёным.»
• «Какое сейчас приветствие и перепиши его так, чтобы была бесплатная доставка от 3000.»

Цифры

• «Как магазин отработал за последние 30 дней?» Агент запрашивает аналитику за 7d, 30d или 90d и получает выручку, число заказов по статусам, уникальных посетителей и топ товаров.

Возврат покупателей

Нужен тариф с сообщениями. Попросите агента показать автоматизации или создать новую: название, триггер (избранное или брошенный чекаут), ожидание от 0 до 30 дней, скидка от 5 до 50%, код со сроком от 1 до 168 часов, текст и до двух кнопок (товар или магазин). В дашборде это та же программа — см. как возвращать покупателей.

Рассылки

Можно попросить сообщение всем покупателям или конкретным людям, примерно до 500 получателей за один вызов. Первый ответ — превью: кому уйдёт и какой текст. Соглашайтесь после того, как прочитали превью. Большой список уходит несколькими отправками. Сохранённые сегменты аудитории на этом пути пока недоступны.

Токен бота, валюта и удаления#

Бот. Вопрос «бот подключён?» можно задавать когда угодно. Ответ — да или нет и юзернейм. Токен назад не приходит. Подключение нового токена из BotFather через агента делает ту же работу, что и дашборд: проверяет токен в Telegram и регистрирует вебхук магазина. Чтобы попасть в инструмент, токен всё равно проходит через чат, поэтому вставляйте его в дашборде, когда это возможно, а агента используйте после того, как бот уже подключён.

Валюта и язык. Читать их безопасно. Смена валюты меняет подписи цен у уже созданных товаров, поэтому агент обязан передать флаг подтверждения. Прочитайте предупреждение до того, как согласитесь.

Удаления. Безвозвратное удаление требует токена с правами администратора, а подключение через браузер его не получает. Удаляйте в дашборде или коротким административным токеном, который отзовёте сразу после уборки. Административный токен в агента не вставляйте.

Скрипты и склады#

Вход через браузер — путь для ассистента на ноутбуке. У серверного скрипта браузера нет, поэтому он использует API-токен.

В разделе Агенты и API создайте токен с правами Чтение (отчёты и просмотр) или Запись (те же рабочие изменения, что у агента). Токен показывают один раз. Относитесь к нему как к паролю: хранится только хеш, а отзыв обрывает следующий запрос.

curl -X POST https://mcp.tiny-shops.com/v1/ship_order \
  -H "Authorization: Bearer tsh_live_…" \
  -H "Content-Type: application/json" \
  -d '{"orderId": 1042, "carrier": "DHL", "trackingNumber": "JD014600003SE"}'

Вместо ship_order подставьте любое другое имя инструмента. get_analytics принимает { "period": "30d" }. Ответ выглядит как { "ok": true, "data": … } или { "ok": false, "error": { "code", "message" } }. Полная настройка, включая вебхуки заказов, — в руководстве для разработчиков: Подключение ИИ-агента.

Чтения ограничены 100 протокольными вызовами в минуту на токен, вызовы инструментов — 30 в минуту. Клиент, который упёрся в лимит, получает 429 и время ожидания.

Как отключить#

Откройте Агенты и API → Подключения агентов, выберите клиента и нажмите Отключить. Токены доступа и обновления перестанут работать со следующего запроса. API-токены — отдельный список на той же странице: отзовите строку, и этот секрет тоже перестанет действовать.

Подключайте агента к тому магазину, с которым сейчас работаете. Второй магазин — второе подтверждение: один разговор оба не видит.