Amazon Shipping MCP-сервер: тарифы и отслеживание

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

Amazon Shipping

Amazon Shipping API v2 (SP-API) для бизнеса, который отправляет с Amazon в качестве перевозчика: сравнивайте тарифы, отслеживайте посылки, повторно получайте этикетки и документы, находите шкафчики и пункты выдачи, а также читайте формы сбора. Покупка, покупка в один клик и отмена включены, но отключены. Частное приложение SP-API с ролью Amazon Logistics.

Настройка

Настройка занимает около 20 минут. Тебе нужны дополнительные отзывы Amazon.

1. Тебе нужен аккаунт Amazon Shipping. Продавцы на Amazon используют свой аккаунт Seller Central; другие отправители создают аккаунт на https://solutionproviderportal.amazon.com (аккаунт продавца не нужен) и завершают проверку идентификации разработчика.
2. Заполни профиль разработчика: для Data Access выбери Private Developer: I build application(s) that integrate my own company with Amazon Services APIs, для Roles выбери Amazon Logistics. Amazon отвечает примерно в течение 5 рабочих дней.
3. Создай клиентское приложение SP-API с именем AmazonShipping_YourCompany, с бизнес-сущностью Shipping и ролью Amazon Logistics, и ответь Нет на делегирование доступа к ограниченным (PII) данным.
4. В разделе LWA credentials выбери View и скопируй идентификатор клиента (amzn1.application-oa2-client.…) в SPAPI_CLIENT_ID, а секрет клиента в SPAPI_CLIENT_SECRET.
5. Авторизуй приложение для своего аккаунта (Authorize app) и скопируй токен обновления (Atzr|…) в SPAPI_REFRESH_TOKEN.
6. Выбери регион в SPAPI_ENDPOINT и свою страну Amazon Shipping в AMAZON_SHIPPING_BUSINESS_ID. Соединенные Штаты: Северная Америка. Великобритания, Франция, Италия, Испания, Индия, Объединенные Арабские Эмираты, Саудовская Аравия, Египет: Европа. Япония: Дальний Восток.

Коннектор обменивает токен обновления на https://api.amazon.com/auth/o2/token на одночасовые токены доступа и отправляет их в заголовке x-amz-access-token; заголовок x-amzn-shipping-business-id содержит страну. Переменные имеют те же имена, что и в коннекторе Amazon Seller Central, но приложение должно иметь роль Amazon Logistics: учетные данные продающего приложения без нее отвечают 403.

Перед первой реальной этикеткой: Amazon просит каждую новую интеграцию создать тестовую этикетку и получить ее одобрение (Руководство по тестовым этикеткам Amazon Shipping), а затем подтверждает дату первой отправки. Держи инструменты покупки отключенными, пока это не будет сделано.

С чего начать: amazon_shipping_get_rates с адресом отправления, местом назначения и одной посылкой возвращает услуги и цены; amazon_shipping_get_tracking отслеживает посылку по идентификатору отслеживания и идентификатору перевозчика.

Тарифы: amazon_shipping_get_rates требует для каждой посылки packageClientReferenceId твоего собственного, размеры, вес, застрахованную стоимость и хотя бы один товар. channel_details.channelType — EXTERNAL для заказов из твоего собственного магазина и AMAZON (с идентификатором заказа Amazon) для заказов Amazon. Ответ содержит requestToken и один rateId на услугу; оба нужны для покупки и истекают через 10 минут. Когда тариф говорит requiresAdditionalInputs, прочитай схему с помощью amazon_shipping_get_additional_inputs.

Отслеживание и документы: amazon_shipping_get_tracking возвращает сводный статус и историю событий; amazon_shipping_get_shipment_documents снова возвращает этикетку купленной посылки (base64) и требует идентификатор отправления и твой packageClientReferenceId. amazon_shipping_get_access_points находит шкафчики и пункты выдачи рядом с почтовым индексом.

Формы сбора: amazon_shipping_get_unmanifested_shipments показывает, что все еще ждет манифеста, amazon_shipping_get_collection_form_history и amazon_shipping_get_collection_form читают ранее заполненные формы, а amazon_shipping_get_carrier_accounts перечисляет связанные учетные записи перевозчиков. amazon_shipping_generate_collection_form завершает открытые отправления перевозчика и устанавливается в отключенном состоянии.

Покупка (отключена): amazon_shipping_purchase_shipment покупает тариф, amazon_shipping_one_click_shipment покупает по идентификатору услуги без запроса тарифа, amazon_shipping_direct_purchase_shipment покупает для заказа Amazon с услугой, которую выбирает Amazon, а amazon_shipping_cancel_shipment отменяет купленное отправление до передачи. Каждая покупка списывается с аккаунта Amazon Shipping. Передай ключ идемпотентности и используй его повторно при повторной попытке, чтобы тайм-аут не привел к двойной покупке.

Форматы: суммы — это объекты с value и unit (валюта); веса используют ГРАММ, КИЛОГРАММ, УНЦИЯ или ФУНТ, а размеры — ДЮЙМ или САНТИМЕТР; время — ISO 8601. Ответы обернуты в payload; ошибки приходят как errors, список из code, message и details.

Ограничения: 80 вызовов в секунду с всплеском до 100 для большинства операций; заголовок ответа x-amzn-RateLimit-Limit показывает примененный лимит. 429 означает подождать и повторить попытку.

Предварительные требования: SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

Установка коннектора локально

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

Открой http://localhost:3000/connectors/store, выбери Amazon Shipping и вставь переменные окружения, указанные в предварительных требованиях.

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

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

• "Сравни тарифы Amazon Shipping для посылки весом 2 кг из Манчестера M1 1AE в Лондон SW1A 1AA."
• "Отслеживай посылку Amazon Shipping QA0123456789 и сообщи мне о последнем сканировании."
• "Найди шкафчики Amazon рядом с почтовым индексом EC1A 1BB."
• "Повторно получи этикетку отправления, которое я купил сегодня утром."
• "Какие отправления еще не находятся в форме сбора?"

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

• Подключись к Claude
• Подключись к ChatGPT