TikTok Shop MCP с Cursor: подключение

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → TikTok Shop Seller, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

TikTok Shop Seller + Cursor

Подключите ИИ к вашему магазину TikTok Shop: заказы с сообщениями и адресами покупателей, товары, остатки, склады, отгрузочные этикетки и отслеживание, возвраты и выплаты, а по запросу и изменение отправок, товаров, остатков и цен.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

TIKTOK_SHOP_APP_KEY, TIKTOK_SHOP_APP_SECRET, TIKTOK_SHOP_SERVICE_ID

Шаг 1 — Получите учётные данные

Когда приложение уже создано, настройка занимает около 15 минут. Нужны собственное приложение в TikTok Shop Partner Center (App key, App secret и Service ID) и аккаунт Seller Center владельца магазина.

Сначала нужен доступ seller developer: TikTok разрешает продавцу зарегистрироваться как seller developer и создать приложение для своего магазина, только если за магазином закреплён account manager. Без него Partner Center отвечает «This account is not eligible for seller developer registration». В этом случае попросите TikTok Shop через Help Center в Seller Center проверить, может ли за вашим магазином быть закреплён account manager, или используйте приложение разработчика, у которого есть доступ seller developer.

1. Войдите на partner.tiktokshop.com (магазины в США: partner.us.tiktokshop.com) под аккаунтом владельца магазина, откройте App & Service и создайте custom app для своего магазина. В Manage API включите scopes, нужные инструментам: Shop authorized information, Order information, Product basic и Product write, Fulfillment basic, Logistics basic, Return and refund basic и Finance information.
2. Укажите в Redirect URL приложения адрес вашего AnythingMCP с /api/tiktok-shop/callback в конце: https://cloud.anythingmcp.com/api/tiktok-shop/callback в AnythingMCP Cloud, <SERVER_URL>/api/tiktok-shop/callback (с вашим SERVER_URL) при self-hosting.
3. Скопируйте App key приложения в TIKTOK_SHOP_APP_KEY, App secret — в TIKTOK_SHOP_APP_SECRET, а Service ID (App & Service → ваше приложение → Basic Information) — в TIKTOK_SHOP_SERVICE_ID. Для магазина в США задайте TIKTOK_SHOP_MARKET равным US; для Великобритании, ЕС и всех остальных рынков оставьте поле пустым.
4. Установите коннектор, откройте его и нажмите Authorize with Provider. TikTok Shop попросит выбрать регион, войти в Seller Center и одобрить приложение; затем вы вернётесь в AnythingMCP, и коннектор готов к работе. Проверьте подключение через tiktok_shop_get_authorized_shops.

Cloud и self-hosting работают одинаково: коннектор всегда использует ваше собственное приложение. Отличается только Redirect URL.

Несколько магазинов: если одна авторизация охватывает несколько магазинов (кросс-бордер продавцы), до авторизации укажите в TIKTOK_SHOP_SHOP_ID id, код или точное название магазина. Без этого коннектор берёт первый магазин.

Токены обновляются сами: access token действует 7 дней и обновляется автоматически; refresh token действует, пока действует авторизация продавца, и хранится в зашифрованном виде. Если авторизация истекла или была отозвана в Seller Center, коннектор показывает, что нужна новая авторизация, его владелец получает одно письмо, а нажатие Authorize with Provider всё исправляет.

App secret остаётся в AnythingMCP: каждый вызов подписывается им (HMAC-SHA256), а сам секрет никогда не передаётся. TikTok отклоняет метку времени старше 5 минут, поэтому на собственном сервере с неверными часами будет ошибка timestamp.

Что читает коннектор: заказы с позициями, сообщением покупателя и заметкой продавца, именем и адресом получателя, суммами оплаты, перевозчиком, трек-номером и посылками; разбивку цены заказа; товары с категорией, брендом, изображениями, атрибутами и каждым SKU с ценой и остатком по складам; категории, в которых магазин может продавать, их атрибуты и правила размещения, а также бренды; склады, варианты доставки и перевозчиков; посылки, варианты забора курьером и сдачи в пункт, отгрузочные этикетки и упаковочные листы для печати и события отслеживания; запросы на возврат, возмещение и отмену; отчёты о выплатах и сумму, выплаченную по каждому заказу после сборов и комиссии.

Отключено при установке: tiktok_shop_ship_package, tiktok_shop_mark_package_shipped, tiktok_shop_update_order_shipping_info, tiktok_shop_create_product, tiktok_shop_edit_product, tiktok_shop_partial_edit_product, tiktok_shop_update_inventory, tiktok_shop_update_price, tiktok_shop_activate_products и tiktok_shop_deactivate_products. Они оформляют отправки, передают покупателям трек-номера, создают и редактируют товары, перезаписывают остатки, задают цены, снимают товары с продажи и возвращают их в продажу, то есть меняют живой магазин или то, что видят покупатели. Включайте на странице коннектора только нужные; перед каждым изменением ИИ спрашивает ваше подтверждение. tiktok_shop_upload_product_image включён: он только сохраняет изображение для будущего товара и не меняет ни одно объявление.

Деньги не движутся: ни один инструмент не возвращает деньги, не отменяет заказы и не отвечает покупателям. Это остаётся в Seller Center.

Id, время и страницы: id — длинные числа, которые ИИ передаёт строками; время указывается в секундах Unix; списки листаются через page_token.

Частые ошибки: 106001 — неверная подпись: App key и App secret относятся к разным приложениям. 105005 — у приложения или авторизации нет scope для этого API: включите его в Manage API и авторизуйтесь заново. 36009033 — у приложения есть список разрешённых IP, в котором нет адреса AnythingMCP. 36009002 или 429 — лимит запросов: подождите минуту и повторите.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты TikTok Shop Seller.

Доступные инструменты

Примеры запросов

• «Какие заказы ждут отправки и оставил ли кто-нибудь из покупателей сообщение?»
• «Дайте мне отгрузочные этикетки и упаковочные листы для посылок, созданных сегодня.»
• «У каких товаров хотя бы на одном складе осталось меньше 10 штук?»
• «Покажите открытые запросы на возврат и возмещение с причиной и суммой по каждому.»
• «Сколько мне выплатили за прошлую неделю после сборов и комиссии?»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot