In breve
Gestisci un negozio Loja Integrada dalla tua AI: cerca prodotti, aggiorna stock e prezzi, crea prodotti, categorie e marchi, segui gli ordini, cambia lo stato degli ordini, aggiungi i codici di tracking e consulta i clienti. API v1 ufficiale.
Configurazione guidata
Collega Loja Integrada a Claude in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Loja Integrada con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
Prova a chiedere
Prompt di esempio per Loja Integrada
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Loja Integrada, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Loja Integrada + Claude
Gestisci un negozio Loja Integrada dalla tua AI: cerca prodotti, aggiorna stock e prezzi, crea prodotti, categorie e marchi, segui gli ordini, cambia lo stato degli ordini, aggiungi i codici di tracking e consulta i clienti. API v1 ufficiale.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY
Step 1 — Ottieni le credenziali
La configurazione richiede circa 5 minuti una volta che hai entrambe le chiavi, ma la chiave di applicazione arriva in 5-10 giorni lavorativi. Ti servono un negozio Loja Integrada con un piano a pagamento, l'accesso al suo pannello e una chiave di applicazione (chave de aplicação) che Loja Integrada rilascia per l'integrazione.
- Nel pannello del negozio apri Configurações → Chave para API, clicca Cadastrar nova chave e copia la chiave di 20 caratteri in
LOJA_INTEGRADA_API_KEY. Incolla solo la chiave, senzachave_api. Le chiavi API sono disponibili solo nei piani a pagamento (guida di Loja Integrada). - Richiedi la chiave di applicazione (chave de aplicação) a Loja Integrada con il modulo per integratori descritto in questo articolo della guida. Nel modulo elenca gli indirizzi IP da cui partiranno le chiamate API: su un'installazione self-hosted l'indirizzo del tuo server, su AnythingMCP Cloud l'indirizzo IPv4 fisso
104.248.242.235, da cui Cloud fa ogni chiamata. Anche la pagina di setup del connettore mostra gli indirizzi in uscita. Loja Integrada risponde in 5-10 giorni lavorativi. - Inserisci la chiave di applicazione, un UUID come
dc6049f0-1234-..., inLOJA_INTEGRADA_APP_KEY. Incolla solo la chiave, senzaaplicacao. - Installa il connettore e verifica la connessione con
loja_integrada_list_order_statuses.
La chiave di applicazione funziona solo dai suoi indirizzi IP: Loja Integrada rifiuta le chiamate da qualsiasi indirizzo non registrato con la chiave. Se l'indirizzo cambia (un nuovo server, il passaggio a Cloud o da Cloud), invia la nuova lista con lo stesso modulo prima di cambiare, così le chiamate non iniziano a fallire.
Cloud e self-hosting funzionano allo stesso modo: cambia solo l'indirizzo IP che registri con la chiave di applicazione.
Entrambe le chiavi viaggiano in un solo header: ogni chiamata invia Authorization: chave_api <API key> aplicacao <application key>; AnythingMCP lo compone dalle due variabili. Il login con Personal Token (Authorization: Basic ...) non è usato da questo connettore.
Limite di richieste: Loja Integrada consente 100 richieste al minuto per negozio e oltre risponde 429. Fai leggere le liste pagina per pagina invece di ripetere le chiamate; dopo un 429 aspetta un minuto.
Id e riferimenti: prodotti, categorie, marchi e clienti hanno id numerici (202591789); gli ordini si indicano con il loro numero (numero, ad esempio 164). I record si collegano tra loro con URI come /api/v1/categoria/15246059 (il campo resource_uri), che vanno così come sono in categorias, marca e pai di un prodotto. Con id_externo a 1, un prodotto o un prezzo si cerca con il tuo id esterno.
Paginazione, prezzi e date: le liste restituiscono 20 elementi per pagina di default, al massimo 50, e si sfogliano con limit e offset finché meta.next è null; meta.total_count è il totale. I prezzi sono in BRL e arrivano come stringhe tipo "32.83". I filtri per data accettano YYYY-MM-DD, con l'ora facoltativa.
Prodotti, varianti, stock e prezzi: un prodotto con varianti è un prodotto padre (tipo atributo) con un figlio per ogni variante (tipo atributo_opcao, con pai impostato sul padre); loja_integrada_list_grids e loja_integrada_get_grid mostrano i valori delle griglie di varianti, come taglie e colori. Prezzo e stock sono record separati, impostati dopo la creazione del prodotto. Lo stock è una quantità assoluta, non una differenza, e si imposta su ogni variante. Un aggiornamento sostituisce l'intero prodotto, quindi l'AI lo legge prima e reinvia ogni campo: i campi omessi possono essere svuotati.
Errori frequenti: 401 vuol dire che Loja Integrada ha rifiutato le chiavi: controlla LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY e che la chiave di applicazione sia registrata per l'indirizzo IP del connettore. 403 vuol dire che le chiavi sono state lette ma l'accesso è stato negato: la chiamata è partita da un indirizzo non registrato con la chiave di applicazione. 429 è il limite di richieste.
Cosa legge: prodotti con SKU, tipo (semplice, padre con varianti o variante), categorie, marca, dimensioni e peso, NCM e GTIN, immagini e griglie di varianti; stock con quantità riservata e disponibile; prezzo di listino, promozionale e di costo; categorie, marchi e griglie di varianti con i loro valori; ordini con cliente, indirizzo di fatturazione e di consegna, righe, pagamenti, spedizioni con codice di tracking, stato e totali, più lo storico degli stati di ogni ordine e gli stati d'ordine e i metodi di pagamento del negozio; clienti con email, CPF o CNPJ, telefoni e indirizzi.
I tool di scrittura sono attivi all'installazione: nessun tool è disattivato. Il connettore crea prodotti, categorie e marchi, modifica prodotti, imposta stock e prezzi, sposta gli ordini in un altro stato e aggiunge codici di tracking, tutto nel negozio live; un cambio di stato può inviare un'email all'acquirente e uno stato finale come cancellato è definitivo. Disattiva nella pagina del connettore quelli che non ti servono; l'AI ti chiede conferma prima di ogni modifica.
Nulla viene cancellato: nessun tool cancella dati o crea ordini, e il connettore non gestisce immagini dei prodotti, coupon, SEO, webhook, fatture (NF), marketing né etichette di spedizione Enviali.
Step 2 — Installa l'adapter
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
Step 3 — Aggiungi il connettore in Claude
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.
- In Claude apri Customize → Connectors.
- Clicca + e poi Add custom connector.
- Inserisci un nome, ad esempio
Loja Integrada, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add. - Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.
Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.
Tool disponibili
| 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) |
Esempi di prompt
- "Quante unità della SKU CAM-001 sono disponibili, e quali sono il prezzo di listino e quello promozionale?"
- "Mostrami gli ordini di questa settimana che aspettano ancora il pagamento."
- "Imposta il prezzo promozionale della SKU CAM-001 a R$ 89,90 e lo stock a 40 unità."
- "Segna l'ordine 164 come spedito e aggiungi il codice di tracking AA123456789BR."
- "Trova la cliente con l'email [email protected] ed elenca i suoi ordini."
FAQ
Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Prossimi passi
- Landing del connettore
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?