Collegare Falabella a Claude via MCP: stock e ordini

💡 Non vuoi installare nulla? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Falabella Seller Center, incolla le tue credenziali, genera una chiave API MCP e il gioco è fatto. Niente Docker, niente git clone, nessun server locale.

Falabella Seller Center + Claude

Lascia che la tua AI gestisca il tuo negozio su falabella.com in Cile, Colombia o Perù tramite Falabella Seller Center: prodotti, stock per magazzino, marchi, categorie e relativi attributi, ordini e relativi articoli, etichette di spedizione ed esiti dei feed, oltre alla creazione di prodotti e alla modifica di prezzi, stock e immagini.

Prerequisiti

Consulta le istruzioni di configurazione complete incluse nel connettore (visibili nello store in-app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

FALABELLA_USER_ID, FALABELLA_API_KEY, FALABELLA_SELLER_ID, FALABELLA_BUSINESS_UNIT

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti servono un account venditore su Falabella Seller Center, un utente di Seller Center con un ruolo API, la chiave API di quell'utente e il tuo Seller ID.

Non esiste una sandbox: ogni chiamata, scritture incluse, agisce sul tuo negozio reale.

1. Accedi a sellercenter.falabella.com con l'utente con cui il connettore deve operare. Un amministratore può aggiungere un utente dedicato in Mi cuenta → Usuarios → Agregar Usuario.
2. Apri Mi cuenta → Usuarios. Inserisci l'indirizzo e-mail dell'utente in FALABELLA_USER_ID e il valore della colonna API Key di quella riga in FALABELLA_API_KEY.
3. Assegna all'utente un ruolo API: Seller API Access (tutti i metodi), Seller API Product Access (prodotti, marchi, categorie, immagini e feed) oppure Seller API Order Access (ordini). Un metodo non coperto dal ruolo risponde con E009: Access Denied.
4. Copia il tuo Seller ID, mostrato in Mi cuenta, in FALABELLA_SELLER_ID.
5. Imposta FALABELLA_BUSINESS_UNIT sul tuo paese: FACL Cile, FACO Colombia, FAPE Perù. Un connettore serve un solo paese; aggiungi un secondo connettore per un altro paese.
6. Installa il connettore. Esegui falabella_seller_center_feed_count per verificare la connessione: è una chiamata leggera.

Come firma: ogni richiesta è firmata con HMAC-SHA256, usando come chiave la tua chiave API. La chiave in sé non viene mai inviata. Una richiesta con un timestamp troppo sfasato viene rifiutata (E003).

Cloud e self-hosted funzionano allo stesso modo: le credenziali sono le stesse e non c'è alcun URL di reindirizzamento da impostare.

Da dove iniziare: falabella_seller_center_get_products elenca i prodotti con filtri per stato, ricerca, SKU e date. falabella_seller_center_get_stock mostra lo stock per magazzino, Fulfillment by Falabella incluso. Per gli ordini, falabella_seller_center_get_orders e falabella_seller_center_get_order_items, che restituiscono l'OrderItemId e il PackageId necessari per etichette e cambi di stato. falabella_seller_center_get_document restituisce l'etichetta di spedizione.

Nuovi prodotti: trova la categoria con falabella_seller_center_get_category_suggestion a partire da un titolo, oppure in falabella_seller_center_get_category_tree (i prodotti vanno solo nelle categorie foglia). Leggi i suoi attributi con falabella_seller_center_get_category_attributes e il nome esatto del marchio con falabella_seller_center_get_brands. Poi crea i prodotti con falabella_seller_center_create_products e aggiungi le immagini con falabella_seller_center_set_images.

Le scritture sono feed: creare, aggiornare, modificare prezzi, stock e immagini e rimuovere prodotti è asincrono. Una risposta positiva significa solo che la richiesta è stata accettata. falabella_seller_center_feed_status mostra l'esito: attendi che Status sia Finished, Error o Canceled, poi leggi FailedRecords e FeedErrors, perché un feed può concludersi con alcuni record rifiutati. Falabella consente liberamente 50 chiamate di feed, poi una ogni 2 minuti per venditore, quindi l'AI inserisce più prodotti in un'unica richiesta invece di una chiamata per SKU.

Codici paese: la business unit è in maiuscolo (FACL). Nell'XML dei prodotti lo stesso paese è l'OperatorCode in minuscolo: facl, faco, fape.

Disattivati all'installazione: falabella_seller_center_remove_products (rimuove prodotti), falabella_seller_center_set_status_ready_to_ship (segna gli articoli dell'ordine come pronti per la spedizione) e falabella_seller_center_set_status_canceled (annulla un articolo dell'ordine). Attivali nella pagina del connettore quando vuoi che l'AI li usi; l'AI ti chiede di confermare ogni chiamata. La creazione e l'aggiornamento dei prodotti e la modifica di prezzi, stock e immagini sono attivi (falabella_seller_center_create_products, falabella_seller_center_update_products, falabella_seller_center_update_price, falabella_seller_center_update_stock, falabella_seller_center_update_stock_xml, falabella_seller_center_set_images).

Formati: i filtri per data sono in ISO 8601 (2026-11-01T00:00:00+00:00). I prezzi usano il punto come separatore decimale. Gli elenchi di id vanno tra parentesi quadre: [123456,123457]. Un aggiornamento modifica solo gli elementi che contiene.

Errori comuni: E007 significa che la firma non corrisponde: la chiave API deve appartenere all'utente in FALABELLA_USER_ID (stessa riga in Mi cuenta → Usuarios), copiata per intero. E009 significa che il ruolo dell'utente non copre quel metodo. E429 significa che è stato raggiunto il limite dei feed: attendi e riprova. Falabella segnala i rifiuti con HTTP 200; il connettore li segnala come chiamate non riuscite.

Passo 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

Passo 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 mostri YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.

1. In Claude, apri Customize → Connectors.
2. Clicca su +, poi su Add custom connector.
3. Inserisci un nome, ad es. Falabella Seller Center, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca su Add.
4. Clicca su Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool qui sotto compaiono nella tua chat: inizia a scrivere i tuoi prompt.

Tool disponibili

Prompt di esempio

• "Quali ordini sono arrivati oggi e quali articoli devono ancora essere spediti?"
• "Mostra lo stock dello SKU ZAP-RUN-42 in ciascun magazzino."
• "Il mio ultimo feed è terminato? Elenca eventuali record rifiutati e il motivo."
• "Cambia il prezzo dello SKU ZAP-RUN-42 a 49990 con un prezzo in offerta di 39990 fino a fine mese."
• "Suggerisci una categoria per 'Zapatillas running hombre' ed elenca i suoi attributi obbligatori."

FAQ

Funziona con Claude Code oltre che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Pagina del connettore
• Collega a ChatGPT
• Collega a Cursor
• Collega a Gemini
• Collega a Meta Muse
• Collega a Microsoft Copilot