Ask AI e MCP

Fai domande alle analytics del tuo negozio in linguaggio naturale

Ask AI risponde alle domande sul tuo negozio partendo dai tuoi report ROASaurus. Gli stessi strumenti sono disponibili tramite un server MCP, così Claude, ChatGPT o un altro client MCP può consultare profitto, attribuzione e LTV.

Risposte dai tuoi dati

Ogni numero deriva da una chiamata a uno strumento sui tuoi report, mai dalla memoria del modello.

Funziona su Claude

Il modello di Anthropic legge i risultati e risponde nella lingua in cui scrivi.

24 strumenti in sola lettura

Profitto, attribuzione, view-through, annunci, campagne, clienti, LTV, prodotti, web, obiettivi, inventario, benchmark, costi, audience, lead, avvisi, anomalie, il piano d’azione, dashboard, marketing mix, budget e abbonamenti.

Server MCP

Usa gli stessi strumenti da Claude, ChatGPT o un altro client MCP: accedi con il tuo login ROASaurus oppure invia una chiave API in un header.

Tieni al sicuro la chiave

Usa una chiave API con nome che abbia solo lo scope mcp, oppure la chiave API del negozio, che può anche inviare ordini ed eventi. Tieni entrambe al sicuro come una password.

Per negozio

Un collegamento legge un solo negozio: quello che scegli quando accedi, oppure quello della chiave API.

Come funziona Ask AI

Ask AI è una pagina di chat nella dashboard. Fai una domanda, Claude sceglie gli strumenti che possono rispondere, ROASaurus li esegue sui dati del tuo negozio e Claude scrive la risposta a partire dai risultati. Se uno strumento non restituisce dati, lo dice e suggerisce cosa collegare, come lo script di tracciamento, gli account pubblicitari o i costi di prodotto. La cronologia viene conservata per utente e negozio, e ogni utente ha un limite giornaliero di domande (40 per impostazione predefinita, 5 nel piano Gratuito). Ask AI può anche proporre una modifica a una campagna, a un gruppo di annunci o a un annuncio per l’inbox Actions; nulla cambia finché un proprietario o un amministratore non la approva.

Tra le domande a cui può rispondere ci sono «Quale campagna ha avuto il miglior POAS negli ultimi 30 giorni?», «Quanti mesi servono a una coorte per recuperare il proprio CAC?» e «Siamo in linea con l’obiettivo di ricavi di questo mese?»

Gli strumenti

StrumentoCosa restituisce
profit_summaryRicavi, ordini, AOV, spesa pubblicitaria, MER, CAC, POAS, costi, utile lordo e netto, rispetto al periodo precedente
attributionOrdini, ricavi, spesa, ROAS e CPA per canale e campagna, con uno qualsiasi dei dodici modelli, finestre di lookback e data dell’ordine o del clic
view_throughAcquisti che le piattaforme pubblicitarie segnalano dopo la visualizzazione di un annuncio senza clic, e quanti ROASaurus ne ha collocati sugli ordini, per piattaforma e campagna
ads_tableSpesa, impression, clic, CTR e CPM uniti agli acquisti tracciati, per campagna, gruppo di annunci o annuncio
campaign_profitProfitto prima e dopo gli annunci, POAS, CAC e LTV a 90 giorni per campagna
customer_valueLTV da 30 a 365 giorni, tasso di riacquisto, giorni al secondo ordine e coorti mensili
ltv_insightsPayback del CAC, LTV previsto, tempi di riacquisto, prodotto successivo, segmenti RFM e fattori dell’LTV
productsProdotti top e quota di nuovi acquirenti che hanno riordinato
web_analyticsSessioni, frequenza di rimbalzo e tasso di conversione per fonte, dispositivo e pagina di destinazione
goals_forecastGli obiettivi di questo mese, i valori effettivi finora e la previsione di fine mese
inventoryValore delle scorte, velocità di vendita, giorni rimanenti e articoli da riordinare
benchmarksI tuoi ultimi 90 giorni a confronto con i quartili dei negozi simili
cost_modelVoci del conto economico fino all’EBITDA, da CM1 a CM3, costi generali, IVA recuperata e le fonti di costo collegate
audiencesOgni audience con le sue regole, la dimensione con consenso e lo stato di sincronizzazione per destinazione
leads_pipelineLead, MQL, SQL, trattative vinte, ricavi vinti e costo per lead, per canale e campagna
alertsCali recenti degli ordini, cali del ROAS, picchi di spesa e interruzioni del tracciamento
anomaliesMetriche uscite dal loro intervallo normale negli ultimi giorni, con il valore atteso
action_planIl piano d’azione settimanale e il registro delle decisioni, con i risultati prima e dopo
list_dashboardsDashboard personalizzate condivise con il workspace e metriche personalizzate
evaluate_metricQualsiasi metrica integrata o personalizzata, o una formula, con filtri e periodo di confronto
marketing_mixRicavi incrementali, iROAS, ROAS marginale e saturazione per canale dal marketing mix model
optimal_budgetLa migliore ripartizione di un budget tra i canali, con limiti per canale
subscriptionsAbbonati, MRR, churn, motivi di disdetta e la conversione da acquisto singolo ad abbonamento
subscriber_cohortsRetention di abbonati e MRR per mese del primo abbonamento

Ask AI, e i client MCP la cui chiave ha lo scope actions:write, ricevono anche ad_entities (le campagne, i gruppi di annunci e gli annunci degli account pubblicitari abilitati alla scrittura) e propose_action, che aggiunge una modifica proposta all’inbox Actions, da far approvare a un proprietario o a un amministratore.

Il server MCP

MCP, il Model Context Protocol, permette alle app AI di richiamare strumenti di altri servizi. ROASaurus gestisce un server MCP con gli stessi 24 strumenti in sola lettura, così puoi fare domande sul tuo negozio da Claude Code o da un altro client MCP che già usi.

Endpoint: POST https://app.roasaurus.com/mcp
Header: Authorization: Bearer <store key>:<API key>

Parla MCP Streamable HTTP con risposte JSON (nessun server-sent event) e supporta initialize, ping, tools/list e tools/call. Ogni strumento di analisi è contrassegnato come sola lettura. Puoi anche inviare la chiave del negozio in un header X-Roasaurus-Key e usare come token bearer solo la chiave API. Entrambe le chiavi si trovano nella scheda Settings › Orders API del negozio. Quella chiave API è la stessa che usa l’API degli ordini, quindi può anche inviare ordini ed eventi: tienila al sicuro come una password. Rigenerarla disconnette ogni client che usava quella vecchia. Una chiave con nome che ha solo lo scope mcp, creata in Store settings › API & data, funziona da sola come token bearer e non può scrivere.

Le app di IA che supportano OAuth, come Claude e ChatGPT, accedono invece di usare una chiave: aggiungi l’endpoint come connettore personalizzato, accedi a ROASaurus, scegli un negozio e consenti il collegamento. Proprietari e amministratori possono collegare, e Store settings › API & data elenca ogni collegamento, dove puoi anche scollegarlo.

Privacy

Ask AI invia la tua domanda e metriche aggregate del negozio ad Anthropic, che gestisce Claude. Non invia i dati di contatto dei tuoi clienti. Tramite MCP, i risultati degli strumenti vanno al client AI che colleghi, secondo i termini di quel client.

Per chi è

Titolari che vogliono un numero senza costruire un report, e marketer o analisti che lavorano già in Claude e vogliono i dati del negozio accanto al resto del loro lavoro. Le risposte sono complete solo quanto i dati che le sostengono, quindi collega prima il tracciamento, la spesa di Meta e TikTok e i tuoi costi di prodotto.

Limiti

  • I periodi sono fissi: oggi, ieri oppure gli ultimi 7, 14, 30 o 90 giorni nel fuso orario del negozio.
  • La tabella degli annunci usa una finestra di lookback di 7 giorni; attribuzione e profitto per campagna usano la finestra di lookback del negozio o quella che chiedi.
  • Gli strumenti non possono modificare nulla da soli. Ask AI, e i client MCP la cui chiave ha lo scope actions:write, possono solo proporre modifiche agli annunci che un proprietario o un amministratore deve approvare.
  • Una chiave API copre un solo negozio. Per più negozi, collega ciascuno.
Altre funzionalità

Costruite sugli stessi dati first-party

Tracciamento server-sideCattura dei clic first-party, associazione degli ordini e Conversions API per 15 piattaforme pubblicitarie, deduplicate con il pixel del browser.Analisi del profittoUtile netto dopo ogni costo, POAS e ROAS di pareggio, un conto economico completo e il profitto per prodotto, ordine e canale.AttribuzioneDodici modelli, dall’ultimo clic ai modelli data-driven Markov e Shapley e a Total Impact, sui tuoi dati di clic, con i percorsi degli ordini e il profitto delle campagne.Lifetime valueCoorti, payback del CAC, LTV previsto fino a 24 mesi, tempi di riacquisto e segmenti RFM sincronizzati con Klaviyo.Analisi delle creativitàHook rate, hold rate, saturazione e ROAS per creatività, hook, creator e formato per Meta e TikTok.Marketing mix & budgetUn modello di marketing mix con ottimizzatore del budget, test geo-lift e on/off, curve di spesa e consigli giornalieri per scalare, mantenere o tagliare ogni campagna.AudiencePubblici creati da ordini, LTV previsto, RFM, visitatori e lead, sempre sincronizzati con dieci piattaforme pubblicitarie e Klaviyo.Actions & AutopilotUn ads manager per nove piattaforme con casella di approvazione, regole con limiti di sicurezza, un Autopilot AI e rollback in un click.Briefing AIAvvisi sulle anomalie, riepiloghi AI basati sui tuoi numeri, un piano d’azione settimanale con registro delle decisioni e domande programmate su Slack.Concorrenti & visibilità nell’AIInserzioni Meta ed email dei concorrenti, quante volte gli assistenti AI nominano il tuo negozio, bozze di contenuti AI e focus group AI.InfluencerUn CRM per influencer con accordi, attribuzione per codice e link, e ROI e profitto per accordo e per influencer.AgenzieWorkspace per i clienti, una panoramica multi-cliente, white label sul tuo dominio, report PDF e una quota di ricavi.
FAQ

Domande, risposte

Che cos’è un server MCP?

MCP (Model Context Protocol) è uno standard aperto che permette alle app AI di richiamare strumenti di altri servizi. Il server MCP di ROASaurus dà a un client AI strumenti in sola lettura su profitto, attribuzione, annunci, LTV, inventario, benchmark e avvisi di un negozio.

Quali app AI possono collegarsi?

Claude Code e altri client MCP in grado di chiamare un server Streamable HTTP con un header Authorization. ChatGPT si aspetta l’accesso con OAuth per i server MCP personalizzati, cosa che ROASaurus non offre ancora. Usa una chiave con nome con lo scope mcp creata in Store settings › API & data, oppure la chiave del negozio e la chiave API da Settings › Orders API.

L’AI può modificare le mie campagne o impostazioni?

Non direttamente. Ask AI, e i client MCP la cui chiave ha lo scope actions:write, possono proporre una modifica a una campagna, a un gruppo di annunci o a un annuncio nell’inbox Actions, e nulla cambia finché un proprietario o un amministratore non la approva. Nessuno strumento può modificare il tuo negozio, i tuoi costi o le tue impostazioni. La chiave API del negozio può anche inviare ordini ed eventi, quindi tienila riservata.

I dati dei clienti vengono inviati all’AI?

Ask AI invia la tua domanda e metriche aggregate del negozio ad Anthropic, che gestisce Claude, e nessun dato di contatto dei tuoi clienti. Tramite MCP, i risultati degli strumenti vanno al client AI che colleghi.

Ogni vendita, ricondotta all’annuncio che l’ha generata

Tracciamento server-side, profitto e lifetime value in un’unica app. Prova gratuita di 14 giorni, senza carta di credito.

Inizia la prova gratuita →