Подключи Amazon Shipping MCP к Meta Muse

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

Amazon Shipping + Meta Muse

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

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

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

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

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

Настройка занимает около 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 означает подождать и повторить попытку.

Шаг 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 — Добавь коннектор в Muse

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

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

1. В Muse открой Settings → Connectors и выбери Add custom connector.
2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
4. В чате попроси Muse о том, для чего нужны инструменты Amazon Shipping.

Настроить коннектор можно и из чата — в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.

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

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

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

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

Откуда берутся учетные данные? Из частного SP-API приложения с ролью Amazon Logistics, созданного в Seller Central или, без аккаунта продавца, в Портале поставщиков решений Amazon. Скопируй LWA идентификатор клиента и секрет, авторизуй приложение для своего аккаунта, чтобы получить токен обновления, и выбери свой регион и страну Amazon Shipping.

Какие страны охватывает? Страны, где работает Amazon Shipping: Соединенные Штаты, Великобритания, Франция, Италия, Испания, Индия, Объединенные Арабские Эмираты, Саудовская Аравия, Египет и Япония. Это для посылок, отправленных с Amazon в качестве перевозчика, также для заказов, которые не поступают от Amazon.

Может ли он покупать ярлыки или отменять отправления? amazon_shipping_purchase_shipment, amazon_shipping_direct_purchase_shipment, amazon_shipping_one_click_shipment, amazon_shipping_cancel_shipment и amazon_shipping_generate_collection_form установлены отключенными. Включай их на странице коннектора только если ИИ должен их использовать.

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде — в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

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

• Страница коннектора
• Подключение к Claude