Come collegare MPSTATS a Cursor via MCP

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

MPSTATS + Cursor

Analisi di marketplace MPSTATS per Wildberries e Ozon: vendite e fatturato stimati, prezzi e stock per magazzino e taglia di qualsiasi articolo, query di ricerca e posizioni, concorrenti di un articolo, e dati e trend di nicchie, categorie, marchi e venditori. Solo lettura.

Prerequisiti

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

MPSTATS_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account MPSTATS con un piano che includa le richieste API.

1. Accedi su https://mpstats.io, apri le impostazioni dell'account e copia il token dal blocco API token in MPSTATS_API_TOKEN.
2. Installa il connettore ed esegui mpstats_wb_get_keyword_frequency con una query come джинсы: restituisce una serie settimanale e conferma il token.

Il token viene inviato nell'header X-Mpstats-TOKEN. Cambia quando si cambia la password dell'account o si preme Change API token; in quel caso incolla quello nuovo.

Dati di mercato, non il tuo account venditore: MPSTATS raccoglie dati pubblici da Wildberries e Ozon, quindi il connettore legge qualsiasi articolo, nicchia, categoria, marchio o venditore, tuo o di un concorrente. Non accede al tuo account venditore: per ordini, finanze e stock usa il connettore Wildberries o Ozon.

Identificativi: gli articoli sono SKU del marketplace, il numero articolo Wildberries (nmId) o lo SKU Ozon. Se hai solo un nome, l'AI lo risolve prima con mpstats_wb_find_items o mpstats_oz_find_items (SKU o parola chiave), mpstats_wb_search_subjects, mpstats_oz_search_niches, mpstats_wb_search_sellers, mpstats_oz_search_sellers o mpstats_wb_search_brands. I subject Wildberries e le nicchie e i venditori Ozon hanno id numerici; le categorie sono percorsi completi con /, esattamente come li mostra MPSTATS (per esempio Женщинам/Джинсы); i marchi sono nomi.

Cosa legge su Wildberries:

• Un articolo: la scheda completa (marchio, venditore, valutazione, stock FBO e FBS, ordini, prezzo e sconto, taglie, foto, data di prima comparsa); una riga al giorno con vendite, fatturato stimato, stock, prezzo e sconti, valutazione, commenti, posizione media in categoria e visibilità, facoltativamente con posizioni di ricerca e traffico; un riepilogo di ricerca confrontato con il periodo precedente (numero di query, posizione media organica e pubblicitaria, visibilità, traffico stimato); le query di ricerca per cui si posiziona, con frequenza e posizione organica e pubblicitaria per giorno; stock e vendite per magazzino e per taglia, per individuare le taglie esaurite.
• Concorrenti di un articolo: ciò che Wildberries mostra come simile nella pagina dell'articolo, gli articoli il cui blocco dei simili mostra questo SKU, gli articoli che Wildberries segna come identici e gli articoli simili abbinati da MPSTATS, ciascuno con vendite, fatturato, prezzo e stock.
• Nicchie (subject) e categorie: i loro articoli con vendite, fatturato, prezzo, stock, valutazione e posizione; una suddivisione per sottocategorie, subject, marchi o venditori; e i dati di mercato per giorno, settimana, mese o trimestre (vendite, fatturato, prezzo medio, stock, articoli, marchi e venditori con vendite) per trend e stagionalità.
• Venditori e marchi: i loro articoli con vendite, fatturato, prezzo e stock. La ricerca dei venditori restituisce anche l'INN.
• Domanda di ricerca: quanto spesso una query viene cercata su Wildberries, come serie settimanale.

Cosa legge su Ozon: ricerca degli articoli e scheda completa; vendite, fatturato, stock, prezzo, valutazione e commenti per giorno; query di ricerca con frequenza e posizioni; posizioni in ogni categoria per giorno; stock per magazzino in un giorno (FBO, facoltativamente FBS); vendite per magazzino; articoli simili abbinati da MPSTATS. Nicchie e i loro articoli; categorie con i loro articoli, una suddivisione per sottocategorie, nicchie, marchi o venditori e il trend per giorno, settimana, mese o trimestre; venditori (con OGRN) e marchi con i loro articoli.

Periodi e cifre: d1 e d2 sono YYYY-MM-DD, e l'AI li passa sempre perché il periodo predefinito cambia da metodo a metodo. I dati arrivano fino a ieri. Vendite e fatturato sono stime di MPSTATS da dati pubblici del marketplace, in rubli; trattali come stime, non come la contabilità del venditore. fbs=1 aggiunge le vendite spedite dal magazzino del venditore (FBS), 0 conta solo i magazzini del marketplace (FBO).

Paginazione, ordinamento e filtri: gli strumenti di elenco restituiscono startRow, endRow, total e data, al massimo 500 righe per chiamata; l'AI pagina spostando startRow ed endRow. sortModel ordina, per esempio [{"colId": "revenue", "sort": "desc"}], e filterModel filtra le colonne, per esempio fatturato maggiore di 100.000 (filtri di testo: equals, contains, startsWith; filtri numerici e di data: lessThan, greaterThan, inRange).

Solo lettura: ogni strumento legge soltanto, quindi non c'è nulla da confermare e nessuno strumento è disattivato all'installazione.

Costi e limiti: ogni chiamata conta sulla quota di richieste del tuo piano MPSTATS, compresa quella di prova. L'AI tiene i periodi brevi e le pagine piccole, e riusa ciò che ha già scaricato invece di richiamare.

Errori comuni: 401 indica un token errato o cambiato. 429 che la quota di richieste del piano è esaurita; il messaggio dice perché e Retry-After quando riprovare. 202 che MPSTATS sta ancora preparando il report: richiama poco dopo. 500 riporta il motivo in message.

Il connettore non modifica nulla su Wildberries o Ozon: non cambia schede, prezzi o pubblicità e non legge i tuoi ordini, pagamenti o report del venditore.

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di MPSTATS.

Tool disponibili

Esempi di prompt

• "Quanti pezzi ha venduto al giorno l'articolo Wildberries 123456789 negli ultimi 30 giorni, e quando è andato esaurito?"
• "Quali taglie di questo articolo Wildberries sono esaurite, e in quali magazzini resta stock?"
• "Mostra i 20 articoli con più fatturato nella nicchia Wildberries "Джинсы" il mese scorso, con prezzo e venditore."
• "Per quali query di ricerca si posiziona lo SKU Ozon 987654321, e in che posizioni?"
• "Mostra il fatturato mensile della categoria Wildberries Женщинам/Платья nell'ultimo anno: quando è la stagione?"

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

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