Collegare Falabella a Microsoft Copilot via MCP

💡 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 + Microsoft Copilot

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 Microsoft Copilot

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 mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Falabella Seller Center.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Pagina del connettore
• Collega a Claude