Come collegare Ozon Seller a ChatGPT via MCP

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

Ozon Seller + ChatGPT

Gestisci un account venditore Ozon da un agente AI: prodotti, giacenze e prezzi, spedizioni FBS e FBO, resi, addebiti e accrediti finanziari e il report del saldo, analisi delle vendite, magazzini, promozioni, recensioni e domande dei clienti, con aggiornamento di prezzi e giacenze. Un Client ID e una chiave API.

Prerequisiti

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

OZON_CLIENT_ID, OZON_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti nel tuo account venditore Ozon. Il connettore è stato testato con dati Ozon reali: i suoi tool di lettura sono stati verificati su un account venditore attivo.

1. Nel portale venditori apri Settings → Seller API (seller.ozon.ru/app/settings/api-keys) e fai clic su Generate key.
2. Dai un nome alla chiave e scegli il suo ruolo: Admin copre tutti i tool, un ruolo più ristretto funziona per i tool che copre. Se Ozon chiede a cosa serve la chiave, scegli un servizio esterno e indica AnythingMCP.
3. Copia subito la chiave in OZON_API_KEY, perché Ozon la mostra una sola volta, e il Client ID della stessa pagina (un numero) in OZON_CLIENT_ID. Installa il connettore.
4. Esegui ozon_get_api_key_info: mostra i ruoli della chiave e la sua scadenza. Le chiavi Ozon durano 3 mesi, quindi creane una nuova prima che scada.

Cosa legge: i tuoi prodotti per codice articolo (offer_id), id prodotto Ozon o SKU, con nome, codici a barre, prezzi, IVA, stato ed errori di moderazione; le giacenze su FBO, FBS e rFBS e per ciascun tuo magazzino; i prezzi con prezzo minimo, prezzo dopo le tue promozioni, indice di prezzo e commissione di vendita per FBO e FBS; le spedizioni FBS, rFBS e FBO di un periodo, e una spedizione FBS completa di consegna, tracking, annullamento e importo liquidato per prodotto; i resi con motivo e stato; il report del saldo come in Finance → Balance, tutti i movimenti di un giorno e i movimenti relativi a un massimo di 200 spedizioni; le analisi delle vendite; i tuoi magazzini; le promozioni Ozon a cui puoi aderire; recensioni e domande dei clienti. I dati di contatto degli acquirenti non vengono mai restituiti.

Finanza: Ozon ha disattivato il vecchio elenco delle transazioni a settembre 2026. Il connettore usa già i metodi che lo sostituiscono: il report del saldo fino a 30 giorni, l'elenco giornaliero dei movimenti e i movimenti per spedizione.

Le spedizioni richiedono un periodo: per gli elenchi FBS e FBO l'AI indica sempre una data di inizio e una di fine (al massimo un anno). Per gli ordini FBS di oggi filtra sullo stato in attesa di imballaggio.

Abbonamenti: le recensioni richiedono l'abbonamento Review management o Premium Pro, le domande dei clienti Premium Plus; senza, Ozon rifiuta quelle chiamate. Senza Premium Plus le analisi restituiscono solo ricavi e unità ordinate, per gli ultimi 3 mesi e al massimo 50 chiamate al giorno. Le analisi consentono comunque una chiamata al minuto.

Chiede prima di ogni modifica: ozon_update_prices e ozon_update_stocks modificano il negozio online. L'AI ti mostra ogni prodotto con il prezzo o la giacenza vecchi e nuovi, aspetta il tuo sì, poi controlla la risposta di Ozon e rilegge i valori. Una giacenza sostituisce quella attuale e deve escludere le unità riservate, quindi l'AI le legge prima. Il prezzo di ogni prodotto può cambiare al massimo 10 volte all'ora. Le risposte alle recensioni (ozon_reply_to_review) e alle domande (ozon_answer_question) sono pubbliche sulla pagina del prodotto: l'AI ti mostra il testo esatto prima di pubblicarlo.

Disattivati all'installazione: ozon_ship_fbs_posting (preparare un ordine FBS in colli) e ozon_cancel_fbs_posting (annullare un ordine FBS, operazione irreversibile che può pesare sul tuo rating di venditore). Un amministratore li attiva consapevolmente, e l'AI chiede ogni volta la tua conferma esplicita.

Limiti di richieste: al massimo 50 richieste al secondo per Client ID, più limiti per singolo metodo. In caso di 429 l'AI attende il tempo indicato da Ozon in Retry-After. Ozon può bloccare le chiavi che inviano molte richieste identiche o non riuscite.

Errori comuni: 401 Invalid Api-Key significa che la chiave è errata, scaduta o appartiene a un altro Client ID. 403 "missing a required role" significa che la chiave funziona ma il suo ruolo non copre quel tool; controlla i ruoli con ozon_get_api_key_info. 403 "restricted to specific IP addresses": consenti tutte le reti per la chiave.

Il connettore non crea né modifica schede prodotto, non crea richieste di fornitura FBO, non stampa etichette o verbali, non chatta con gli acquirenti, non aderisce né gestisce promozioni e non usa l'API Performance (pubblicità).

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 ChatGPT

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.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca + e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: Ozon Seller.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Tool disponibili

Esempi di prompt

• "Quali ordini FBS sono in attesa di imballaggio adesso, e da quale magazzino?"
• "Mostrami il saldo Ozon della prima metà di ottobre: maturato, liquidato, vendite, resi e commissioni."
• "Quali prodotti sono esauriti nel mio magazzino, e quante unità ho ancora nei magazzini Ozon?"
• "Cosa ha addebitato e pagato Ozon per la spedizione 89491381-0072-1? Dettaglia i movimenti."
• "Alza il prezzo dell'articolo ART-123 da 1.990 a 2.190 rubli. Mostrami il prezzo vecchio e quello nuovo prima di cambiarlo."
• "Mostrami le nuove recensioni da 1 e 2 stelle di questa settimana e prepara delle risposte da farmi approvare."

FAQ

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse