Come collegare Flipkart Seller a Meta Muse via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Flipkart Seller, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Flipkart Seller + Meta Muse

Flipkart Marketplace Seller API v3 per il tuo account venditore: inserzioni con aggiornamento di prezzi e giacenze, spedizioni degli ordini (ricerca, dettagli, etichette e fatture, pronte per l'invio, annullamento, consegna al corriere e manifest) e resi.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

FLIPKART_APP_ID, FLIPKART_APP_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti serve un account venditore Flipkart.

1. Accedi al Flipkart Seller Hub (https://seller.flipkart.com) e apri Manage Profile > Developer Access.
2. Clicca Create New Access, dai all'applicazione un nome e una descrizione e invia. Flipkart mostra un Application ID e un Application Secret. Un'applicazione self access vale solo per il tuo account venditore; non condividerla con un partner.
3. Incollali in FLIPKART_APP_ID e FLIPKART_APP_SECRET.
4. Installa il connettore ed esegui flipkart_seller_search_listings per verificarli.

Il connettore accede con le credenziali client OAuth2: richiede un token con lo scope Seller_Api, inviando id e secret dell'applicazione come HTTP Basic, e ne richiede uno nuovo prima della scadenza o dopo un 401.

Inserzioni: l'AI scorre tutte le inserzioni (500 per pagina) con listing id, product id (FSN) e SKU, oppure le legge 20 alla volta con titolo, stato, verticale, prezzi e dimensioni. Per fino a 10 SKU legge i dettagli: MRP e prezzo di vendita, imposte, stato, profilo di evasione, SLA di spedizione, colli, giacenza per sede e ordini ancora da evadere.

Prezzi e giacenze: flipkart_seller_update_price e flipkart_seller_update_inventory modificano un singolo SKU e richiedono il suo product id e, per la giacenza, il location id. Cambiano subito ciò che vedono gli acquirenti, quindi l'AI conferma prima con te lo SKU e i nuovi valori. Una risposta 200 può comunque contenere status: failure per lo SKU, e l'AI ne legge il motivo.

Ordini (spedizioni): una spedizione è ciò che viene imballato e consegnato insieme. L'AI cerca le spedizioni prima dell'invio (APPROVED, PACKING_IN_PROGRESS, PACKED, FORM_FAILED, READY_TO_DISPATCH), dopo l'invio (SHIPPED, DELIVERED, PICKUP_COMPLETE) o annullate, 20 per pagina, e legge articoli dell'ordine, prezzi, date, il flag di blocco, indirizzi, corriere e tracking id. Le ricerche arrivano al massimo a 5.000 spedizioni, e gli ordini Flipkart Assured non sono inclusi.

Evadere un nuovo ordine: per una spedizione APPROVED che non è bloccata e ha superato la sua data dispatch-after, l'AI genera etichetta e fattura, le scarica come un unico PDF e segna la spedizione come pronta per l'invio, il che prenota il corriere. Prima del ritiro legge i conteggi di consegna per corriere con il codice monouso, e scarica il PDF del manifest per un corriere. Queste azioni rispondono per ogni spedizione con SUCCESS o FAILURE, anche quando lo stato HTTP è 200.

Resi: resi dei clienti e resi del corriere (spedizioni non consegnate) per data di creazione o di modifica, 25 per pagina, con stato, motivo e tracking id, oppure per id di reso o di tracking.

Disattivato all'installazione: flipkart_seller_cancel_shipments. Gli annullamenti danneggiano la valutazione del venditore e possono portare alla sospensione dell'account o di una sede, quindi un amministratore attiva questo tool consapevolmente, e l'AI lo usa solo quando glielo chiedi.

Formati: le date sono ISO 8601, in IST quando non è indicato un fuso. Gli importi sono in INR. Gli id d'ordine iniziano con OD, i listing id con LST e i location id con LOC; fsn è il product id di Flipkart e sku il tuo. Etichette, fatture e manifest arrivano come file PDF.

Errori comuni: 401 significa un token scaduto o rifiutato (controlla id e secret dell'applicazione), 400 o 422 una richiesta non valida con un codice come INVALID_REQUEST_PAGE_SIZE o INVALID_DATE_FORMAT, 403 un id che appartiene a un altro venditore, e 5xx un problema lato Flipkart come DEPENDENT_SYSTEM_CALL_FAILED, che conviene riprovare più tardi.

Il connettore non crea né modifica i contenuti delle inserzioni e non copre spedizione e resi in self ship, le inserzioni Flipkart Quick, i report o le notifiche degli ordini.

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 Muse

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.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di Flipkart Seller.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

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

Tool disponibili

Esempi di prompt

• "Quali spedizioni sono approvate e vanno inviate oggi?"
• "Genera le etichette per tutte le spedizioni approvate che non sono bloccate e dammi il PDF."
• "Qual è il prezzo e qual è la giacenza dello SKU TSHIRT-BLU-M in ciascuna sede?"
• "Imposta il prezzo di vendita dello SKU TSHIRT-BLU-M a 499 INR. Mostrami prima il prezzo attuale."
• "Elenca i resi dei clienti creati questa settimana con i loro motivi."

FAQ

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Microsoft Copilot