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.
Questo è l'indirizzo da inserire nel 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.
Apri Personalizza → Connettori.
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
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.
Apri Plugin, premi + Aggiungi e scegli Aggiungi un server MCP personalizzato.
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.
Installa il plugin, completa l'accesso su Sellengine confermando con Autorizza e richiamalo in chat.
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
Avvia una sessione di Claude Code, digita /mcp e scegli Sellengine per autenticarti: si apre il browser sulla pagina di accesso di Sellengine.
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"
}
}
}
Riavvia Cursor e, quando richiesto, completa l'accesso su Sellengine.
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"
}
}
}
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.
Alcuni esempi da cui partire:
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. |
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.
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 |