Журнал
Обновление Tiny Shops

MCP-сервер Telegram для вашего магазина

MCP-сервер для магазина в Telegram: подключите Claude, Cursor или другого ИИ-агента к Tiny Shops, подтвердите доступ в браузере и ведите магазин в чате.

Большинство MCP-серверов для Telegram подключают ИИ-агента к самому Telegram: читают и отправляют сообщения от вашего личного аккаунта или от бота. Вести магазин — другая задача. Если вы продаёте в Telegram, вам нужен MCP-сервер, который работает с данными магазина: товарами, заказами, покупателями, рассылками и аналитикой. У Tiny Shops такой сервер работает по адресу https://mcp.tiny-shops.com/mcp. В этом гайде — какие бывают MCP-серверы для Telegram, как за четыре шага подключить к магазину Claude Code, Cursor, Codex или другой MCP-клиент, что просить у агента и как скрипты вызывают те же инструменты по HTTP.

Три вида MCP-серверов для Telegram#

ВидК чему получает доступ агентКак входитДля чего обычно
MCP для аккаунтаВаши личные чаты и сообщенияСессия вашего аккаунта TelegramЧитать свои чаты и отвечать в них
MCP для ботаТо, что видит и отправляет один ботТокен ботаОтправлять сообщения и уведомления через бота
MCP для магазина (Tiny Shops)Один магазин: каталог, заказы, покупатели, рассылки, настройкиВход в браузере, вы выбираете один магазинВести магазин: заказы, товары, рассылки, отчёты

Серверы для аккаунта — в основном проекты сообщества, и агент действует от вашего имени во всех чатах. Сервер Tiny Shops не трогает ваш личный аккаунт Telegram. Агент работает с одним магазином, по тем же правилам и лимитам тарифа, что и панель.

Что это даёт#

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

Ежедневная работа обычными фразами. Товары, остатки и варианты, заказы и отправка, покупатели и бонусы, промокоды, тема, оформление заказа и платёжные провайдеры, приветствие бота, рассылки, возвраты покупателей, входящие и аналитика — всё это инструменты.

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

Те же инструменты для скриптов и Nano. Каждый инструмент доступен и как POST https://mcp.tiny-shops.com/v1/<tool> с теми же данными, а полный контракт открыт: openapi.json. Nano, ассистент внутри панели, пользуется тем же набором инструментов.

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

Как подключить ИИ-агента к магазину в Telegram#

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

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

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

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

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

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

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

Заказы

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

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

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

Цифры

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

Рассылки

  • «Отправь всем нашу новую льняную рубашку карточкой товара с текстом „Снова в наличии“.»
  • «Запланируй сообщение для тех, кто пришёл на этой неделе, на пятницу 10:00.»

Агент может отправить сообщение всем, конкретным покупателям или сегментам из панели (новые за неделю, недавние покупатели). Сообщение — текст, карточка товара или подборка из 2–6 товаров. Первый ответ всегда превью: кому уйдёт и что в нём. Немедленная отправка — до 500 человек за вызов; у запланированной такого лимита нет. Рассылки считаются в месячный лимит тарифа (3, 10, 25 или без лимита). Тот же редактор в панели разобран в гайде как сделать рассылку в Telegram.

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

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

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

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

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

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

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

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

В разделе Агенты и 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" } }. Изменения заказа также уходят в подписанный вебхук заказов магазина, и системе фулфилмента не нужно опрашивать API. Полная настройка — в руководстве для разработчиков: Подключение ИИ-агента.

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

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

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

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

FAQ#

Что такое MCP-сервер для Telegram? MCP-сервер даёт ИИ-агенту набор инструментов, которые тот может вызывать. «Telegram MCP» обычно даёт инструменты для чатов Telegram — через ваш аккаунт или бота; большинство таких серверов в каталогах MCP — сторонние проекты. Сервер Tiny Shops — официальный для магазинов Tiny Shops, и его инструменты работают с данными магазина, а не с вашим аккаунтом Telegram.

Какие ИИ-клиенты с ним работают? Любой MCP-клиент, который умеет удалённые HTTP-серверы со входом через браузер: Claude Code, Cursor, Codex CLI, VS Code. Claude.ai и ChatGPT подключаются через пользовательский коннектор с тем же адресом.

Прочитает ли агент мои личные чаты в Telegram? Нет. Он работает с данными одного магазина. Переписка во входящих магазина доступна только через инструменты входящих и только для этого магазина.

Нужен ли API-ключ? Для ИИ-клиента — нет: он входит через браузер. API-токены нужны скриптам и серверам, которые не могут открыть браузер.

Может ли агент удалить мои товары или заказы? Нет. Удаление товаров, заказов, промокодов или своего домена — только с правами администратора, а агент, подключённый через браузер, их никогда не получает. Оплата и настройки аккаунта ему тоже недоступны.

Подключите агента к магазину на tiny-shops.com →

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

Обновление Tiny Shops

Оплата в TON в Telegram: обновление апреля

Как принимать оплату в TON в магазине в Telegram прямо на свой кошелёк, и ещё два обновления апреля: смена токена бота и удаление заказов. Шаги для каждого.

Канал

Новые статьи — сначала в Telegram.
Без спама и «лайфхаков роста».