AliExpress MCP с Cursor: заказы продавца

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Продавец AliExpress, вставь ключ приложения и секрет, нажми Authorize и войди с учетной записью продавца магазина, создай ключ API MCP, и всё готово. Никакого Docker, никакого git clone, никакого локального сервера.

Продавец AliExpress + Cursor

Позволь своему ИИ управлять твоим магазином на AliExpress: заказы и адреса доставки, декларации на отправку с твоим собственным перевозчиком, товары с ценами и наличием, категории, споры и отчеты о расчетах. Использует твоё собственное приложение продавца на открытой платформе AliExpress.

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

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

ALIEXPRESS_SELLER_APP_KEY, ALIEXPRESS_SELLER_APP_SECRET

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

Что тебе нужно: учетная запись продавца AliExpress, учетная запись разработчика на открытой платформе AliExpress и собственное приложение в категории Продавец-внутренний разработчик. AliExpress проверяет профиль разработчика и должен одобрить эту категорию приложения, прежде чем приложение может быть создано: никто, кроме AliExpress, не может ускорить этот процесс, и оно может отказать. В его китайском FAQ указано от 2 до 5 рабочих дней на проверку разработчика; время для категории не указано.

1. На https://openservice.aliexpress.com нажми Создать учетную запись (или войди в систему). Затем заполни свой профиль под своим идентификатором пользователя, Профиль: выбери тип разработчика, заполни поля и загрузи документы, которые запрашивает AliExpress. AliExpress проверяет профиль.
2. Открой Консоль приложений и нажми Создать. В списке категорий приложений нажми Подать заявку на Продавец-внутренний разработчик (для продавца AliExpress, который создает приложение для собственного использования), напиши, зачем оно тебе нужно, в поле Причина и нажми ОК. Категория будет отображаться как Ожидает до тех пор, пока AliExpress не одобрит её, затем Активна. Можно создать только одно приложение на категорию.
3. На одобренной категории нажми Создать приложение. Введи имя приложения и, в качестве URL обратного вызова, адрес этого сервера, за которым следует /api/iop-auth/callback (на AnythingMCP Cloud: https://cloud.anythingmcp.com/api/iop-auth/callback), затем нажми Отправить.
4. Нажми Обзор приложения, затем Управление на своём приложении. Скопируй Ключ приложения в ALIEXPRESS_SELLER_APP_KEY. В разделе Основная информация нажми Просмотреть и скопируй Секрет приложения в ALIEXPRESS_SELLER_APP_SECRET.
5. На той же странице посмотри на Группу разрешений API: группа, помеченная как Неактивна, должна быть запрошена с помощью Подать заявку и причины, прежде чем её API ответят.
6. В разделе Консоль приложений, Управление приложениями, Управление авторизацией введи учетную запись продавца своего магазина в белый список авторизации продавца и отправь. Самостоятельно разработанное приложение может привязывать до 50 магазинов, и только магазины, которые юридически связаны с разработчиком: одна и та же компания, материнская и дочерняя, одна и та же материнская компания или один и тот же юридический представитель или основной акционер.
7. На странице коннектора нажми Authorize. AliExpress покажет свою страницу входа: выбери страну, введи учетную запись продавца и пароль магазина и нажми Войти и авторизовать. Ты вернешься в AnythingMCP самостоятельно.

Срок действия токена: AnythingMCP хранит токен доступа и токен обновления в зашифрованном виде, считывает, как долго они действуют, из ответа AliExpress (expires_in и refresh_expires_in, в секундах) и самостоятельно обновляет токен доступа. Обновление приносит новый токен обновления, но не изменяет дату окончания токена обновления. Когда эта дата достигается (или AliExpress отвечает refresh_expires_in 0), нажми Authorize снова. Страница Управление авторизацией показывает сроки действия твоего приложения; китайское руководство AliExpress указывает 365 дней для токена доступа и 730 дней для токена обновления для самостоятельно разработанного приложения продавца.

Как это подписывается: каждый вызов идет на /sync с именем API в method, плюс app_key, access_token, миллисекундный timestamp, sign_method=sha256 и sign, верхний регистр HMAC-SHA256 всех параметров, отсортированных по имени, с ключом Секрета приложения. Секрет никогда не покидает AnythingMCP.

С чего начать

• Магазин: aliexpress_seller_get_seller_profile (идентификатор продавца, страна, валюта котировки, количество товаров) и aliexpress_seller_get_shop_info (идентификатор магазина, имя и URL).
• Заказы: aliexpress_seller_list_orders с order_status WAIT_SELLER_SEND_GOODS перечисляет то, что должно быть отправлено; aliexpress_seller_get_order дает суммы, подзаказы и отслеживание; aliexpress_seller_get_order_receipt_info — адрес доставки.
• Отправка с твоим собственным перевозчиком: aliexpress_seller_list_order_shipping_services указывает по подзаказу, отправляется ли он с твоим собственным перевозчиком (DBS) или с логистикой платформы; aliexpress_seller_list_shipment_providers дает коды провайдеров; aliexpress_seller_declare_shipment отправляет перевозчика и номер отслеживания в AliExpress и ничего не стоит; aliexpress_seller_modify_shipment исправляет это (не более двух раз, в течение десяти дней). aliexpress_seller_list_packages показывает пакеты и их статус.
• Логистика платформы (отключена при установке, потому что они заказывают логистическую услугу для магазина): aliexpress_seller_list_seller_addresses для адреса забора, aliexpress_seller_pack_order для создания пакета, aliexpress_seller_ship_platform_package для передачи, aliexpress_seller_cancel_package для отмены пакета. Печать накладной не включена: AliExpress возвращает её как файл внутри ответа, распечатай её из центра продавца.
• Продукты: aliexpress_seller_list_products по статусу, aliexpress_seller_get_product с каждым SKU, aliexpress_seller_update_prices и aliexpress_seller_update_stock по sku_code, aliexpress_seller_set_products_online, и aliexpress_seller_set_products_offline (отключено). Публикация, редактирование и удаление продуктов не включены.
• Настройки каталога: aliexpress_seller_list_categories, aliexpress_seller_list_publishable_categories и aliexpress_seller_list_freight_templates.
• Споры: aliexpress_seller_list_disputes и aliexpress_seller_get_dispute — чтения. aliexpress_seller_accept_dispute_solution отключен: принятие предложения является обязательным и может вернуть деньги покупателю.
• Деньги: aliexpress_seller_list_settlement_bills перечисляет отчеты о расчетах. Коннектор никогда не платит, не возвращает деньги и не выводит средства самостоятельно.

Идентификаторы и форматы

• Идентификаторы заказа, подзаказа, продукта и спора — это длинные числа: передавай их как текст, только цифры. Идентификатор подзаказа (child_id в списке заказов, id в child_order_list заказа) — это то, что инструменты отправки называют tradeOrderItemId.
• Времена заказов указаны в Тихоокеанском времени США, записаны как yyyy-MM-dd HH:mm:ss. Фильтры пакетов и споров принимают Unix-время в миллисекундах. Периоды расчетов записаны как YYYY/MM/dd, их даты выпуска — Unix миллисекунды.
• Суммы — это объекты с amount (десятичная строка) и currency_code; цены, которые ты отправляешь, — это десятичные строки в валюте продукта.
• Списки страниц начинаются с 1: заказы и споры до 50 на странице, пакеты до 50, продукты менее 100. Обновления цен и запасов принимают максимум 20 продуктов с 200 SKU каждый.
• order_status FINISH охватывает завершенные и закрытые заказы, и возвращается только по запросу. endReason в extend_map его подзаказов различает их.

Ответы и ошибки: результаты находятся под aliexpress_..._response (имя API с подчеркиваниями). Многие вызовы отвечают 200 и содержат свой собственный вердикт внутри: result.success с errorCode и errorMessage (или error_code и error_message), update_success с update_failed_list для обновлений цен и запасов. Всегда читай это, прежде чем сообщить пользователю, что запись прошла успешно. Отказы шлюза приходят как error_response с code: IllegalAccessToken, когда авторизация закончилась (AnythingMCP обновляет токен один раз и повторяет попытку), InvalidAppkey или IncompleteSignature, когда ключ и секрет не совпадают, InsufficientPermission, когда приложению не хватает группы разрешений API, и код ограничения вызовов, когда квота категории приложения исчерпана.

Шаг 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. Начинай общаться: агент теперь может вызывать инструменты Продавец AliExpress.

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

Примеры подсказок

• "Какие заказы AliExpress ждут, чтобы я их отправил?"
• "Заявить отправку заказа 8187654321098765 с отслеживанием Cainiao LP00123456789012."
• "Какие споры открыты, и что просят покупатели?"
• "Установить запас SKU AE-CASE-14-BLK на 300 и цену на 4.99 USD."
• "Показать отчеты о расчетах за прошлый месяц."

Часто задаваемые вопросы

Нужно ли вставлять токен доступа? Нет. Ты вставляешь Ключ приложения и Секрет приложения своего приложения Продавца-внутреннего разработчика, добавляешь магазин в белый список продавца приложения и нажимаешь Authorize на странице коннектора. Страница входа AliExpress запрашивает учетную запись продавца магазина, а коннектор сам хранит и обновляет токены.

Что он охватывает, а что нет? Заказы и адреса доставки, декларации на отправку с твоим собственным перевозчиком, пакеты, продукты с ценами и запасами, категории, шаблоны фрахта, споры и отчеты о расчетах. Публикация или редактирование продуктов и сообщений покупателей не охватываются.

Какие инструменты установлены отключенными? Инструменты логистики платформы (aliexpress_seller_pack_order, aliexpress_seller_ship_platform_package, aliexpress_seller_cancel_package), aliexpress_seller_set_products_offline и aliexpress_seller_accept_dispute_solution. Включай их на странице коннектора только если ИИ должен их использовать.

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

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

• Страница приземления коннектора
• Подключить к Claude