Кратко
Управляйте магазином Loja Integrada с помощью ИИ: ищите товары, обновляйте остатки и цены, создавайте товары, категории и бренды, следите за заказами, меняйте их статусы, добавляйте трек-номера и находите покупателей. Официальный API v1.
Пошаговая настройка
Подключи Loja Integrada к ChatGPT за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Loja Integrada в пошаговой настройке и добавь свой MCP URL в ChatGPT. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Плагин AnythingMCP в каталоге ChatGPT отвечает на вопросы по базам данных вашей компании в AnythingMCP Cloud (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, только чтение): откройте страницу плагина (откроется в новой вкладке) и нажмите Install plugin. Все остальные коннекторы добавляются в ChatGPT как собственный MCP-сервер с MCP URL вашего AnythingMCP.
Попробуй спросить
Примеры промптов для Loja Integrada
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Loja Integrada, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Loja Integrada + ChatGPT
Управляйте магазином Loja Integrada с помощью ИИ: ищите товары, обновляйте остатки и цены, создавайте товары, категории и бренды, следите за заказами, меняйте их статусы, добавляйте трек-номера и находите покупателей. Официальный API v1.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY
Шаг 1 — Получите учётные данные
Когда оба ключа на руках, настройка занимает около 5 минут, но ключ приложения приходит через 5–10 рабочих дней. Нужны магазин Loja Integrada на платном тарифе, доступ к его панели и ключ приложения (chave de aplicação), который Loja Integrada выдаёт для интеграции.
- В панели магазина откройте Configurações → Chave para API, нажмите Cadastrar nova chave и скопируйте ключ из 20 символов в
LOJA_INTEGRADA_API_KEY. Вставляйте только ключ, безchave_api. Ключи API доступны только на платных тарифах (справка Loja Integrada). - Запросите у Loja Integrada ключ приложения (chave de aplicação) через форму для интеграторов, описанную в этой статье справки. В форме укажите IP-адреса, с которых будет вызываться API: при self-hosted установке адрес вашего сервера, в AnythingMCP Cloud фиксированный IPv4-адрес
104.248.242.235, с которого Cloud делает все вызовы. Исходящие адреса показаны и на странице настройки коннектора. Loja Integrada отвечает в течение 5–10 рабочих дней. - Укажите ключ приложения, UUID вида
dc6049f0-1234-..., вLOJA_INTEGRADA_APP_KEY. Вставляйте только ключ, безaplicacao. - Установите коннектор и проверьте подключение через
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 — Добавьте коннектор в ChatGPT
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.
- Перейди на chatgpt.com/plugins, нажми Add, затем Add custom MCP server.
- Введи название, например Name:
Loja Integrada. - В разделе Connection укажи в поле Server URL адрес
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDи оставь Authentication на OAuth. - Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
- Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.
Доступные инструменты
| Tool | What it does |
|---|---|
loja_integrada_list_products | List the store's products, 20 per page: id, sku, nome, tipo (normal, atributo = parent with variations, atributo_opcao = variation), ativo… |
loja_integrada_get_product | Read one product by its Loja Integrada id (or by your id_externo): name, SKU, type, active and featured flags, categories, brand… |
loja_integrada_create_product | Create a product. tipo normal is a simple product; atributo creates a parent for variations, and each variation is then created with tipo… |
loja_integrada_update_product | Update a product |
loja_integrada_list_stock | List the stock records of all products, 20 per page: produto URI, quantidade (quantity), quantidade_reservada (reserved by orders)… |
loja_integrada_get_stock | Read the stock of one product or variation: quantity, reserved and available quantity, whether stock is managed, and the availability… |
loja_integrada_update_stock | Set the stock of one product or variation: quantidade (absolute quantity, not a delta), gerenciado (track stock) and the availability ids… |
loja_integrada_list_prices | List the prices of all products, 20 per page: produto URI, cheio (list price), promocional (sale price), custo (cost) and sob_consulta… |
loja_integrada_get_price | Read the prices of one product or variation: cheio (list price), promocional (sale price, null when none), custo (cost) and sob_consulta |
loja_integrada_update_price | Change the prices of one product or variation: cheio (list price), promocional (sale price; send 0 or null to remove it), custo (cost) and… |
loja_integrada_list_categories | List the store's categories: id, nome, descricao, categoria_pai (parent URI), id_externo, url and resource_uri |
loja_integrada_create_category | Create a category, optionally below a parent category |
loja_integrada_list_brands | List the store's brands: id, nome, apelido, descricao, id_externo and resource_uri |
loja_integrada_create_brand | Create a brand |
loja_integrada_list_grids | List the variation grids (grades, e.g |
loja_integrada_get_grid | Read one variation grid with its variations (values such as P, M, G or Azul), each with id and nome |
loja_integrada_search_orders | Search orders, 20 per page (at most 50): numero (order number), situacao (status with codigo and nome), cliente URI, valor_total… |
loja_integrada_get_order | Read one order by its number: customer, billing and delivery address, items (itens with SKU, quantity and prices), payments, shipments… |
loja_integrada_list_order_statuses | List the order statuses of the store: id, codigo (e.g. aguardando_pagamento, pedido_pago, pedido_enviado, pedido_entregue… |
loja_integrada_update_order_status | Move an order to another status by its codigo, for example pedido_pago, pedido_em_separacao, faturado, pedido_enviado… |
loja_integrada_get_order_status_history | Read the status history of one order: each change with its date, the new and previous status and who changed it (alterado_por_nome), by… |
loja_integrada_update_tracking_code | Set the tracking code of one shipment of an order |
loja_integrada_list_payment_methods | List the payment methods of the store: id, nome, codigo and configuracoes (ativo, disponivel) |
loja_integrada_list_customers | List customers, 20 per page: id, nome, email, cpf or cnpj, phone numbers, sexo, data_nascimento, group and dates |
loja_integrada_search_customers | Search customers by e-mail and/or a created or updated date window; date-filtered results come newest modification first |
loja_integrada_get_customer | Read one customer by id: name, e-mail, CPF or CNPJ, company name, phones, birth date, group and addresses (enderecos) |
Примеры запросов
- «Сколько единиц SKU CAM-001 доступно и какие у него обычная и акционная цены?»
- «Покажите заказы этой недели, которые всё ещё ждут оплаты.»
- «Установите акционную цену SKU CAM-001 в R$ 89,90, а остаток в 40 штук.»
- «Отметьте заказ 164 как отправленный и добавьте трек-номер AA123456789BR.»
- «Найдите покупательницу с e-mail [email protected] и покажите её заказы.»
FAQ
Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.
Следующие шаги
Это руководство помогло?