Server MCP
Collega Claude, ChatGPT o un altro assistente IA compatibile ai tuoi dati Fullmetrix e interroga il tuo negozio dall'assistente che usi già.
Il server MCP di Fullmetrix permette al tuo assistente IA abituale, come Claude o ChatGPT, di leggere i tuoi dati Fullmetrix. Una volta collegato, fai le tue domande in Claude o ChatGPT, per esempio "Quali prodotti hanno venduto di più a settembre?", e l'assistente recupera la risposta dai tuoi dati.
MCP sta per Model Context Protocol. È uno standard aperto che definisce come un assistente IA si collega a una fonte di dati. Qualsiasi assistente compatibile con MCP può quindi collegarsi a Fullmetrix allo stesso modo.
L'accesso è in sola lettura. L'assistente può leggere i tuoi dati, ma non può modificare nulla in Fullmetrix, nel tuo negozio o nei tuoi account pubblicitari.
Preferisci restare in Fullmetrix?
L'assistente IA integrato in Fullmetrix fa lo stesso lavoro senza uscire dall'app, e aggiunge grafici e report condivisibili. Il server MCP è pensato per quando vuoi lavorare dall'assistente che usi già.
L'indirizzo del server
Tutti i client usano lo stesso indirizzo.
https://app.fullmetrix.com/api/mcpIl server funziona tramite HTTP, nella modalità che i client MCP chiamano "Streamable HTTP". Ci sono due modi per collegarsi.
- Con il tuo account Fullmetrix. Il client ti porta su una pagina di Fullmetrix dove autorizzi l'accesso. È il metodo consigliato, senza nessuna chiave da copiare.
- Con una chiave API, per i client che non possono aprire una pagina di accesso. Vedi più sotto.
Prima di iniziare
Ti serve un account Fullmetrix con almeno un'organizzazione il cui negozio sia collegato e sincronizzato. L'assistente legge i dati delle tue organizzazioni, quindi ha bisogno di dati da leggere.
L'accesso MCP fa parte del tuo abbonamento Fullmetrix, senza costi aggiuntivi. L'uso di Claude o ChatGPT resta comunque fatturato dai loro produttori in base al tuo piano con loro.
Collegare Claude
Aprire la scheda Fullmetrix
Fullmetrix Analytics è pubblicato nella directory di Claude. Apra la sua pagina, oppure cerchi Fullmetrix in Claude, nella sezione dei connettori delle impostazioni.
Aggiungere il connettore
Faccia clic sul pulsante di aggiunta. Claude apre una pagina Fullmetrix. Acceda se necessario, poi autorizzi l'accesso come descritto nella sezione seguente.
Porre una domanda
In una nuova conversazione, verifichi che il connettore Fullmetrix sia attivo, poi ponga la sua domanda.
A seconda del piano Claude, l'aggiunta di connettori può essere riservata ad alcuni abbonamenti o all'amministratore dello spazio del team. L'indirizzo https://app.fullmetrix.com/api/mcp resta utilizzabile come connettore personalizzato se preferisce aggiungerlo a mano.
Collegare ChatGPT
ChatGPT accetta i server MCP come app personalizzata, chiamata anche connettore.
Aprire le impostazioni delle app
In ChatGPT apri le impostazioni, poi la sezione delle app e dei connettori. A seconda del tuo piano, per aggiungere un'app personalizzata bisogna prima attivare la modalità sviluppatore nelle impostazioni avanzate.
Creare l'app
Crea una nuova app. Chiamala Fullmetrix, incolla l'indirizzo https://app.fullmetrix.com/api/mcp e scegli l'autenticazione OAuth. Conferma.
Autorizzare l'accesso
ChatGPT apre la pagina di Fullmetrix. Accedi se necessario, poi autorizza l'accesso.
Usare Fullmetrix in una conversazione
In una conversazione, aggiungi l'app Fullmetrix dal menu degli strumenti, poi fai la tua domanda.
I menu di ChatGPT cambiano spesso. Se non trovi l'opzione, cerca "custom connector" o "MCP" nella guida di ChatGPT.
Collegare un altro client MCP
Cursor, Visual Studio Code, Windsurf e la maggior parte degli strumenti compatibili con MCP si configurano con l'indirizzo del server. Nel file di configurazione MCP del tuo strumento, dichiara un server remoto in questo modo.
{
"mcpServers": {
"fullmetrix": {
"url": "https://app.fullmetrix.com/api/mcp"
}
}
}I nomi esatti delle chiavi possono variare da uno strumento all'altro. Consulta la sua documentazione. Al primo utilizzo, lo strumento apre la pagina di autorizzazione di Fullmetrix nel browser.
Collegarsi con una chiave API
Se il tuo client non supporta l'accesso con l'account, usa una chiave API. Creala in Impostazioni, scheda Chiavi API, come descritto in API pubblica. Poi aggiungila all'intestazione Authorization delle richieste del client.
{
"mcpServers": {
"fullmetrix": {
"url": "https://app.fullmetrix.com/api/mcp",
"headers": {
"Authorization": "Bearer fmx_YOUR_KEY"
}
}
}
}Una chiave dà accesso a una sola organizzazione, quella in cui l'hai creata. L'accesso con l'account dà accesso a tutte le tue organizzazioni.
La pagina di autorizzazione
Quando un client si collega con il tuo account, Fullmetrix mostra la pagina Connect an external application. Se non hai effettuato l'accesso a Fullmetrix, prima compare la pagina di accesso.
La pagina descrive cosa chiede l'applicazione.
- Read analytics data, cioè vedere i tuoi negozi, clienti, prodotti, ordini, campagne, costi e i dati dei servizi collegati.
- Access authorized organizations. Saranno disponibili solo le organizzazioni a cui hai già accesso in Fullmetrix.
Un avviso ricorda che l'accesso è in sola lettura. Clicca su Authorize access per confermare, oppure su Deny per annullare. Vieni poi riportato automaticamente al tuo client.
Se compare il messaggio "The authorization could not be completed. Please try again.", riavvia la connessione dal tuo client.
Quali organizzazioni sono disponibili
L'accesso con l'account apre l'accesso alle organizzazioni che vedi in Fullmetrix. Sono le organizzazioni della tua azienda se sei amministratore, e quelle a cui un amministratore ti ha dato accesso. L'assistente non vede mai un'organizzazione che tu stesso non puoi vedere. Per gestire questi accessi, vedi Team e ruoli.
Se hai più organizzazioni, indica il negozio o l'organizzazione nella tua domanda. Altrimenti l'assistente interroga la prima dell'elenco.
Gli strumenti esposti
Un client MCP scopre degli strumenti, cioè azioni che può richiamare. Fullmetrix ne espone tre, tutti in sola lettura.
| Strumento | Cosa fa |
|---|---|
describe_data | Descrive i dati disponibili e i servizi collegati alle tue organizzazioni. L'assistente lo richiama prima della sua prima domanda |
query_data | Legge i dati del tuo negozio in Fullmetrix, come ordini, righe d'ordine, prodotti, varianti, categorie, clienti, contatti, carrelli, codici sconto, rimborsi, abbonamenti e navigazione dei visitatori. Legge anche i dati di configurazione del tuo account Fullmetrix |
platform_query | Interroga un servizio collegato, tra Google Ads, Meta Ads, TikTok Ads, ChatGPT Ads, Google Analytics 4, Search Console e Crisp. Se hai più account sullo stesso servizio, li interroga tutti a meno che tu non ne indichi uno |
Non richiami tu questi strumenti. Fai una domanda in linguaggio naturale, e l'assistente sceglie gli strumenti e le interrogazioni.
I dati provengono dalle stesse informazioni dei tuoi report. Perché l'assistente corrisponda esattamente ai tuoi dati, chiedigli di applicare le regole delle tue Impostazioni dei report, per esempio escludendo gli ordini annullati.
Esempi di domande
- Qual è stato il mio fatturato a settembre, rispetto a settembre dell'anno scorso?
- Quali sono i miei 10 prodotti più venduti di questo trimestre, con il loro fatturato?
- Confronta giorno per giorno la mia spesa Meta Ads e le mie vendite negli ultimi 30 giorni.
- Quali query di Search Console portano più click alle mie pagine prodotto?
- Riassumi le richieste ricevute su Crisp questa settimana.
Interrompere l'accesso
Per una connessione con l'account, rimuovi il connettore Fullmetrix nelle impostazioni del tuo client, che sia Claude, ChatGPT o un altro.
Per una connessione con una chiave API, apri Impostazioni, scheda Chiavi API, e clicca su Revocare accanto alla chiave. Il client perde subito l'accesso.