Integrazione MCP
Finseo mette a disposizione un server Model Context Protocol (MCP) che permette agli assistenti AI di interrogare direttamente i tuoi dati di visibilità.Cos’è MCP?
MCP (Model Context Protocol) è uno standard per collegare i modelli AI a fonti di dati esterne. Con il server MCP di Finseo, puoi porre a Claude, ChatGPT o Cursor domande in linguaggio naturale sulla tua visibilità AI senza scrivere codice. Esempio: apri Claude e chiedi:“Come è cambiata la visibilità del mio brand negli ultimi 30 giorni? Quali competitor sono davanti a me?”Claude interroga automaticamente i tuoi dati Finseo e fornisce un’analisi.
Guide al setup
- Claude (claude.ai, Desktop, Code) — OAuth, nessuna API key necessaria
- ChatGPT (developer mode) — OAuth, nessuna API key necessaria
- Cursor — API key tramite header
Autenticazione
Il server MCP supporta due metodi di autenticazione:Tool disponibili
Tutti i tool sono read-only: recuperano dati e non li modificano mai.
I tool di analytics accettano i filtri opzionali
model (es. chatgpt, perplexity, ai_overview, gemini, grok) e tags — gli stessi filtri della dashboard.
Definizioni delle metriche
I tool restituiscono gli stessi numeri della dashboard di Finseo e li etichettano esplicitamente:visibilityRatePercent— quota di risposte AI analizzate che menzionano il tuo brand (il KPI “Visibility” della dashboard)promptCoveragePercent— quota di prompt monitorati con almeno una menzione (un numero diverso, di solito più alto)ownDomainCitations.total— risposte AI che citano il tuo dominio come fonte (il KPI “Citations” della dashboard)
Endpoint
initialize, tools/list e tools/call. Le richieste non autenticate ricevono un 401 con i metadati di discovery OAuth secondo la spec di autorizzazione MCP (RFC 9728).