Collega Shoptet ad AmICited per analizzare in un unico posto lo storico degli ordini, le performance dei prodotti, i clienti abituali e i risultati di marketing. Poi collega il server MCP di AmICited a Claude, Codex o a un agente FlowHunt e fai domande su quei dati in conversazione. Il server MCP di Shoptet aggiunge una via separata verso le operazioni supportate del negozio.
Questa guida è pensata per i proprietari di negozi che vogliono passare da “Quanti ordini abbiamo ricevuto?” a “Cosa ha determinato le performance, quali clienti tornano e dove dovremmo investire adesso?”. Copre le analisi, i passaggi di connessione e le domande pratiche che puoi porre a un agente AI.
Punti chiave
- Importa lo storico ordini che ti serve. La connessione Shoptet documentata di AmICited può importare lo storico fino al primo ordine, supportando analisi dettagliate su ordini, prodotti e clienti.
- Valuta la crescita da ciò che il negozio trattiene. Configura costi dei prodotti, commissioni di pagamento e altre spese prima di usare contributo o profitto per prendere decisioni.
- Porta le campagne nella stessa revisione. Collega fonti pubblicitarie e di ricerca per confrontare delivery, spesa e stime attribuite con i risultati reali del negozio.
- Fai domande di approfondimento tramite MCP. Un agente può indagare una variazione delle vendite, esaminare il comportamento di riacquisto e spiegare i report alla base della sua risposta.
- Usa i dati per la pianificazione del marketing mix. Gli scenari di budget e la modellazione formale richiedono assunzioni dichiarate; una correlazione tra canali non dimostra vendite incrementali.
Comprendere le tre connessioni
MCP, ovvero Model Context Protocol, consente a un’applicazione AI di scoprire e chiamare strumenti esterni. In questa configurazione, connessioni diverse svolgono compiti diversi:
| Connessione | Cosa fornisce | Da dove iniziare |
|---|---|---|
| Shoptet → AmICited | Storico ordini, prodotti e relazioni con i clienti importati per le analisi | AmICited Data Sources → Eshops |
| AmICited MCP → il tuo client AI | Accesso conversazionale ai report collegati di commercio, marketing, ricerca e visibilità | Aggiungi il server MCP di AmICited |
| Shoptet MCP → il tuo client AI | Operazioni supportate del negozio, in base al tariffario e ai permessi | Installa l’add-on Shoptet MCP |
Per le analisi storiche, collega prima il negozio ad AmICited. Per una conversazione sui report, aggiungi AmICited MCP al client che preferisci. Aggiungi anche Shoptet MCP quando l’attività richiede un’operazione supportata direttamente nel negozio.
Come verificato il 25 ottobre 2026, Shoptet Support elenca il suo servizio MCP per i negozi Basic, Business, Profi, Enterprise, di prova e Premium; Free è escluso. Premium espone un set di strumenti più ampio. Anche i tariffari standard a pagamento supportano alcune scritture, inclusa la pubblicazione di blog. La scheda dell’add-on MCP indica che l’add-on è gratuito almeno fino alla fine del 2026, con limiti specifici per tariffa in seguito.
Questa più ampia disponibilità di MCP non cambia il requisito documentato della Private API solo per Premium per l’importazione Shoptet di AmICited. Le integrazioni ecommerce di AmICited richiedono il piano Pro o superiore. Consulta la documentazione sulla connessione ecommerce per i requisiti attuali.
Analizzare in dettaglio gli ordini del tuo Shoptet
AmICited può elaborare i dati degli ordini Shoptet importati tramite la connessione, incluso l’intero storico disponibile quando selezioni l’opzione di importazione più lunga. Il vantaggio è un livello di reporting coerente su vendite, costi, prodotti e comportamento dei clienti, invece di un foglio di calcolo separato per ogni domanda.
Il Sales Engine segue ricavi giornalieri, ordini, valore medio dell’ordine, cancellazioni, componenti di costo e profitto. La sua tabella giornaliera di profitti e perdite ti consente di esaminare i componenti dietro una variazione.
Una settimana intensa può produrre più ordini lasciando però meno profitto. Gli sconti possono ridurre il valore dell’ordine, il mix di prodotti può spostarsi verso articoli con margini inferiori, oppure i costi di spedizione e acquisizione possono aumentare. Chiedi all’agente di scomporre quella variazione prima di scegliere una risposta:
Confronta gli ultimi 30 giorni completi con i 30 precedenti. Spiega le variazioni di ordini validi, ricavi netti, valore medio dell’ordine e profitto. Distingui le variazioni di volume da quelle di valore e costo. Indica la copertura importata e gli eventuali input mancanti.

Order Mix aggiunge un ulteriore livello: classificazioni degli stati d’ordine, primi ordini rispetto a quelli successivi, tipo di acquirente, metodo di pagamento, corriere e costi di acquisto misurati rispetto a quelli presunti. Aiuta a rispondere al perché il totale principale è cambiato. Un ordine annullato, un pagamento rifiutato e una vendita effettiva non dovrebbero essere tutti conteggiati come ricavi equivalenti.
La condizione di completamento rilevante è una spiegazione riconciliata: l’agente dovrebbe indicare il periodo, gli ordini inclusi, le regole sugli stati e il report utilizzato. “Le vendite sono calate” è un’osservazione; “gli ordini validi sono calati mentre il valore dell’ordine è rimasto stabile” è un punto di partenza molto più utile.
Vedere quali prodotti generano valore al netto dei costi
Le classifiche per ricavi mostrano cosa vende. L’analisi del contributo mostra cosa rimane dopo i costi inclusi nel calcolo. Insieme aiutano a decidere quali prodotti meritano promozione, una revisione dei prezzi o un merchandising migliore.
Usa i report sui prodotti per confrontare ricavi, unità e contributo. Usa Cost Mix per esaminare la scala che va dai ricavi ai costi dei prodotti, evasione, commissioni di pagamento, pubblicità e costi generali configurati. Chiedi informazioni sulla base di costo insieme alla classifica:
Classifica i prodotti per contributo negli ultimi 90 giorni. Escludi spedizioni e altre voci non relative ai prodotti. Mostra ricavi, unità e copertura dei costi misurati, e segnala le classifiche che dipendono da costi di acquisto presunti.

Puoi andare oltre i singoli best seller. I bundle di prodotti esaminano cosa viene acquistato insieme; l’analisi del prodotto d’ingresso esamina quali primi acquisti portano a ordini successivi. Questo crea una domanda di marketing utile: la prossima campagna di acquisizione dovrebbe promuovere la vendita immediata più grande o un prodotto associato a un riacquisto più forte?
Trattala come una domanda da indagare. Un’associazione di riacquisto può informare un test senza dimostrare che pubblicizzare un particolare prodotto d’ingresso causerà lo stesso comportamento in un nuovo pubblico.
Comprendere clienti abituali, fidelizzazione e valore nel tempo
Lo storico ordini di Shoptet diventa più utile quando puoi seguire lo stesso cliente attraverso più acquisti. AmICited lo supporta sia con identificatori anonimizzati sia con dati completi dei clienti, in base alla scelta di importazione.
Customers and Retention raggruppa i clienti in coorti di acquisizione e segmenti basati su recency, frequency e monetary value, spesso abbreviato in RFM. Questo aiuta a distinguere un negozio che guadagna nuovi acquirenti da uno che costruisce una base di clienti abituali.

Repeat Purchase aggiunge il tempo tra gli ordini, il riacquisto per prodotto e il valore in diverse posizioni nello storico ordini di un cliente. Lifetime Value segue il valore cumulato dopo l’acquisizione e il payback osservato delle coorti dove esistono gli input necessari di costo e spesa.
Questi report aiutano il proprietario di un negozio a chiedersi:
- I clienti di ritorno stanno contribuendo con più o meno ricavi rispetto a prima?
- Quanto tempo impiega un cliente tipico a effettuare un secondo ordine?
- Quali prodotti del primo acquisto sono associati a una fidelizzazione più forte?
- Quali segmenti di valore sono diventati silenziosi?
- Quanto costo di acquisizione ha effettivamente recuperato una coorte matura?
Fornisci all’agente uno storico sufficiente per il ciclo di acquisto dell’azienda. Una finestra di 30 giorni può essere utile per il monitoraggio delle vendite e inadeguata per un negozio i cui acquirenti riordinano due volte l’anno. Confronta le coorti alla stessa età e mantieni i conteggi dei clienti accanto ai tassi.
Esamina il riacquisto negli ultimi 12 mesi. Separa i ricavi dei clienti nuovi e di ritorno, mostra la tempistica tipica tra primo e secondo ordine e identifica i prodotti d’ingresso con abbastanza clienti per supportare un confronto. Mantieni separate le coorti giovani da quelle mature.
Per un piano di riattivazione, Replenishment può identificare le tempistiche di riordino attese. L’analisi può funzionare con identificatori anonimi dei clienti; contattare quelle persone richiede una fonte di identità adeguatamente autorizzata e un flusso di campagna separato.
Confrontare le campagne con ciò che il negozio ha effettivamente guadagnato
Collega gli account pubblicitari del negozio allo stesso dominio AmICited per portare spesa e delivery nella revisione. Aggiungi fonti di ricerca quando vuoi la domanda organica insieme all’attività a pagamento. La guida alla configurazione delle piattaforme pubblicitarie spiega le connessioni supportate.
Cross-source Revenue Attribution mette una accanto all’altra delivery dei canali, stime di attribuzione e risultati del negozio. La distinzione importante è visibile nel report: spesa e clic sono input misurati; ordini e ricavi attribuiti possono essere stime con un metodo e una confidenza dichiarati.

La vista dell’acquisizione blended mette in relazione la spesa a pagamento inclusa con i nuovi clienti identificati dal negozio e i ricavi realizzati. Il reporting delle campagne e le viste CAC/ROAS aggiungono dettaglio dove i dati corrispondenti lo supportano. CAC significa costo di acquisizione del cliente; ROAS significa ritorno sulla spesa pubblicitaria. Né la conversione dichiarata da una piattaforma né un rapporto blended identificano quale canale ha causato un singolo acquisto.
Con Meta collegato, AmICited fornisce anche Profit-true ROAS, CAC per nuovi clienti, efficienza del pubblico, dayparting e Profit Scaling. Questi ti permettono di indagare se la spesa è allineata a un commercio redditizio e se una spesa maggiore è associata a sufficiente valore aggiuntivo per i clienti.
Esamina le nostre campagne collegate negli ultimi 90 giorni. Mostra separatamente spesa, conversioni tracciate, stime attribuite e risultati realizzati del negozio. Confronta il costo di acquisizione con il contributo dei clienti maturi dove disponibile. Elenca le piattaforme mancanti e i problemi di valuta o di matching prima di raccomandare una revisione del budget.
Ecco come la conversazione diventa utile: “Quale campagna ha il ROAS dichiarato più alto?” può portare a “Sembra ancora interessante dopo cancellazioni, costi dei prodotti e comportamento dei clienti di ritorno?”
Usare i dati Shoptet per l’analisi e la modellazione del marketing mix
Un proprietario di negozio può usare lo storico ordini collegato come base dei risultati di business per la pianificazione del marketing mix: come dividere sforzo e budget tra canali di acquisizione, fidelizzazione, ricerca organica e promozione dei prodotti.
Parti da una decisione concreta. Forse una campagna porta molti primi ordini, ma i periodi di acquisizione associati mostrano un valore di riacquisto debole. Un’altra categoria di prodotti ha meno primi acquisti e un contributo osservato migliore nel tempo. Il prossimo passo utile può essere un test di budget controllato, un focus diverso sui prodotti o un esperimento di fidelizzazione, invece di spendere semplicemente di più sul canale con la dichiarazione di ricavi più alta.
AmICited fornisce diversi input per questo lavoro:
| Domanda di pianificazione | Evidenza rilevante |
|---|---|
| Quale risultato dovremmo ottimizzare? | Ricavi realizzati, contributo, profitto o nuovi clienti identificati dal negozio |
| Cosa ha prodotto il marketing? | Spesa, impression e clic dei canali e delle campagne collegati |
| La qualità dei clienti è cambiata? | Riacquisto, coorti mature, prodotti d’ingresso e contributo nel ciclo di vita |
| La domanda si è mossa con l’attività a pagamento? | Associazioni a pagamento–organico, domanda di ricerca e tempistica degli ordini |
| Possiamo permetterci un costo di acquisizione maggiore? | Copertura dei costi, valore del contributo, payback osservato e diagnostica di scaling |
Il marketing mix modeling (MMM) formale è un ulteriore passo statistico. Utilizza risultati in serie temporali, attività media e altre variabili esplicative per stimare gli effetti dei canali ed esplorare l’allocazione del budget. L’ introduzione a Meridian di Google descrive un processo di modellazione che include preparazione dei dati, assunzioni su lag e saturazione, valutazione del modello e ottimizzazione del budget.
Per un negozio Shoptet, lo storico ordini importato può fornire la serie dei risultati, mentre le campagne collegate forniscono gli input di marketing. Un analista o un agente adeguatamente attrezzato può aiutare a organizzare quelle serie, registrare promozioni e altre variazioni rilevanti, e preparare il lavoro di modellazione o di scenario. Anche meteo, festività, stagionalità e vincoli di scorte possono richiedere considerazione, in base all’azienda e ai dati disponibili.
Mantieni distinti tre output: un report descrive le performance osservate; uno scenario calcola cosa consegue dalle assunzioni; un modello stimato stima relazioni secondo un metodo specificato. I report cross-source verificati di AmICited supportano l’analisi e la preparazione alla modellazione. Da soli non stabiliscono un MMM causale completo e stimato né un budget ottimale garantito.
Prepara un brief di analisi del marketing mix dai nostri dati Shoptet e pubblicitari collegati. Proponi un dataset settimanale comune di risultati e canali, elenca lo storico e i controlli mancanti e spiega quali domande di budget l’evidenza può supportare. Separa osservazioni dei report, assunzioni di scenario e lavoro che richiede un modello stimato. Non modificare i budget delle campagne.
Questo dà al proprietario qualcosa di attuabile: una decisione documentata, un dataset utilizzabile dove disponibile e un percorso esplicito dalle performance osservate a un esperimento di budget.
Come collegare Shoptet ad AmICited
Usa l’importazione documentata del negozio per sbloccare le analisi storiche. Ti serve un amministratore del workspace AmICited, un piano idoneo e l’accesso alla Private API di Shoptet.
- Crea il token Shoptet. Nell’amministrazione di Shoptet, apri Connections → Private API, fai clic su Add, inserisci una descrizione e lascia abilitati i gruppi di endpoint richiesti come descritto nella guida all’integrazione. Rivela il token e conferma con la tua password.
- Collega il negozio. In AmICited, apri Data Sources → Eshops, scegli Shoptet, incolla il token API e fai clic su Connect Shoptet. Il token include l’ID dell’e-shop.
- Associalo al dominio corretto. Usa Select account nella scheda della connessione affinché gli ordini appartengano allo stesso dominio dei report di marketing e visibilità che vuoi analizzare.
- Scegli la gestione dell’identità dei clienti. Prima della prima importazione, seleziona dati dei clienti anonimizzati o completi. Gli identificatori anonimi supportano le analisi sui clienti abituali; l’identità completa è una scelta separata. Cambiarla in seguito richiede una riconnessione.
- Seleziona lo storico ordini. Scegli un periodo adatto alle tue domande. L’opzione documentata più lunga arriva al primo ordine del negozio. Rivedi le righe previste e il costo di importazione indicato prima di confermare.
- Configura le regole di reporting. Imposta valuta, classificazioni degli stati d’ordine, metodi di pagamento, costi di acquisto dei prodotti, spedizione, imballaggio e altri periodi di costo. Aggiungi costi generali e personalizzati dove rilevante.
- Verifica la prontezza. Esamina le date coperte dalla connessione, lo stato di sincronizzazione e i campi mancanti, poi controlla Data health. Aggiungi le tue fonti pubblicitarie e di ricerca allo stesso dominio per l’analisi cross-source.
La connessione è pronta per una prima revisione utile quando le vendite recenti si riconciliano con Shoptet, lo storico importato copre la finestra prevista e la base di costo è chiara. Un input di costo mancante deve restare mancante o esplicitamente assunto; non è prova di una spesa pari a zero. Anche la disponibilità di rimborsi e note di credito va verificata per la fonte.
Consulta la guida completa alla connessione ecommerce per importazione, scelte di identità, costi e impostazioni.
Come aggiungere MCP a Claude
Per le analisi sui dati importati, aggiungi AmICited MCP. Aggiungi Shoptet MCP separatamente se vuoi anche strumenti diretti sul negozio.
- Apri le impostazioni dei connettori di Claude.
- Fai clic su + → Add custom connector e chiamalo AmICited.
- Inserisci l’URL qui sotto, aggiungi il connettore, poi fai clic su Connect.
- Completa l’accesso OAuth e seleziona il tuo workspace AmICited. Inizia con l’accesso in sola lettura per il reporting.
- Abilita il connettore nel menu degli strumenti della tua conversazione.
https://api.flowhunt.io/mcp/amicited
Chiedi: “Elenca i miei domini AmICited e verifica se i dati Shoptet sono collegati per il mio negozio.” Conferma il risultato prima di richiedere una revisione delle performance. AmICited MCP richiede un piano idoneo, permessi Editor o superiori e un saldo crediti positivo; la guida alla connessione MCP documenta questi requisiti.
Per l’accesso diretto a Shoptet, installa prima l’add-on MCP appropriato, poi usa il connettore Claude ufficiale di Shoptet e completa l’autorizzazione. L’indirizzo del server è https://mcp.shoptet.com/mcp. Verifica il negozio e gli strumenti disponibili dopo l’accesso. Le impostazioni dell’organizzazione Claude possono richiedere che un amministratore abiliti i connettori.
Come aggiungere MCP a Codex
Con Codex CLI installato, aggiungi il server MCP remoto di AmICited e accedi:
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited
Completa l’autorizzazione nel browser e seleziona il workspace corretto. Per aggiungere anche gli strumenti diretti di Shoptet, installa l’add-on MCP di Shoptet ed esegui:
codex mcp add shoptet --url https://mcp.shoptet.com/mcp
codex mcp login shoptet
Verifica la configurazione:
codex mcp list
Dentro Codex, usa /mcp per ispezionare i server attivi. Questi comandi seguono la
guida MCP ufficiale di OpenAI e le istruzioni di connessione dei servizi stessi. Aggiungere entrambi i server non trasferisce i permessi tra loro; ciascuno ha la propria autorizzazione.
Inizia una conversazione con: “Usa AmICited per controllare lo storico Shoptet importato e le fonti di campagna collegate. Dammi un briefing settimanale in sola lettura con i report e le date alla base di ogni conclusione.”
Come collegare MCP a un agente FlowHunt
La guida Custom MCP Client di FlowHunt documenta come collegare un server MCP esterno come strumento di un agente:
- Apri il tuo flow e seleziona il suo componente AI Agent o Deep Agent.
- In Tools, fai clic su + Add Tool, cerca MCP Client e selezionalo.
- Apri Edit Servers e aggiungi
https://api.flowhunt.io/mcp/amicitedper le analisi AmICited. Seleziona il trasporto HTTP compatibile per quell’endpoint. - Configura l’autenticazione. Usa la modalità Advanced dove sono richiesti configurazione OAuth o header di autorizzazione, seguendo il metodo di autenticazione supportato dal server.
- Salva, assegna allo strumento un nome descrittivo come AmICited store analytics, poi fai clic su Add with Config.
- Esegui un piccolo test: elenca i domini, seleziona il negozio e controlla la copertura importata prima di richiedere un report.
Per usare le operazioni dirette su Shoptet, configura una voce separata del server MCP per https://mcp.shoptet.com/mcp e la sua autorizzazione OAuth. Conferma che la tua configurazione FlowHunt completi l’autorizzazione di Shoptet ed esponga gli strumenti richiesti prima di fare affidamento su quel percorso. Questo articolo non rivendica un deployment OAuth Shoptet end-to-end testato in FlowHunt.
Fornisci all’agente un’istruzione operativa chiara: identifica negozio e periodo, controlla i dati mancanti, cita i report utilizzati, distingui le stime dagli ordini misurati e restituisci azioni proposte da rivedere. Mantieni le credenziali nelle impostazioni di connessione, fuori da prompt e documenti condivisi.
Trasformare i report in una conversazione AI continuativa
Una volta collegati il negozio e le fonti di marketing, il proprietario può porre domande di approfondimento senza ricostruire l’analisi da zero:
Cosa è cambiato nelle performance del nostro Shoptet la settimana scorsa? Inizia con ordini e ricavi, poi esamina contributo, spesa delle campagne e clienti nuovi rispetto a quelli di ritorno. Confronta periodi equivalenti e mostra l’evidenza per le tre variazioni più grandi.
Prosegui con “Quali prodotti spiegano la variazione?”, “Quei clienti stanno tornando?” o “Cosa dovremmo testare il mese prossimo?”. L’agente può usare gli strumenti di report pertinenti per indagare ogni domanda invece di affidarsi a un riepilogo statico.
Porta anche la visibilità AI nella stessa revisione. Usa i prodotti redditizi e le categorie d’ingresso di valore per scegliere le domande degli acquirenti per il prompt tracking. Verifica se il tuo negozio è menzionato e quali pagine sono citate. Questo collega le priorità commerciali alla prossima indagine sui contenuti senza affermare che un singolo prompt tracciato abbia causato un particolare ordine.
Inizia con un briefing in sola lettura. Il primo risultato utile è una spiegazione che puoi verificare, seguita da un breve elenco di decisioni o test. La pubblicazione di contenuti, il contatto con i clienti e le modifiche al budget restano azioni separate.
Fonti e verifica
La copertura dei prodotti è stata verificata il 25 ottobre 2026 rispetto alle definizioni dei report di AmICited MCP, alla documentazione di prodotto collegata e alle fonti ufficiali di configurazione. Gli screenshot sono catture di report già presenti nel repository, incluse per spiegare l’interfaccia; non sono catture recenti da un negozio Shoptet né dichiarazioni di risultati dei clienti. I prompt di esempio descrivono attività da eseguire dopo aver collegato i tuoi dati.
- AmICited: Ecommerce stores e guida alla connessione MCP — importazione, storico, identità e configurazione del client.
- Shoptet: supporto MCP e add-on MCP — accesso in base alla tariffa e installazione.
- OpenAI: Model Context Protocol — gestione del server Codex e OAuth.
- FlowHunt: Custom MCP Client — configurazione dello strumento MCP di un agente.
- Google: An introduction to Meridian — ambito e flusso di lavoro di un MMM formale. Aggiornato il 9 luglio 2026. Tutte le fonti esterne consultate il 25 ottobre 2026.
Scegli il tuo prossimo report
- Sales Engine — esamina ordini, ricavi e costi giornalieri.
- Customers and Retention — comprendi i segmenti di clienti e il comportamento di riacquisto.
- Lifetime Value — esamina valore e payback nel tempo.
- Cross-source Revenue Attribution — confronta la delivery di marketing con i risultati del negozio e le stime dichiarate.
- Integrazione Shoptet — rivedi la connessione del negozio prima di iniziare il tuo primo briefing.

