Ozon Performance MCP: collegare a Microsoft Copilot

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

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 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 Ozon Performance (Ads).
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

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

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

• Landing del connettore
• Collegare a Claude