Come collegare Avito a Cursor via MCP

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

Avito + Cursor

Fai lavorare la tua AI con il tuo account business Avito: elenca gli annunci e cambiane i prezzi, leggi le statistiche di visualizzazioni, contatti e chiamate, controlla i caricamenti autoload e i loro errori, il formato del feed e il tuo portafoglio, e leggi le chat di Avito Messenger. Inviare messaggi e cambiare le impostazioni autoload sono opzionali e disattivati di default.

Prerequisiti

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

AVITO_CLIENT_ID, AVITO_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti e ti serve un account business Avito con le sue credenziali API. Non c'è nessun accesso dal browser.

1. Accedi ad Avito con l'account business con cui deve lavorare l'AI: l'account principale dell'azienda, non quello di un dipendente.
2. Apri Для профессионалов, poi API интеграции (avito.ru/professionals/api), e copia Client ID e Client secret. Avito rilascia una sola coppia per account, e generare un nuovo secret rende inutilizzabile il precedente.
3. Incollali in AVITO_CLIENT_ID e AVITO_CLIENT_SECRET e installa. AnythingMCP ottiene da solo il token di accesso da Avito e lo rinnova ogni 24 ore.
4. Esegui avito_get_self: mostra nome, email e user id dell'account. Quell'id è lo user_id che serve agli altri strumenti, e l'AI lo riusa per tutta la conversazione.

Cosa ottieni dipende dalla tariffa Avito: l'API può fare ciò che l'account stesso può fare. La Messenger API c'è solo con la tariffa Максимальный (Massima) per beni e lavoro, e con Расширенный (Estesa) o Максимальный per i servizi; senza, gli strumenti delle chat rispondono 403. Gli strumenti autoload richiedono che l'autoload sia configurato nell'account.

Cosa legge: l'account e il portafoglio (denaro reale e bonus, in rubli) con gli addebiti per pubblicazioni e promozione; i tuoi annunci con titolo, prezzo, stato, categoria, indirizzo e i servizi a pagamento applicati (vip, highlight, pushup, premium, xl) con la loro scadenza; visualizzazioni uniche, contatti e preferiti di fino a 200 annunci alla volta e fino a 270 giorni indietro; le chiamate per annuncio e per giorno; le impostazioni autoload, ogni caricamento con errori e avvisi di ciascun annuncio; i campi del feed di ogni categoria; e le chat e i messaggi di Avito Messenger. Gli annunci dei sottoaccount dei dipendenti non vengono elencati, e leggere una chat non la segna come letta.

Due id per annuncio: l'id Avito è il numero nell'URL dell'annuncio, e un annuncio che arriva da un feed autoload ha anche il proprio Id del feed. L'AI traduce dall'uno all'altro, quindi puoi indicare un annuncio con uno qualsiasi dei due.

Chiede prima di ogni modifica: avito_update_item_price cambia il prezzo di un annuncio, in rubli interi (beni, ricambi, auto e immobili, non affitti brevi). Il nuovo prezzo è subito pubblico, quindi l'AI ti indica prima l'annuncio, il prezzo vecchio e quello nuovo e aspetta il tuo sì. Se l'annuncio viene da un feed autoload, il caricamento successivo può riportare il prezzo del feed: cambialo anche lì.

Disattivati all'installazione: avito_send_message (scrive a un acquirente a nome dell'account, al massimo 1.000 caratteri, e qui non si può annullare), avito_mark_chat_read (il badge dei non letti sparisce e i colleghi rischiano di perdere il messaggio), avito_update_autoload_profile (sostituisce l'intero profilo autoload) e avito_start_autoload_upload (pubblica subito tutti gli annunci del feed, ignorando i limiti della programmazione, il che può costare commissioni di pubblicazione, ed è possibile al massimo una volta all'ora). Un amministratore li attiva consapevolmente, e anche allora l'AI ti mostra il testo o la modifica esatta e aspetta la tua conferma.

Dati degli acquirenti: le chat contengono nomi e messaggi degli acquirenti. L'AI li usa solo per rispondere a quegli acquirenti e non scrive mai a chi non ha scritto per primo.

Orari e lingua: Avito lavora con l'ora di Mosca (UTC+3) e l'AI converte gli orari prima di indicarteli. I messaggi di Avito sono in russo; l'AI li traduce per te.

Limiti: elencare annunci al massimo 25 richieste al minuto, cambi di prezzo 150 al minuto, lettura di un singolo annuncio 500 al minuto. Lo storico del portafoglio copre al massimo una settimana per richiesta e arriva a un anno indietro. Dopo un 429 l'AI aspetta un minuto.

Errori comuni: 401 Bad bearer token o 403 invalid access token significa che Client ID o secret sono sbagliati, oppure che un secret appena generato ha sostituito quello vecchio. Qualsiasi altro 403 significa che la tariffa non include quella API (soprattutto Messenger). 404 significa che annuncio, chat o caricamento non esistono o appartengono a un altro account; i report autoload rispondono 404 anche finché non c'è ancora nessun caricamento. 400 significa che un parametro è sbagliato, per esempio un prezzo in una categoria dove qui non si può cambiare, o un intervallo del portafoglio più lungo di una settimana.

Il connettore non copre i servizi di promozione e i loro prezzi, le campagne pubblicitarie, CPA e call tracking, consegne e ordini, valutazioni e recensioni, Avito Jobs, affitti brevi, account dei dipendenti, webhook e invio di immagini o messaggi vocali, e non crea né modifica il contenuto degli annunci: quello passa dal tuo feed autoload.

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 Avito.

Tool disponibili

Esempi di prompt

• "Quali dei miei annunci attivi hanno avuto più visualizzazioni e contatti negli ultimi 30 giorni, e quali nessuno?"
• "Abbassa il prezzo del mio annuncio iPhone 13 128 GB a 42.000 rubli. Prima mostrami il prezzo vecchio e quello nuovo."
• "L'ultimo caricamento autoload ha avuto errori? Elencami gli annunci con errori e dimmi cosa correggere nel feed."
• "Quali chat di Avito Messenger non sono ancora lette, e cosa chiedono gli acquirenti?"
• "Quanto mi è stato addebitato sul portafoglio Avito la settimana scorsa e per cosa, e qual è il saldo adesso?"

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