Подключение ИИ-агента (RU)

Подключите Cursor, Claude или другой MCP-клиент к одному магазину Tiny Shops через OAuth либо используйте API-токен для скрипта.

Инструменты Tiny Shops доступны по адресу:

https://mcp.tiny-shops.com/mcp

Read in English: Connect an AI agent.

Для скриптов только для заказов, HTTP API и подписанных событий фулфилмента откройте API заказов и вебхуки.

Какие клиенты могут подключиться?

Десктопные и CLI-клиенты MCP

Cursor, Claude Code, Codex CLI и VS Code с MCP-расширением могут подключиться, если установленная версия поддерживает удалённый HTTP MCP и OAuth в браузере.
Поддержка в клиентах быстро меняется. Если вход в браузере не открылся, обновите клиент и проверьте его документацию по MCP. API-токен используйте только для доверенного скрипта или клиента, в котором действительно нет входа через браузер.

Веб-коннекторы

Claude.ai: добавьте пользовательский коннектор с адресом https://mcp.tiny-shops.com/mcp, затем пройдите вход в браузере. Этот сценарий ещё не проверен Tiny Shops.
ChatGPT: добавьте пользовательский коннектор в настройках коннекторов/разработчика с адресом https://mcp.tiny-shops.com/mcp, затем пройдите вход в браузере. Этот сценарий ещё не проверен Tiny Shops.

Обычные чаты

Обычный чат в Claude.ai, ChatGPT или другом сервисе не подключится только от вставки адреса сервера. Нужна функция MCP-коннектора или MCP-клиент. Никогда не вставляйте API-токен в обычный чат.

OAuth в браузере (рекомендуется)

Вставьте этот промпт в агент с поддержкой MCP:

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

Клиент автоматически найдёт OAuth, откроет дашборд Tiny Shops и предложит:

Войти в существующий аккаунт.
Выбрать ровно один магазин.
Выдать доступ на запись.

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

Запасной вариант с API-токеном

Для серверного скрипта или клиента без OAuth создайте токен tsh_… в Настройки → API-токены. Для изменений выберите write, для чтения — read, затем передавайте:

Authorization: Bearer tsh_live_…

Никогда не передавайте агенту административный токен.

Правила работы с инструментами

Используйте точные имена из ответа tools/list.
Каждый MCP-инструмент также доступен по HTTP: POST https://mcp.tiny-shops.com/v1/<tool> с теми же входными данными, правами токена, лимитами и изоляцией магазина.
«Отметить оплаченным» означает вызвать set_order_status со статусом PROCESSING.
Для деструктивных инструментов не отправляйте confirm при первом вызове. Сначала получите превью, покажите его владельцу и повторите с confirm: true только после явного подтверждения.

Настройка, аналитика и возврат покупателей

get_bot показывает состояние подключения и имя бота, но никогда не возвращает токен; connect_bot проверяет токен BotFather и регистрирует вебхук магазина.
get_welcome_message / update_welcome_message управляют приветствием покупателя.
get_store_settings / update_store_settings управляют валютой и основным языком. Смена валюты меняет обозначение цен существующих товаров и требует confirm: true.
get_analytics возвращает выручку, количество и статусы заказов, уникальных посетителей и популярные товары за 7d, 30d или 90d.
list_winbacks, create_winback и update_winback настраивают автоматизации возврата покупателей, если тариф включает сообщения.

Клиенты без поддержки MCP могут получить полный HTTP-контракт по адресу GET /v1/openapi.json.

Подробности о заказах и HTTP-примеры: API заказов и вебхуки.

Подключение ИИ-агента (RU)

On this page