TikTok Shop — MCP-сервер для Claude Code: функции и установка
MCP-сервер подключает Claude Code к TikTok Shop Partner API для чтения заказов, финансов, товаров и аналитики нескольких магазинов.
claude mcp add --env TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> --env TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> --transport stdio tiktok-shop -- uvx tiktok-shop-mcpЧто делает TikTok Shop
TikTok Shop даёт агенту доступ к данным магазинов через TikTok Shop Partner API. Сервер умеет получать заказы и возвраты, финансовые выписки, сведения о товарах, показатели магазина, видео, SKU и партнёрские продажи. Данные возвращаются в структурированном JSON.
Конфигурация хранится в shops.json за пределами проекта; путь можно задать через TIKTOK_SHOP_CONFIG. Для подключения нужны app_key, app_secret, токены, shop_id и shop_cipher из TikTok Shop Partner Center. Сервер доступен в режиме чтения: при обновлении токенов он записывает только собственный файл конфигурации. Для трёх инструментов с бестселлерами нужен scope Bestsellers, а магазин по умолчанию задаётся через TIKTOK_SHOP_BESTSELLERS_SHOP.
Сервер совместим с mcp 1.x и 2.x. В Claude Code его можно зарегистрировать командой через uvx, после чего агент сможет обращаться к данным выбранного магазина.
Какие задачи решает
- получить заказы конкретного магазина за дату
- сверить финансовые выписки и транзакции
- найти товары и SKU с лучшими показателями
- сравнить почасовые показатели магазина
- обновить токены одного или всех магазинов
Примеры запросов агенту
- Покажи магазины и сроки действия их токенов.
- Найди заказы магазина
MY SHOP USза2026-07-18в часовом поясе Eastern. - Сравни почасовой GMV за вчера и предыдущий день.
Как установить TikTok Shop
Командой платформы
claude mcp add --env TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> --env TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> --transport stdio tiktok-shop -- uvx tiktok-shop-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>
Командой платформы
codex mcp add tiktok-shop --env TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> --env TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> -- uvx tiktok-shop-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>
Файл настроек
{
"mcpServers": {
"tiktok-shop": {
"command": "uvx",
"args": [
"tiktok-shop-mcp"
],
"env": {
"TIKTOK_SHOP_CONFIG": "<TIKTOK_SHOP_CONFIG>",
"TIKTOK_SHOP_BESTSELLERS_SHOP": "<TIKTOK_SHOP_BESTSELLERS_SHOP>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>
Файл настроек
{
"servers": {
"tiktok-shop": {
"type": "stdio",
"command": "uvx",
"args": [
"tiktok-shop-mcp"
],
"env": {
"TIKTOK_SHOP_CONFIG": "<TIKTOK_SHOP_CONFIG>",
"TIKTOK_SHOP_BESTSELLERS_SHOP": "<TIKTOK_SHOP_BESTSELLERS_SHOP>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>
Командой платформы
gemini mcp add -e TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> -e TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> tiktok-shop uvx tiktok-shop-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о TikTok Shop
Как установить TikTok Shop в Claude Code?
Выполните claude mcp add tiktok-shop-mcp -- uvx tiktok-shop-mcp.
Что делает TikTok Shop?
Сервер даёт агенту инструменты для чтения заказов, финансов, каталога, аналитики, возвратов и партнёрских показателей через TikTok Shop Partner API.
Что нужно для работы инструментов с бестселлерами?
Нужен магазин с разрешением Bestsellers у приложения. Его имя можно задать через TIKTOK_SHOP_BESTSELLERS_SHOP; без этого используется первый магазин из shops.json.
