Come collegare Veepee Pink Connect a Cursor via MCP

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

Veepee Pink Connect + Cursor

Vendi su Veepee e Privalia tramite Pink Connect da un agente AI: ordini con righe, indirizzi, tracking e rimborsi, offerte per canale di vendita, messaggi dei clienti, richieste di reso e corrieri. Risposte, nuovi messaggi sugli ordini e cambi di stato dei resi sono inclusi, disattivati all'installazione.

Prerequisiti

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

PINK_CONNECT_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti, una volta che hai il token. Ti serve un account venditore su Veepee o Privalia gestito tramite Pink Connect, l'API per i venditori dei marketplace del gruppo Veepee.

1. Procurati il token API del tuo account venditore Pink Connect. Lo trovi nel portale Pink Connect su www.pink-connect.com, oppure te lo invia il tuo referente marketplace di Veepee.
2. Incollalo in PINK_CONNECT_TOKEN, da solo, senza la parola Bearer, virgolette o spazi.
3. Installa il connettore ed esegui pink_connect_list_carriers: elenca i circa 200 corrieri che Pink Connect conosce e conferma che il token funziona.

Canali di vendita: ogni sito nazionale di un marketplace è un canale con un proprio numero, per esempio uno per Veepee Italia e uno per Privalia Italia. Ogni ordine riporta il suo canale, quindi l'AI ricava prima gli id dei canali dai tuoi ordini. Le offerte si elencano sempre per un canale alla volta.

Cosa legge: gli ordini con stato, date, totali e valuta, indirizzo di spedizione e di fatturazione, righe d'ordine (GTIN, SKU, prezzo, aliquota IVA, quantità e stato di ogni riga), dettagli di consegna con corriere, numero e link di tracking, rimborsi e metodo di spedizione richiesto; le tue offerte per canale con nome, marca, prezzo di vendita e consigliato, sconto con le sue date, stock, listino e stato sul marketplace; i messaggi dei clienti con oggetto, testo, mittente, stato di lettura e allegati; le richieste di reso con riga d'ordine, quantità, motivo (per esempio PRODUCT_DAMAGED o SIZE_DONT_FIT), tipo come HOMEPICKUP e stato; e l'elenco dei corrieri.

Come risponde Pink Connect: gli ordini arrivano dal più vecchio, quindi per quelli recenti l'AI chiede sempre gli ordini modificati da una certa data, fino a 100 per pagina. Un singolo ordine si legge con l'id d'ordine Pink Connect, che non è il numero d'ordine del marketplace; per trovare un ordine dal numero di Veepee o Privalia, l'AI cerca con il marketplace e il suo numero d'ordine insieme. Senza un filtro per ordine o data, i messaggi dei clienti costringono Pink Connect a scorrere tutto lo storico, e possono servire trenta secondi, perciò l'AI ne passa sempre uno. Gli stati delle offerte sono in spagnolo, per esempio "Producto Publicado".

Solo lettura all'installazione: tutti gli strumenti attivi dopo l'installazione si limitano a leggere. Nessuno strumento muove denaro: cambiare lo stato di un reso non rimborsa, e i rimborsi si gestiscono fuori da questo connettore.

Disattivati all'installazione: pink_connect_reply_notification risponde a un messaggio del cliente, pink_connect_create_order_message apre una nuova conversazione su un ordine che non ne ha ancora una, e pink_connect_update_return_request sposta un reso da PENDING a PROCESSING (accettato) o REJECTED, oppure da PROCESSING a COMPLETE (merce ricevuta). Raggiungono clienti veri, quindi un amministratore li attiva consapevolmente. Anche allora l'AI ti mostra l'ordine, il messaggio esatto nella lingua del cliente o il reso con il nuovo stato, e aspetta il tuo sì.

Limiti: Pink Connect restituisce al massimo 100 ordini o richieste di reso per chiamata, e un ordine pesa circa 2 KB, quindi l'AI tiene le pagine piccole e filtra per data o canale invece di leggere tutto.

Errori comuni: 401 significa che il token è sbagliato o scaduto: chiedine uno nuovo a Veepee. 400 "Invalid page size (max 100)" indica una pagina con più di 100 elementi. I messaggi 422 sono in spagnolo e indicano il problema, per esempio "Canal de Venta no puede estar vacío" quando manca l'id del canale. Un id sconosciuto risponde con una pagina HTML 404.

Il connettore non modifica offerte, prezzi o stock, non conferma spedizioni né carica numeri di tracking, non annulla ordini e non emette rimborsi.

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 Veepee Pink Connect.

Tool disponibili

Esempi di prompt

• "Quali ordini di Veepee e Privalia sono arrivati da lunedì, e quali non sono ancora stati spediti?"
• "Mostrami i messaggi dei clienti non letti degli ultimi 7 giorni e a quale ordine si riferisce ciascuno."
• "Quali richieste di reso sono ancora in attesa, e quali motivi hanno indicato i clienti?"
• "Elenca le mie offerte su Privalia Italia con meno di 5 pezzi in magazzino."
• "Trova l'ordine Veepee 87654321 e dimmi il corriere e il link di tracking."

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