Большинство 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#
Нужны права владельца магазина. Участник команды этот доступ создать не может.
- В боковом меню панели откройте Агенты и API.
- На карточке Подключить ИИ-агента нажмите Скопировать промпт подключения.
- Вставьте промпт в Claude Code, Cursor, Codex CLI или VS Code с MCP-клиентом, который умеет удалённые HTTP-серверы и вход через браузер.
- Когда откроется браузер, войдите, выберите один магазин и нажмите Подключить.
Кнопка копирует такой текст:
Подключись к моему магазину 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 →