Assistenti AI (MCP)

Assistenti AI (MCP)

Collega il tuo assistente AI a Sellengine e fai domande in linguaggio naturale su ordini, spedizioni, prodotti, offerte e canali di vendita, o su come configurare e usare Sellengine.

L'accesso è in sola lettura, riguarda solo i dati del tuo account e puoi revocarlo in qualsiasi momento.

Passo 1 — Indirizzo del server

Questo è l'indirizzo da inserire nel tuo assistente:

Passo 2 — Collega il tuo assistente

Scegli il tuo assistente. In tutti i casi, al primo collegamento si apre una pagina di Sellengine: accedi con le tue credenziali e conferma con Autorizza.

Funziona su claude.ai e nell'app desktop, anche con il piano gratuito (limitato a un connettore personalizzato). Nei piani Team ed Enterprise il connettore lo aggiunge un owner dell'organizzazione; poi ogni membro lo trova in Personalizza → Connettori e lo collega con il proprio account Sellengine premendo Connetti.

  1. Apri Personalizza → Connettori.

  2. Premi + e scegli Aggiungi connettore personalizzato, dai un nome (per esempio Sellengine) e come URL del server incolla l'indirizzo del Passo 1: https://api.sellengine.it/mcp

  3. Premi Connetti: si apre la pagina di accesso di Sellengine, dove confermi con Autorizza.

Funziona da ChatGPT sul web. Negli spazi di lavoro aziendali (Business, Enterprise, Edu) creare il plugin può richiedere il permesso di un amministratore.

  1. Apri Plugin, premi + Aggiungi e scegli Aggiungi un server MCP personalizzato.

  2. Inserisci un nome e, come URL del server, l'indirizzo del Passo 1: https://api.sellengine.it/mcp. Come autenticazione scegli OAuth, poi conferma l'avviso sui rischi e crea il plugin.

  3. Installa il plugin, completa l'accesso su Sellengine confermando con Autorizza e richiamalo in chat.

  1. Richiede un piano Claude a pagamento (Pro o superiore). Da terminale, nella cartella in cui lavori:

    claude mcp add --transport http sellengine https://api.sellengine.it/mcp
  2. Avvia una sessione di Claude Code, digita /mcp e scegli Sellengine per autenticarti: si apre il browser sulla pagina di accesso di Sellengine.

  1. Aggiungi il server al file .cursor/mcp.json del progetto, oppure a ~/.cursor/mcp.json per usarlo ovunque:

    {
        "mcpServers": {
            "sellengine": {
                "url": "https://api.sellengine.it/mcp"
            }
        }
    }
  2. Riavvia Cursor e, quando richiesto, completa l'accesso su Sellengine.

  1. Basta anche il piano gratuito di GitHub Copilot. Aggiungi il server al file .vscode/mcp.json del progetto:

    {
        "servers": {
            "sellengine": {
                "type": "http",
                "url": "https://api.sellengine.it/mcp"
            }
        }
    }
  2. Avvia il server dalla vista MCP di VS Code, completa l'accesso su Sellengine e usa Copilot Chat in modalità Agente.

I nomi dei menu possono cambiare leggermente in base alla versione o al piano del tuo assistente.

Passo 3 — Cosa puoi chiedere

Alcuni esempi da cui partire:

  • «Quali ordini sono ancora da spedire?»
  • «Mostrami gli ordini Amazon arrivati ieri.»
  • «Dammi il dettaglio dell'ordine 402-1234567-1234567.»
  • «A che punto è la spedizione con tracking 161063010520535?»
  • «Quali spedizioni sono ferme in giacenza?»
  • «Quanti pezzi ho in magazzino dello SKU SEDIA-BLU?»
  • «Quali offerte attive sono esaurite?»
  • «Che prezzo ha lo SKU SEDIA-BLU su Amazon?»
  • «Quali canali di vendita sono attivi?»
  • «Quali sono i 10 articoli più venduti nell'ultimo mese?»
  • «Come collego il corriere BRT?»

Strumenti disponibili

L'assistente risponde alle tue domande usando questi strumenti. Non devi richiamarli tu: sceglie da solo quale usare, e conoscerne i limiti aiuta a formulare le richieste.

Strumento Cosa fa Limiti
get-current-account Indica di quale account sono i dati letti. Nessuno.
list-channels Elenca i canali di vendita attivi, con tipo, nazione e ultima sincronizzazione. Solo i canali attivi.
search-orders Cerca gli ordini per stato, stato della spedizione, stato interno, canale e data di acquisto; a richiesta include le righe di ogni ordine. 20 ordini per volta, fino a 50 (20 se include le righe); per vederne altri l'assistente chiede la pagina successiva. Senza date cerca su tutto lo storico, dal più recente. La prima pagina riporta anche il totale, così per contarli non serve scorrerli tutti.
get-order Dettaglio di un ordine: righe, quantità spedite e spedizioni collegate con il tracking. Cerca per riferimento del canale o numero d'ordine; se più ordini corrispondono propone fino a 5 candidati.
search-shipments Cerca le spedizioni per codice di tracking, stato, corriere o data di spedizione, con gli ordini contenuti e il costo di spedizione voce per voce. 20 spedizioni per volta, fino a 50; per vederne altre l'assistente chiede la pagina successiva. Dalla più recente, con in fondo quelle non ancora spedite. Le spedizioni cancellate sono escluse. La prima pagina riporta anche il totale, così per contarle non serve scorrerle tutte.
get-product Dettaglio di un prodotto: giacenza totale e per magazzino e offerte sui canali. Serve lo SKU esatto.
search-offers Cerca le offerte sui canali per canale, stato, pubblicazione, fulfillment, SKU, testo nel titolo o esaurimento. 20 offerte per volta, fino a 50; per vederne altre l'assistente chiede la pagina successiva. Dalla modificata più di recente: un'offerta modificata mentre l'assistente scorre le pagine torna in cima e può non comparire. La ricerca nel titolo richiede almeno 3 caratteri. La prima pagina riporta anche il totale, così per contarle non serve scorrerle tutte.
get-offer Dettaglio di un'offerta: prezzo, quantità, IVA, pesi, listino di spedizione, EAN, tag e categorie. Cerca per identificativo della piattaforma (per esempio l'ASIN) o per SKU; se più offerte corrispondono propone fino a 5 candidati.
top-selling-products Classifica degli articoli più venduti per quantità o numero di ordini, con il fatturato. Senza date considera gli ultimi 30 giorni; i primi 10 articoli, fino a 50. Il fatturato è lordo, IVA inclusa, per valuta: non tiene conto di sconti sull'ordine e rimborsi parziali. Esclude gli ordini annullati o rimborsati.
list-documentation Elenca le pagine della guida di Sellengine (canali, corrieri, ordini, offerte, CMS) con un breve riassunto, per trovare quella giusta. Non legge i dati del tuo account. In italiano o in inglese.
get-documentation Legge una pagina della guida, per rispondere a domande come «come collego BRT?», con il link alla pagina sul sito. Riporta i contenuti di questa documentazione: gli aggiornamenti arrivano entro un'ora dalla pubblicazione.
ping-tool Verifica che il collegamento funzioni. Non legge dati.

Perché questi limiti

  • Risposte compatte: un assistente ragiona meglio, e consuma meno, su poche decine di risultati alla volta. Per questo le ricerche restituiscono al massimo 50 elementi e, quando ce ne sono altri, l'assistente li chiede pagina per pagina.
  • Totali e classifiche calcolati da Sellengine: sommare a mano centinaia di ordini porta facilmente a errori. Le classifiche di vendita sono calcolate direttamente nel database e restituite già pronte.
  • Privacy dei tuoi clienti: non si può cercare per nome, email o indirizzo del cliente, perché questi dati non vengono mai condivisi con l'assistente.
  • Sola lettura: nessuno strumento modifica i dati, quindi una richiesta fraintesa non può cambiare ordini, offerte o giacenze.
  • Prestazioni del tuo account: ogni connessione può fare fino a 120 richieste al minuto, così l'uso dell'assistente non rallenta Sellengine.
  • Le date sono nel fuso orario italiano (Europe/Rome, con l'ora legale): un giorno va da mezzanotte a mezzanotte ora italiana, anche per gli ordini dei canali esteri. Per periodi precisi indica sempre il giorno di inizio e di fine.

Gestire le connessioni

In Account → Connessioni trovi gli assistenti collegati, con la data dell'ultima attività. Da lì puoi revocare l'accesso in qualsiasi momento.

Una connessione resta attiva finché viene usata almeno una volta ogni 30 giorni; dopo un periodo più lungo di inattività l'assistente ti chiederà di autorizzarlo di nuovo.

Sicurezza e privacy

  • L'accesso è in sola lettura: l'assistente non può modificare ordini, spedizioni, prodotti o offerte.
  • Ogni assistente vede solo i dati del tuo account, ed è il tuo accesso a Sellengine, non l'assistente, a stabilire cosa può leggere.
  • I dati personali dei tuoi clienti (nome, indirizzo, telefono, email, dati di fatturazione) non vengono mai condivisi: degli ordini sono visibili solo città, CAP e nazione di destinazione.
  • Le informazioni lette vengono inviate al fornitore del tuo assistente (per esempio Anthropic o OpenAI) e trattate secondo i suoi termini di servizio.

Problemi frequenti

  • L'assistente non vede le funzioni nuove: apri una nuova conversazione oppure scollega e ricollega il connettore.
  • Errore di autorizzazione: scollega e ricollega il connettore, poi ripeti l'accesso su Sellengine.
  • Messaggio «Nessun tenant configurato»: il tuo account non è ancora abilitato, contatta il supporto Sellengine.

Dettagli tecnici

Per chi integra un client MCP:

Indirizzo del server (endpoint MCP) https://api.sellengine.it/mcp
Authorization server https://app.sellengine.it
Trasporto Streamable HTTP
Autenticazione OAuth 2.1 con PKCE (S256) e registrazione dinamica del client
Scope mcp:use
Elaborazione...