> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Connetti il tuo client IA con Aftersell MCP
> Connetti un client IA come Claude Desktop agli analytics Aftersell del tuo negozio usando il server MCP di Aftersell (Model Context Protocol).
MCP (Model Context Protocol) è uno standard aperto che consente a un client IA di leggere dati da strumenti esterni. Aftersell ospita un server MCP che dà al tuo client IA accesso in sola lettura agli analytics Aftersell del tuo negozio.
La pagina di connessione self-service ti permette di collegare un client IA — come Claude Desktop — agli analytics Aftersell del tuo negozio. Una volta connesso, puoi fare al tuo client IA domande sulle prestazioni degli upsell del tuo negozio, sui risultati dei funnel e altro ancora, direttamente in linguaggio naturale.
La connessione è in sola lettura: il tuo client IA può leggere i dati degli analytics Aftersell ma non può effettuare ordini né modificare alcuna impostazione. I campi cliente identificabili personalmente sono bloccati.
## Cosa puoi chiedere
Una volta connesso, puoi fare al tuo client IA domande come:
* Quanti ricavi extra hanno generato i miei upsell la settimana scorsa?
* Come mi posiziono rispetto a negozi simili nelle prestazioni post-acquisto?
* Come stanno andando i miei funnel questa settimana?
* Analizza le risposte alle mie offerte: quante sono state accettate, rifiutate o scadute?
* Perché le mie offerte post-acquisto non vengono mostrate a più acquirenti?
* Quali prodotti in upsell hanno generato più ricavi il mese scorso?
* Quale dei miei funnel attivi sta rendendo meno in termini di conversioni?
* Quanti ordini ha ricevuto il mio negozio ogni giorno questo mese, e qual è stato il mio valore medio dell'ordine?
* Confronta il mio step di offerta principale con la seconda offerta e il downsell: quale converte meglio?
* Il mio tasso di conversione degli upsell è in crescita o in calo ultimamente?
* Quante persone hanno visto le mie offerte post-acquisto ogni giorno nelle ultime due settimane?
* Come si confronta il mio ricavo per visitatore con quello di negozi simili?
* Traccia l'ordine #1234: l'acquirente ha visto un'offerta?
## Connettere il tuo client IA
La pagina di connessione si apre con **Choose your AI client**, un selettore che offre **Claude Desktop**, **Claude Code**, **Codex App** e **Codex CLI**. I passaggi sotto di esso cambiano in base alla tua scelta: Claude Desktop e Codex App ti forniscono un connector URL da incollare nelle impostazioni del client, mentre Claude Code e Codex CLI ti danno un singolo comando da terminale da copiare.
La procedura qui sotto è per Claude Desktop.
1. Nella pagina di connessione, scegli **Claude Desktop**. Un connect code monouso viene generato automaticamente per te e mostrato sotto il passaggio 3, **Enter the connect code** — non devi cliccare nulla per ottenerne uno. Scade **6 ore** dopo la generazione; **Regenerate** te ne fornisce uno nuovo, e appare invece **Generate** se al momento non è mostrato alcun codice.
2. Copia il **Remote MCP server URL** dal passaggio 2, **Add the connector to Claude Desktop**. Viene mostrato indipendentemente dal fatto che un codice sia stato generato o meno.
3. In Claude Desktop, apri **Settings**, poi **Connectors**.
4. Scegli **Add custom connector** e incolla l'URL.
5. Clicca su **Connect**. Claude ti chiederà un connect code.
6. Inserisci il connect code del passaggio 1.
7. Un numero di verifica appare sia in Claude sia nel tuo pannello di amministrazione Aftersell. Seleziona il numero corrispondente nel tuo pannello per approvare la connessione.
Una volta approvata, il tuo stato passa a **Connected** e puoi iniziare a fare domande.
## Connettere un secondo negozio
La tua connessione MCP è legata al tuo indirizzo email, non a un singolo negozio. Una volta configurata una connessione, puoi collegare negozi aggiuntivi senza rifare l'intera configurazione.
Per collegare un altro negozio:
1. Apri la pagina di connessione dal pannello di amministrazione Aftersell di quel negozio.
2. La pagina mostra una sezione **Store data access** con un pulsante **Link store**.
3. Clicca su **Link store**. Il negozio viene collegato immediatamente — nessun connect code o approvazione necessari.
Una volta collegato, il tuo client IA può leggere i dati Aftersell di quel negozio attraverso la stessa connessione. Se hai più di un negozio collegato, specifica al tuo client IA di quale negozio stai chiedendo.
## Le due sezioni della pagina di connessione
La pagina di connessione ha due sezioni indipendenti:
* **MCP connection** — lo stato della connessione del tuo client IA ad Aftersell MCP. È globale per email: una connessione raggiunge tutti i negozi che hai collegato.
* **Store data access** — indica se i dati di questo specifico negozio sono accessibili tramite la tua connessione.
La sezione store data access appare solo quando la tua connessione MCP è attiva.
## Stati della connessione
### MCP connection
| Stato | Significato |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Not connected** | Nessuna connessione MCP attiva. Segui i passaggi di configurazione per connetterti. |
| **Awaiting your approval** | Hai inserito il connect code nel tuo client IA. Seleziona il numero di verifica corrispondente nel tuo pannello per approvare. |
| **Connecting…** | La tua approvazione è stata inviata. Il client IA sta completando la connessione. Di solito richiede pochi secondi. |
| **Connected** | Il tuo client IA è connesso e può leggere i tuoi analytics Aftersell. |
Se il tuo connect code o un'approvazione in sospeso scadono prima che la connessione venga completata, lo stato rimane **Not connected** — non esiste uno stato di scadenza separato. Genera un nuovo codice e ripeti i passaggi.
### Store data access
A differenza della sezione MCP connection qui sopra, questa sezione mostra un badge di stato in un solo caso — **Expired**. Gli altri stati vengono mostrati in modi diversi:
| Stato | Cosa appare | Significato |
| ------------------ | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Linked** | Un pulsante **Linked** con un segno di spunta — nessun badge | I dati di questo negozio sono accessibili tramite la tua connessione MCP. |
| **Expired** | Un badge **Expired** e un pulsante **Link store** | L'accesso di questo negozio è scaduto dopo 30 giorni di inutilizzo. Clicca su **Link store** per ripristinarlo. |
| **Not yet linked** | Nessun badge — solo la descrizione della sezione e un pulsante **Link store** | La tua connessione esiste ma questo negozio non è ancora stato collegato. |
| **Access removed** | Nessun badge — un banner di avviso | Il proprietario del negozio o un membro dello staff ha rimosso l'accesso di questo negozio. Chiedigli di ripristinarlo. |
## Disconnettersi
Per disconnettere il tuo client IA da Aftersell MCP, clicca su **Disconnect** nella pagina di connessione e conferma. Questo disconnette immediatamente il tuo client IA da tutti i negozi. I record di accesso ai negozi vengono conservati, così puoi riconnetterti in qualsiasi momento ripetendo i passaggi di configurazione.
## Chi può connettersi
I proprietari del negozio, i membri dello staff e i collaboratori possono tutti connettersi autonomamente. I collaboratori si connettono e collegano i negozi per il proprio indirizzo email, limitatamente al negozio per cui hanno una sessione.
La gestione dell'accesso MCP di altre persone — concedere, approvare o revocare l'accesso per altri — è riservata ai proprietari del negozio e ai membri dello staff.
Anche la gestione degli accessi viene distribuita separatamente dalla connessione self-service, quindi la schermata di gestione potrebbe non essere ancora disponibile sul tuo negozio anche se puoi connettere il tuo client IA. Contatta il team di assistenza clienti se ne hai bisogno.
## Domande frequenti
**Cos'è un MCP?** MCP (Model Context Protocol) è uno standard aperto che consente a un client IA di connettersi a strumenti e dati esterni. Questo connettore lo usa per dare al tuo client IA accesso in sola lettura agli analytics Aftersell del tuo negozio.
**A cosa può accedere l'IA?** Solo agli analytics Aftersell del tuo negozio. Aftersell non detiene una copia completa dei dati del tuo negozio, quindi l'IA non può vedere tutto ciò che c'è in Shopify — solo gli analytics di cui dispone Aftersell, limitati a questo negozio. È in sola lettura e i campi cliente identificabili personalmente sono bloccati.
**La mia IA mi chiede di approvare chiamate agli strumenti. Cosa significa?** I client IA chiedono la tua approvazione prima di eseguire uno strumento, così mantieni il controllo su ciò che fanno. Quando la tua IA vuole leggere i tuoi dati Aftersell, chiede di chiamare gli strumenti di questo connettore. Approvali per permetterle di rispondere. È in sola lettura, quindi approvare consente all'IA solo di leggere i tuoi analytics; non può effettuare ordini né modificare nulla nel tuo negozio.
**I miei dati sono al sicuro?** Sì. Il connettore è in sola lettura e limitato ai soli analytics Aftersell del tuo negozio. Il passaggio del numero di verifica durante la configurazione garantisce che solo tu possa approvare una connessione.
**Come connetto un altro negozio?** Apri la pagina di connessione dal pannello di amministrazione Aftersell di ciascun negozio e clicca su **Link store** per dare accesso alla tua connessione. La tua connessione MCP raggiunge tutti i negozi che hai collegato, quindi quando ne hai più di uno, specifica al tuo client IA di quale negozio stai chiedendo.
**Il mio connect code è scaduto. Cosa faccio?** Genera un nuovo codice su questa pagina e usa quello. Ogni nuovo codice sostituisce il precedente non utilizzato.
**Come interrompo l'accesso dell'IA?** Clicca su **Disconnect** su questa pagina per disconnettere subito il tuo client IA da Aftersell MCP. Puoi riconnetterti in qualsiasi momento ripetendo i passaggi di configurazione.
**Posso avere più client IA connessi?** Ogni connect code è monouso. Per connettere un secondo dispositivo o client, genera un nuovo connect code e ripeti i passaggi di configurazione.