Come collegare Flipkart Seller a Gemini 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 + Gemini

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Flipkart Seller.

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 cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot