Как подключить Amazon Ads к Gemini через MCP

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

Amazon Ads + Gemini

Читайте аккаунты Amazon Ads (Sponsored Products): рекламные профили, кампании, группы объявлений, товарные объявления, ключевые слова, минус-слова и таргеты, а также запрашивайте отчёты об эффективности Reporting v3 по Sponsored Products, Brands и Display. Для продавцов, вендоров и агентств в регионах NA, EU и FE.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

AMAZON_ADS_CLIENT_ID, AMAZON_ADS_CLIENT_SECRET, AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL, AMAZON_ADS_TOKEN_URL

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

1. Убедитесь, что у вас есть доступ к Amazon Ads API: одобренное API-приложение и связанный с ним security profile Login with Amazon (LWA). Доступ к API запрашивается в Amazon Ads (Partner Network или https://advertising.amazon.com/API). Без одобрения API вход работает, но Amazon отклоняет каждый вызов.

2. В консоли LWA (https://developer.amazon.com, Login with Amazon) откройте security profile, затем Web Settings, и добавьте https://cloud.anythingmcp.com/api/mcp-oauth/callback (если вы размещаете AnythingMCP сами: <your AnythingMCP URL>/api/mcp-oauth/callback) в Allowed Return URLs.

3. Скопируйте Client ID и Client Secret (Show Secret) с той же страницы в AMAZON_ADS_CLIENT_ID и AMAZON_ADS_CLIENT_SECRET. Client ID начинается с amzn1.application-oa2-client..

4. Задайте AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL и AMAZON_ADS_TOKEN_URL для вашего региона, в таком порядке:

   • Северная Америка (US, CA, MX, BR): https://advertising-api.amazon.com, https://www.amazon.com/ap/oa, https://api.amazon.com/auth/o2/token
   • Европа (UK, DE, FR, IT, ES, NL, SE, PL, TR, AE, SA, EG, IN): https://advertising-api-eu.amazon.com, https://eu.account.amazon.com/ap/oa, https://api.amazon.co.uk/auth/o2/token
   • Дальний Восток (JP, AU, SG): https://advertising-api-fe.amazon.com, https://apac.account.amazon.com/ap/oa, https://api.amazon.co.jp/auth/o2/token

   Коннектор видит только профили своего региона, поэтому, если вы рекламируетесь в нескольких, установите его по одному разу на каждый регион.

5. Оставьте AMAZON_ADS_REFRESH_TOKEN пустым, если только вы уже не авторизовали этот security profile для Amazon Ads API в другом месте (такой токен начинается с Atzr|). Установите коннектор, нажмите Authorize with Provider и войдите в аккаунт Amazon, у которого есть доступ к рекламным аккаунтам. Scope: advertising::campaign_management.

6. Запустите amazon_ads_list_profiles. Профиль означает одного рекламодателя на одном маркетплейсе, и его ID передаётся во все остальные инструменты. Пустой список означает, что у аккаунта нет рекламного аккаунта в этом регионе или он ни разу не создавал кампанию.

Только чтение: ИИ выводит кампании Sponsored Products, группы объявлений, товарные объявления (рекламируемые ASIN или SKU), ключевые слова со ставками и типами соответствия, минус-слова, а также таргеты по товарам, категориям и автоматические.

Эффективность только из отчётов: показы, клики, затраты, продажи, ACOS и ROAS доступны только в отчётах. amazon_ads_create_report запускает задание на отчёт на стороне Amazon (никакую кампанию он не меняет), а amazon_ads_get_report проверяет его статус. Обычно отчёты готовы за несколько минут, но в часы нагрузки на это может уйти до часа. Большинство типов отчётов охватывают 95 дней назад, а отчёт DAILY покрывает не больше 31 дня. Кампании Sponsored Brands и Sponsored Display не выводятся списком, но их эффективность доступна через отчёты.

Файл отчёта: готовый отчёт представляет собой ссылку на скачивание JSON-файла, сжатого gzip, которая действует около часа. Коннектор не может распаковать этот файл, поэтому ИИ передаёт ссылку вам: скачайте и откройте файл сами или передайте его инструменту, который умеет его распаковать. Затраты указаны в валюте профиля.

Лимиты и ошибки: Amazon ограничивает запросы по аккаунту и эндпоинту и отвечает 429 со временем ожидания перед повтором. Access-токены действуют один час и обновляются автоматически. 401: авторизуйтесь заново и проверьте, что client ID, URL входа и URL токена относятся к тому же региону, что и эндпоинт API. 403: у аккаунта Amazon нет доступа к этому профилю, или security profile не одобрен для Amazon Ads API. 425: такой же отчёт уже запрошен, и в ответе есть его ID.

Коннектор не создаёт и не меняет кампании, ставки и бюджеты и не выводит списки кампаний Sponsored Brands и Sponsored Display.

Шаг 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 Ads.

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

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

• «Выведи наши рекламные профили с маркетплейсом и валютой.»
• «Запроси отчёт Sponsored Products по кампаниям за последние 30 дней и дай мне ссылку на скачивание, когда он будет готов.»
• «Какие ключевые слова в наших ручных кампаниях используют широкое соответствие и какие у них ставки?»
• «Покажи минус-слова нашей самой крупной кампании, чтобы я проверил пробелы, прежде чем мы добавим новые.»

FAQ

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

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

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