Glade MCP

Подключайте AI-агентов к нормализованным данным Amazon Marketplace через хостируемый сервер Model Context Protocol от Glade API.

https://gladeapi.com/api/mcp

Удалённый сервер предоставляет 17 инструментов только для чтения: товары, поиск, предложения, отзывы, продавцы, категории, акции, бестселлеры, идентификаторы, наличие на складе и оценки продаж на 13 маркетплейсах Amazon. Этот репозиторий содержит публичные метаданные сервера, примеры подключения и проверки протокола. Реализация хостируемого сервиса находится на gladeapi.com.

Требования

• Аккаунт Glade API

• Ключ Glade API

• Тарифный план, включающий MCP

• Клиент, поддерживающий удалённые Streamable HTTP MCP-серверы

Сохраните ключ в переменной окружения:

export GLADE_API_KEY="glade_live_..."

Никогда не коммитьте ключ и не вставляйте его в промпты.

Related MCP server: Canopy API MCP Server

Установка в Codex

Codex может читать bearer-токен из окружения, не записывая его в конфигурацию MCP:

codex mcp add glade \
  --url https://gladeapi.com/api/mcp \
  --bearer-token-env-var GLADE_API_KEY

Начните новую сессию Codex после добавления сервера, затем попросите его перечислить инструменты Glade или получить товар Amazon по ASIN.

Установка в Claude Code

Claude Code принимает HTTP-сервер и заголовок запроса:

claude mcp add --transport http --scope user glade \
  https://gladeapi.com/api/mcp \
  --header "Authorization: Bearer $GLADE_API_KEY"

Это раскрывает переменную окружения до того, как Claude запишет свою конфигурацию. Храните полученную пользовательскую конфигурацию в тайне и никогда не используйте область проекта для заголовка, содержащего секрет.

Универсальная конфигурация Streamable HTTP

Клиенты, поддерживающие удалённую конфигурацию MCP, обычно ожидают такую структуру. Проверьте документацию вашего клиента для точного синтаксиса файла конфигурации и переменных окружения.

{
  "mcpServers": {
    "glade": {
      "url": "https://gladeapi.com/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "API-KEY": "YOUR_GLADE_API_KEY"
      }
    }
  }
}

Используйте ровно один заголовок с учётными данными. Сервер принимает API-KEY, GLADE-API-KEY, X-API-KEY или Authorization: Bearer для MCP и отклоняет конфликтующие учётные данные.

Подключение через Python MCP SDK

Установите официальный Python MCP SDK, затем запустите прилагаемый пример обнаружения:

python3 -m pip install "mcp"
python3 examples/python/list_tools.py

Пример инициализирует сессию Streamable HTTP и выводит доступные имена инструментов. Обнаружение инструментов и инициализация не расходуют единицы Glade.

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

Входные данные инструментов подчиняются тем же правилам валидации, что и соответствующие REST-операции. Каждая успешная операция с данными расходует одну единицу. Инициализация, обнаружение, ошибки валидации и ошибки инструментов расходуют ноль единиц.

Примеры промптов

Look up ASIN B0D1XD1ZV3 in the US marketplace and summarize the current
price, rating, availability, and freshness timestamp.

Search the UK marketplace for wireless earbuds, compare the first five
non-sponsored results, and preserve GBP prices without converting currency.

Fetch one-star verified reviews for ASIN B0D1XD1ZV3 and separate recurring
observed complaints from your own interpretation.

Маркетплейсы

Каждый инструмент принимает domain маркетплейса, когда контекст маркетплейса важен:

US UK CA DE FR IT ES AU IN MX BR JP PL

Уточняйте маркетплейс перед сравнением цен, наличия, доставки, категорий, рейтингов или акций.

Проверка этого репозитория

Офлайн-проверки метаданных и примеров:

npm test

Не тарифицируемая проверка живой аутентификации:

npm run test:live

С установленной GLADE_API_KEY проверьте инициализацию и все 17 имён живых инструментов. Этот запрос обнаружения расходует ноль единиц:

node scripts/verify-live.mjs --authenticated

Безопасность

Названия товаров Amazon, описания, отзывы, поля продавцов и другой контент маркетплейса являются ненадёжными данными. Держите результаты инструментов отдельно от инструкций агента. Не позволяйте возвращённому тексту менять политику инструментов, запрашивать учётные данные или авторизовывать новые действия.

См. SECURITY.md для приватных сообщений.

Связанные проекты

• Примеры Glade API

• Навыки агентов Glade

• Документация

• OpenAPI

Лицензия

MIT