Ozon Performance MCP: collegare a ChatGPT

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

Ozon Performance (Ads) + ChatGPT

Ozon Performance API per l'account pubblicitario del venditore: campagne pay-per-click, pay-per-order e banner, i loro prodotti e le offerte, offerte della concorrenza e limiti di offerta, statistiche giornaliere e di spesa e i report dettagliati delle campagne. Ferma le campagne e cambia le offerte. Un client ID e un client secret di un account di servizio.

Prerequisiti

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

OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti serve un account venditore Ozon con il suo account pubblicitario (Ozon Performance), in cui crei un account di servizio e una chiave.

1. Nel portale venditori di Ozon apri Settings → API keys → Performance API (seller.ozon.ru/app/settings/api-keys?currentTab=performanceApi).
2. Se non c'è ancora un account di servizio, creane uno con Create new account. Clicca sul nome dell'account di servizio, poi su Add new key.
3. Copia il client ID in OZON_PERFORMANCE_CLIENT_ID: finisce con @advertising.performance.ozon.ru, quindi incollalo per intero. Copia il client secret, mostrato insieme al client ID quando aggiungi la chiave, in OZON_PERFORMANCE_CLIENT_SECRET. Se il secret è andato perso, aggiungi una nuova chiave.
4. Installa il connettore e verifica la connessione con ozon_performance_list_campaigns (senza argomenti): elenca le tue campagne con gli id che usano tutti gli altri tool.

Separato dal connettore Ozon Seller: questo connettore copre solo l'account pubblicitario e ha credenziali proprie, quindi la chiave della Seller API qui non si usa. Per ordini, prodotti, stock e prezzi usa il connettore Ozon Seller.

Cloud e self-hosting funzionano allo stesso modo: inserisci gli stessi due valori e non c'è nessuna Redirect URL da impostare.

I token si rinnovano da soli: il connettore scambia client ID e secret su POST /api/client/token (grant type client_credentials) con un bearer token valido 30 minuti, e ne prende uno nuovo prima che scada o dopo un 401. Un 401 nel passaggio del token vuol dire che client ID o secret sono sbagliati o che la chiave è stata eliminata: copiali di nuovo, oppure aggiungi una nuova chiave all'account di servizio. Un 403 vuol dire che l'account di servizio non ha accesso a quel metodo o a quella campagna.

Tipi di campagna: SKU è il pagamento per clic (Оплата за клик), SEARCH_PROMO il pagamento per ordine (Оплата за заказ), e poi ci sono BANNER e VIDEO_BANNER. I prodotti di una campagna a clic e le loro offerte arrivano da ozon_performance_list_campaign_products; i prodotti nella promozione a pagamento per ordine da ozon_performance_list_cpo_products.

Statistiche rapide: ozon_performance_get_daily_statistics, ozon_performance_get_expense_statistics e ozon_performance_get_cpc_campaign_statistics rispondono subito con righe JSON. Senza date coprono gli ultimi 7 giorni. Le date sono giorni (2026-10-01), che Ozon raggruppa secondo l'ora di Mosca. ozon_performance_get_cpc_campaign_statistics non conta nei limiti dei report.

I report dettagliati sono asincroni: ozon_performance_request_campaign_report ordina un report per prodotto per un massimo di 10 campagne su al massimo 62 giorni, raggruppato per giorno, settimana o mese, e restituisce un UUID. L'AI controlla ozon_performance_get_report_status ogni pochi secondi finché state è OK (o ERROR), poi scarica il report con ozon_performance_download_report: testo CSV (separato da punto e virgola, nomi di colonna in russo) per una campagna, un file ZIP con un CSV per campagna per più campagne. Per ogni account gira un solo report alla volta, e al massimo 2000 al giorno; ozon_performance_list_api_reports trova i report ordinati in precedenza. ozon_performance_request_search_phrases_report funziona allo stesso modo per le frasi di ricerca della promozione in cima ai risultati, un metodo che Ozon indica come in fase di test.

Importi e id: i budget delle campagne sono in milionesimi di rublo (1000000 = 1 rublo); i limiti di offerta di ozon_performance_get_bid_limits sono in rubli; le offerte a pagamento per ordine sono una percentuale del prezzo del prodotto. Gli id sono stringhe numeriche.

Modificare le offerte: ozon_performance_update_campaign_bids cambia le offerte dei prodotti già presenti in una campagna a clic, e Ozon sostituisce le stop word e le offerte per frase della campagna con quello che viene inviato. ozon_performance_add_campaign_products aggiunge al massimo 500 prodotti per campagna; in una campagna con strategia automatica, solo prodotti della sua categoria autopilot. Un'offerta per clic vale solo con la strategia a costo medio per clic e si indica nella stessa unità delle offerte attuali che il connettore legge; senza, Ozon imposta l'offerta competitiva.

Limiti di richieste: al massimo 100.000 richieste al giorno per account, più limiti sulle modifiche alle campagne (ad esempio 500 modifiche di budget o di strategia per campagna al giorno) e sui report. In caso di 429, aspetta e riprova più tardi.

Cosa legge: le tue campagne con tipo, stato, tipo di pagamento, posizionamento, strategia, date e budget; gli SKU o i banner che una campagna promuove; i prodotti di una campagna a clic con offerta per clic, quota obiettivo del costo pubblicitario o fascia di posizione nella ricerca; le offerte degli altri venditori sugli stessi SKU, e le offerte minime e massime per strumento di promozione, posizionamento e categoria; i prodotti nella promozione a pagamento per ordine con prezzo, offerta, indice di visibilità e visualizzazioni; visualizzazioni, clic, spesa, ordini e valore degli ordini per campagna e giorno, la spesa divisa tra conto prepagato e bonus, i totali di periodo delle campagne a clic, e i report dettagliati per prodotto e sulle frasi di ricerca.

Disattivati all'installazione: ozon_performance_activate_campaign e ozon_performance_remove_campaign_products. Il primo avvia una campagna, che da quel momento mostra annunci e spende il suo budget; il secondo rimuove prodotti da una campagna a clic, e le loro offerte vanno perse. Attiva nella pagina del connettore solo quelli che ti servono; l'AI ti chiede conferma prima di ogni modifica. ozon_performance_deactivate_campaign, ozon_performance_add_campaign_products e ozon_performance_update_campaign_bids sono attivi: fermano una campagna, aggiungono prodotti a una campagna a clic e ne cambiano le offerte, e quindi la spesa, sempre dopo che l'AI ti ha mostrato esattamente cosa cambia.

Non incluso: creare e copiare campagne, budget e strategie, modifiche alle offerte a pagamento per ordine, statistiche di banner e video, report di attribuzione degli ordini e analisi del traffico esterno.

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 Add e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: Ozon Performance (Ads).
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 delle mie campagne pubblicitarie su Ozon sono attive in questo momento, e qual è il loro budget giornaliero?"
• "Quanto ha speso ogni campagna al giorno la settimana scorsa, e quanto di questo è stato pagato con i bonus?"
• "Confronta le offerte attuali della mia campagna pay-per-click con le offerte della concorrenza per gli stessi SKU."
• "Ordina un report dettagliato per prodotto delle mie campagne a clic per ottobre, raggruppato per settimana, e riassumilo."
• "Quali prodotti nella promozione a pagamento per ordine hanno l'offerta più alta in percentuale sul prezzo, e quante visualizzazioni hanno avuto questa settimana?"

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