Подключи Amazon Shipping MCP к Gemini CLI

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

Amazon Shipping + Gemini

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

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

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Amazon Shipping.

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

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

• "Сравни тарифы 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 установлены отключенными. Включай их на странице коннектора только если ИИ должен их использовать.

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

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