Loja Integrada MCP с Gemini CLI

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

Loja Integrada + Gemini

Управляйте магазином Loja Integrada с помощью ИИ: ищите товары, обновляйте остатки и цены, создавайте товары, категории и бренды, следите за заказами, меняйте их статусы, добавляйте трек-номера и находите покупателей. Официальный API v1.

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

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

LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY

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

Когда оба ключа на руках, настройка занимает около 5 минут, но ключ приложения приходит через 5–10 рабочих дней. Нужны магазин Loja Integrada на платном тарифе, доступ к его панели и ключ приложения (chave de aplicação), который Loja Integrada выдаёт для интеграции.

1. В панели магазина откройте Configurações → Chave para API, нажмите Cadastrar nova chave и скопируйте ключ из 20 символов в LOJA_INTEGRADA_API_KEY. Вставляйте только ключ, без chave_api. Ключи API доступны только на платных тарифах (справка Loja Integrada).
2. Запросите у Loja Integrada ключ приложения (chave de aplicação) через форму для интеграторов, описанную в этой статье справки. В форме укажите IP-адреса, с которых будет вызываться API: при self-hosted установке адрес вашего сервера, в AnythingMCP Cloud фиксированный IPv4-адрес 104.248.242.235, с которого Cloud делает все вызовы. Исходящие адреса показаны и на странице настройки коннектора. Loja Integrada отвечает в течение 5–10 рабочих дней.
3. Укажите ключ приложения, UUID вида dc6049f0-1234-..., в LOJA_INTEGRADA_APP_KEY. Вставляйте только ключ, без aplicacao.
4. Установите коннектор и проверьте подключение через loja_integrada_list_order_statuses.

Ключ приложения работает только со своих IP-адресов: Loja Integrada отклоняет вызовы с любого адреса, не зарегистрированного для ключа. Если адрес меняется (новый сервер, переход на Cloud или обратно), отправьте новый список через ту же форму до переключения, чтобы вызовы не начали отклоняться.

Cloud и self-hosting работают одинаково: отличается только IP-адрес, который вы регистрируете для ключа приложения.

Оба ключа передаются в одном заголовке: каждый вызов отправляет Authorization: chave_api <API key> aplicacao <application key>; AnythingMCP собирает его из двух переменных. Вход через Personal Token (Authorization: Basic ...) этот коннектор не использует.

Лимит запросов: Loja Integrada допускает 100 запросов в минуту на магазин и сверх этого отвечает 429. Запрашивайте списки постранично, а не повторяйте вызовы; после 429 подождите минуту.

Id и ссылки: у товаров, категорий, брендов и покупателей числовые id (202591789); заказы указываются по номеру (numero, например 164). Записи ссылаются друг на друга через URI вида /api/v1/categoria/15246059 (поле resource_uri), которые передаются как есть в categorias, marca и pai товара. Если id_externo равен 1, товар или цена ищутся по вашему собственному внешнему id.

Страницы, цены и даты: списки по умолчанию возвращают 20 записей на страницу, максимум 50, и листаются через limit и offset, пока meta.next не станет null; meta.total_count — общее количество. Цены указаны в BRL и приходят строками вида "32.83". Фильтры по дате принимают YYYY-MM-DD, время необязательно.

Товары, вариации, остатки и цены: товар с вариациями — это родительский товар (tipo atributo) с дочерним товаром для каждой вариации (tipo atributo_opcao, с pai, указывающим на родителя); loja_integrada_list_grids и loja_integrada_get_grid показывают значения сеток вариаций, например размеры и цвета. Цена и остаток — отдельные записи, которые задаются после создания товара. Остаток задаётся абсолютным количеством, а не разницей, и для каждой вариации отдельно. Обновление заменяет товар целиком, поэтому ИИ сначала читает его и отправляет все поля заново: пропущенные поля могут очиститься.

Частые ошибки: 401 — Loja Integrada отклонила ключи: проверьте LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY и то, что ключ приложения зарегистрирован для IP-адреса коннектора. 403 — ключи прочитаны, но доступ запрещён: вызов пришёл с адреса, не зарегистрированного для ключа приложения. 429 — лимит запросов.

Что читает коннектор: товары с SKU, типом (простой товар, родитель с вариациями или вариация), категориями, брендом, размерами и весом, NCM и GTIN, изображениями и сетками вариаций; остатки с зарезервированным и доступным количеством; обычную и акционную цену и себестоимость; категории, бренды и сетки вариаций с их значениями; заказы с покупателем, платёжным адресом и адресом доставки, позициями, оплатами, отправками с трек-номерами, статусом и суммами, а также историю статусов каждого заказа, статусы заказов и способы оплаты магазина; покупателей с e-mail, CPF или CNPJ, телефонами и адресами.

Инструменты записи включены при установке: ни один инструмент не отключён. Коннектор создаёт товары, категории и бренды, редактирует товары, задаёт остатки и цены, переводит заказы в другой статус и добавляет трек-номера, и всё это в вашем рабочем магазине; смена статуса может отправить покупателю письмо, а финальный статус, например «отменён», необратим. Отключите на странице коннектора те, что вам не нужны; перед каждым изменением ИИ спрашивает ваше подтверждение.

Ничего не удаляется: ни один инструмент не удаляет данные и не создаёт заказы, а изображения товаров, купоны, SEO, вебхуки, счета (NF), маркетинг и отгрузочные этикетки Enviali коннектор не обрабатывает.

Шаг 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 теперь может вызывать инструменты Loja Integrada.

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

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

• «Сколько единиц SKU CAM-001 доступно и какие у него обычная и акционная цены?»
• «Покажите заказы этой недели, которые всё ещё ждут оплаты.»
• «Установите акционную цену SKU CAM-001 в R$ 89,90, а остаток в 40 штук.»
• «Отметьте заказ 164 как отправленный и добавьте трек-номер AA123456789BR.»
• «Найдите покупательницу с e-mail [email protected] и покажите её заказы.»

FAQ

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

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

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