Connetti un assistente AI (MCP)

Il Model Context Protocol (MCP) consente agli assistenti AI di utilizzare i tuoi dati Statsdot. Una volta connesso, puoi porre domande come "Quali pagine hanno portato più visitatori da Google la scorsa settimana?" oppure "Confronta settembre con agosto per shop.example.com" e l'assistente leggerà i numeri da Statsdot.

L'indirizzo del server è https://statsdot.com/api/mcp. Claude e ChatGPT si connettono tramite OAuth: accedi a Statsdot e approvi la connessione. Gli strumenti per sviluppatori come Claude Code, Cursor e Codex utilizzano gli stessi token di accesso personale delle REST API.

Claude e ChatGPT (OAuth)

Claude

In Claude (web, desktop o mobile), apri Settings > Connectors, scegli Add custom connector e inserisci https://statsdot.com/api/mcp. Claude aprirà una pagina di Statsdot: accedi se necessario e scegli Allow.

ChatGPT

In ChatGPT, apri Settings > Apps and connectors, attiva la modalità sviluppatore in Advanced se il tuo piano lo richiede, crea un connettore con l'URL https://statsdot.com/api/mcp e scegli OAuth come autenticazione. Approva la connessione nella pagina di Statsdot che si aprirà.

Le connessioni effettuate in questo modo sono di sola lettura: l'assistente può interrogare le tue statistiche ma non può modificare siti, obiettivi, note o il tuo team. Appaiono sotto Connected assistants nella pagina API and MCP, dove puoi disconnetterle. Una connessione inutilizzata scade dopo 30 giorni.

Strumenti per sviluppatori (token di accesso)

1. Crea un token

Nella pagina API and MCP del tuo account, crea un token. Read only è sufficiente per porre domande. Scegli read and write solo se desideri che l'assistente aggiunga siti, obiettivi o membri del team.

2. Connetti il tuo assistente

Claude Code

claude mcp add --transport http statsdot https://statsdot.com/api/mcp \
  --header "Authorization: Bearer 12|your-token"

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "statsdot": {
      "url": "https://statsdot.com/api/mcp",
      "headers": { "Authorization": "Bearer 12|your-token" }
    }
  }
}

Codex

In ~/.codex/config.toml:

[mcp_servers.statsdot]
url = "https://statsdot.com/api/mcp"
http_headers = { "Authorization" = "Bearer 12|your-token" }

Altri client che supportano server MCP remoti tramite HTTP con un header personalizzato funzionano allo stesso modo.

Strumenti

Strumento	Cosa fa
get-account	Il tuo piano, eventi utilizzati e inclusi, limiti
list-sites	Siti che puoi visualizzare, con i relativi id
get-overview	Visitatori, visualizzazioni di pagina, frequenza di rimbalzo e durata della visita, confrontati con il periodo precedente
get-timeseries	Visitatori e visualizzazioni di pagina per giorno o mese
get-breakdown	Pagine principali, pagine di ingresso e uscita, referrer, campagne, paesi, dispositivi, browser, sistemi, eventi
get-goal-results	Obiettivi con conversioni e tasso di conversione
get-realtime	Visitatori negli ultimi cinque minuti
get-bot-traffic	Crawler AI che leggono il sito e le pagine richieste
list-funnels, get-funnel-results, create-funnel, delete-funnel	Funnel e visitatori a ogni passaggio
create-site, update-site, delete-site	Gestisci siti, inclusi avvisi e l'obiettivo principale (token in scrittura)
create-goal, delete-goal	Gestisci obiettivi (token in scrittura)
list-notes, create-note, delete-note	Note sul grafico che spiegano i cambiamenti nel traffico
list-team, invite-team-member, remove-team-member	Gestisci il tuo team (token in scrittura)

Gli strumenti di lettura sono contrassegnati come di sola lettura, mentre quelli che eliminano sono contrassegnati come distruttivi, quindi gli assistenti chiedono conferma prima di utilizzarli. Gli intervalli e i filtri funzionano come nelle API.

Privacy

L'assistente vede le stesse statistiche aggregate della tua dashboard. Statsdot non memorizza dati personali sui tuoi visitatori, quindi non c'è nulla da condividere. Revoca il token o disconnetti l'assistente dalla pagina API and MCP per interrompere la connessione in qualsiasi momento.