Zusammenfassung
Steuere einen Loja-Integrada-Shop mit deiner KI: Produkte suchen, Bestand und Preise ändern, Produkte, Kategorien und Marken anlegen, Bestellungen verfolgen, Bestellstatus ändern, Sendungsnummern eintragen und Kunden nachschlagen. Offizielle API v1.
Geführte Einrichtung
Loja Integrada in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Loja Integrada in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Loja Integrada
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Loja Integrada klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Loja Integrada
Steuere einen Loja-Integrada-Shop mit deiner KI: Produkte suchen, Bestand und Preise ändern, Produkte, Kategorien und Marken anlegen, Bestellungen verfolgen, Bestellstatus ändern, Sendungsnummern eintragen und Kunden nachschlagen. Offizielle API v1.
Einrichtung
Die Einrichtung dauert etwa 5 Minuten, sobald du beide Schlüssel hast; auf den Anwendungsschlüssel wartest du aber 5 bis 10 Werktage. Du brauchst einen Loja-Integrada-Shop mit einem kostenpflichtigen Tarif, Zugriff auf sein Shop-Panel und einen Anwendungsschlüssel (chave de aplicação), den Loja Integrada für die Integration ausstellt.
- Öffne im Shop-Panel Configurações → Chave para API, klicke auf Cadastrar nova chave und kopiere den 20-stelligen Schlüssel in
LOJA_INTEGRADA_API_KEY. Füge nur den Schlüssel ein, ohnechave_api. API-Schlüssel gibt es nur in kostenpflichtigen Tarifen (Hilfe von Loja Integrada). - Beantrage den Anwendungsschlüssel (chave de aplicação) bei Loja Integrada über das Formular für Integratoren, das dieser Hilfeartikel beschreibt. Gib im Formular die IP-Adressen an, von denen die API aufgerufen wird: bei einer selbst gehosteten Installation die Adresse deines Servers, bei AnythingMCP Cloud die feste IPv4-Adresse
104.248.242.235, von der Cloud jeden Aufruf macht. Die Setup-Seite des Connectors zeigt die ausgehenden Adressen ebenfalls an. Loja Integrada antwortet innerhalb von 5 bis 10 Werktagen. - Trag den Anwendungsschlüssel, eine UUID wie
dc6049f0-1234-..., inLOJA_INTEGRADA_APP_KEYein. Füge nur den Schlüssel ein, ohneaplicacao. - Installiere den Connector und prüfe die Verbindung mit
loja_integrada_list_order_statuses.
Der Anwendungsschlüssel gilt nur für seine IP-Adressen: Loja Integrada lehnt Aufrufe von jeder Adresse ab, die nicht zum Schlüssel registriert ist. Ändert sich die Adresse (ein neuer Server, ein Wechsel zu Cloud oder weg von Cloud), schick die neue Liste über dasselbe Formular, bevor du umstellst, damit die Aufrufe nicht fehlschlagen.
Cloud und Self-Hosting funktionieren gleich: Nur die IP-Adresse, die du zum Anwendungsschlüssel registrierst, ist eine andere.
Beide Schlüssel stehen in einem Header: Jeder Aufruf sendet Authorization: chave_api <API key> aplicacao <application key>; AnythingMCP baut ihn aus den beiden Variablen. Den Personal-Token-Login (Authorization: Basic ...) nutzt dieser Connector nicht.
Rate-Limit: Loja Integrada erlaubt 100 Anfragen pro Minute und Shop und antwortet darüber mit 429. Lass Listen Seite für Seite lesen, statt Aufrufe zu wiederholen; nach einem 429 wartest du eine Minute.
IDs und Verweise: Produkte, Kategorien, Marken und Kunden haben numerische IDs (202591789); Bestellungen werden über ihre Nummer angesprochen (numero, z. B. 164). Datensätze verweisen über URIs wie /api/v1/categoria/15246059 aufeinander (das Feld resource_uri), die unverändert in categorias, marca und pai eines Produkts gehen. Mit id_externo auf 1 wird ein Produkt oder Preis über deine eigene externe ID gesucht.
Seiten, Preise und Datumsangaben: Listen liefern standardmäßig 20 Einträge pro Seite, höchstens 50, und blättern mit limit und offset, bis meta.next null ist; meta.total_count ist die Gesamtzahl. Preise sind in BRL und kommen als Strings wie "32.83". Datumsfilter nehmen YYYY-MM-DD, optional mit Uhrzeit.
Produkte, Varianten, Bestand und Preise: Ein Produkt mit Varianten ist ein Elternprodukt (tipo atributo) mit einem Kind pro Variante (tipo atributo_opcao, mit pai auf dem Elternprodukt); loja_integrada_list_grids und loja_integrada_get_grid zeigen die Werte der Varianten-Raster wie Größen und Farben. Preis und Bestand sind eigene Datensätze, die nach dem Anlegen des Produkts gesetzt werden. Der Bestand ist eine absolute Menge, keine Differenz, und wird auf jeder Variante gesetzt. Ein Update ersetzt das ganze Produkt, deshalb liest die KI es zuerst und sendet jedes Feld erneut: Weggelassene Felder können geleert werden.
Häufige Fehler: 401 heißt, dass Loja Integrada die Schlüssel abgelehnt hat: Prüfe LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY und ob der Anwendungsschlüssel für die IP-Adresse des Connectors registriert ist. 403 heißt, dass die Schlüssel gelesen, der Zugriff aber verweigert wurde: Der Aufruf kam von einer Adresse, die nicht zum Anwendungsschlüssel registriert ist. 429 ist das Rate-Limit.
Was der Connector liest: Produkte mit SKU, Typ (einfaches Produkt, Elternprodukt mit Varianten oder Variante), Kategorien, Marke, Maßen und Gewicht, NCM und GTIN, Bildern und Varianten-Rastern; Bestand mit reservierter und verfügbarer Menge; Listen-, Aktions- und Einkaufspreise; Kategorien, Marken und Varianten-Raster mit ihren Werten; Bestellungen mit Kunde, Rechnungs- und Lieferadresse, Positionen, Zahlungen, Sendungen mit Sendungsnummern, Status und Summen, dazu der Statusverlauf jeder Bestellung sowie die Bestellstatus und Zahlungsarten des Shops; Kunden mit E-Mail, CPF oder CNPJ, Telefonnummern und Adressen.
Schreib-Tools sind bei der Installation eingeschaltet: Kein Tool ist deaktiviert. Der Connector legt Produkte, Kategorien und Marken an, bearbeitet Produkte, setzt Bestand und Preise, setzt Bestellungen in einen anderen Status und trägt Sendungsnummern ein, alles in deinem Live-Shop; eine Statusänderung kann dem Käufer eine E-Mail schicken, und ein Endstatus wie storniert lässt sich nicht rückgängig machen. Schalte auf der Connector-Seite die aus, die du nicht brauchst; die KI lässt sich jede Änderung vorher von dir bestätigen.
Nichts wird gelöscht: Kein Tool löscht Daten oder legt Bestellungen an, und der Connector verwaltet keine Produktbilder, Gutscheine, SEO, Webhooks, Rechnungen (NF), Marketing oder Enviali-Versandlabels.
Voraussetzungen: LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY
Connector lokal installieren
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
Öffne http://localhost:3000/connectors/store, wähle Loja Integrada und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| 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) |
Beispiel-Prompts
- „Wie viele Stück der SKU CAM-001 sind verfügbar, und wie hoch sind Listen- und Aktionspreis?“
- „Zeig mir die Bestellungen dieser Woche, die noch auf die Zahlung warten.“
- „Setz den Aktionspreis der SKU CAM-001 auf R$ 89,90 und den Bestand auf 40 Stück.“
- „Setz Bestellung 164 auf versendet und trag die Sendungsnummer AA123456789BR ein.“
- „Finde die Kundin mit der E-Mail [email protected] und liste ihre Bestellungen auf.“
Nächste Schritte
War dieser Guide hilfreich?