mcp-shopee — MCP-сервер для Claude Code: что делает и как установить
Подключает маркетплейс Shopee через Partner API v2 к ИИ-агентам. Позволяет проверять заказы, обновлять остатки товаров и оформлять доставку.
claude mcp add --env SHOPEE_PARTNER_ID=<SHOPEE_PARTNER_ID> --env SHOPEE_PARTNER_KEY=<SHOPEE_PARTNER_KEY> --env SHOPEE_ACCESS_TOKEN=<SHOPEE_ACCESS_TOKEN> --env SHOPEE_SHOP_ID=<SHOPEE_SHOP_ID> --env SHOPEE_ENV=<SHOPEE_ENV> --transport stdio shopee -- npx -y @codespar/mcp-shopeeЧто делает mcp-shopee
Сервер предоставляет 22 инструмента для работы с магазином на платформе Shopee. Агент может запрашивать данные по заказам пачками до 50 штук, менять цены и остатки позиций, а также заводить новые товары. Предусмотрены операции с возвратами, формирование скидок и отправка сообщений покупателям в чат продавца.
Авторизация опирается на подпись HMAC-SHA256, которую сервер рассчитывает сам на каждый запрос. Для подключения нужны ключи партнёра, идентификатор магазина и токен доступа. Токен истекает через 4 часа, поэтому автоматическое продление через refresh_token придётся настраивать отдельно от этого сервера.
Код находится в статусе 0.1.0-alpha.1. Параметры отгрузки для инструмента ship_order безопаснее сверить с документацией до отправки реальных посылок.
Какие задачи решает
- отслеживать и фильтровать статусы заказов по времени
- обновлять складские остатки и розничные цены
- скачивать транспортные накладные в PDF
- принимать встречные предложения покупателей по возвратам
Примеры запросов агенту
- Проверь заказы со статусом ожидания отправки за последние сутки
- Обнови остаток для товара 123456 на 15 штук
- Скачай транспортную накладную для заказа 240501ABC
Как установить mcp-shopee
Командой платформы
claude mcp add --env SHOPEE_PARTNER_ID=<SHOPEE_PARTNER_ID> --env SHOPEE_PARTNER_KEY=<SHOPEE_PARTNER_KEY> --env SHOPEE_ACCESS_TOKEN=<SHOPEE_ACCESS_TOKEN> --env SHOPEE_SHOP_ID=<SHOPEE_SHOP_ID> --env SHOPEE_ENV=<SHOPEE_ENV> --transport stdio shopee -- npx -y @codespar/mcp-shopeeВместо <…> подставьте свои значения
Командой платформы
codex mcp add shopee --env SHOPEE_PARTNER_ID=<SHOPEE_PARTNER_ID> --env SHOPEE_PARTNER_KEY=<SHOPEE_PARTNER_KEY> --env SHOPEE_ACCESS_TOKEN=<SHOPEE_ACCESS_TOKEN> --env SHOPEE_SHOP_ID=<SHOPEE_SHOP_ID> --env SHOPEE_ENV=<SHOPEE_ENV> -- npx -y @codespar/mcp-shopeeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"shopee": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-shopee"
],
"env": {
"SHOPEE_PARTNER_ID": "<SHOPEE_PARTNER_ID>",
"SHOPEE_PARTNER_KEY": "<SHOPEE_PARTNER_KEY>",
"SHOPEE_ACCESS_TOKEN": "<SHOPEE_ACCESS_TOKEN>",
"SHOPEE_SHOP_ID": "<SHOPEE_SHOP_ID>",
"SHOPEE_ENV": "<SHOPEE_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"shopee": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-shopee"
],
"env": {
"SHOPEE_PARTNER_ID": "<SHOPEE_PARTNER_ID>",
"SHOPEE_PARTNER_KEY": "<SHOPEE_PARTNER_KEY>",
"SHOPEE_ACCESS_TOKEN": "<SHOPEE_ACCESS_TOKEN>",
"SHOPEE_SHOP_ID": "<SHOPEE_SHOP_ID>",
"SHOPEE_ENV": "<SHOPEE_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SHOPEE_PARTNER_ID=<SHOPEE_PARTNER_ID> -e SHOPEE_PARTNER_KEY=<SHOPEE_PARTNER_KEY> -e SHOPEE_ACCESS_TOKEN=<SHOPEE_ACCESS_TOKEN> -e SHOPEE_SHOP_ID=<SHOPEE_SHOP_ID> -e SHOPEE_ENV=<SHOPEE_ENV> shopee npx -y @codespar/mcp-shopeeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-shopee
Как установить mcp-shopee в Claude Code?
Выполните команду `claude mcp add mcp-shopee -e SHOPEE_PARTNER_ID=<SHOPEE_PARTNER_ID> -e SHOPEE_PARTNER_KEY=<SHOPEE_PARTNER_KEY> -e SHOPEE_ACCESS_TOKEN=<SHOPEE_ACCESS_TOKEN> -e SHOPEE_SHOP_ID=<SHOPEE_SHOP_ID> -- npx -y @codespar/mcp-shopee`.
Что делает mcp-shopee?
Сервер связывает ИИ-ассистента с Shopee Partner API v2. Это открывает управление товарами, просмотр возвратов, подготовку отправлений и отправку сообщений в чат магазина.
Как устроен перевыпуск токена доступа?
Перевыпуск токена не входит в функции сервера. Значение SHOPEE_ACCESS_TOKEN действует 4 часа, поэтому его продление через refresh_token нужно реализовать во внешнем сервисе.
