Microsoft Clarity MCP Server
Collega senza soluzione di continuità i tuoi strumenti AI con le analisi di Microsoft Clarity per sbloccare insight web azionabili, report personalizzati e analisi del coinvolgimento degli utenti—tutto accessibile tramite il protocollo MCP.

Cosa fa il server MCP “Microsoft Clarity”?
Il Microsoft Clarity MCP Server è un server Model Context Protocol (MCP) progettato per interfacciarsi con l’API di esportazione dati di Microsoft Clarity. Agisce come ponte tra assistenti AI (come Claude for Desktop e altri client compatibili MCP) e il servizio di analytics Clarity. Espone i dati analitici di Clarity tramite un protocollo standard, consentendo flussi di lavoro AI come interrogazioni sulle analytics del sito web, filtraggio per dimensioni specifiche (es. Browser, Dispositivo, Paese/Regione) e recupero di diverse metriche web (es. Profondità di Scorrimento, Tempo di Coinvolgimento, Traffico). Questa integrazione semplifica compiti come il monitoraggio delle prestazioni del sito e l’analisi del coinvolgimento degli utenti, permettendo a sviluppatori e analisti di accedere a insight azionabili direttamente tramite i loro strumenti AI.
Elenco dei Prompt
Nessun template di prompt esplicito è menzionato nelle informazioni fornite.
Elenco delle Risorse
Nessuna specifica “risorsa” MCP è descritta nei contenuti del repository.
Elenco degli Strumenti
- get-clarity-data
Fornisce accesso ai dati di analytics Clarity. Permette interrogazioni specificando il numero di giorni (1-3), selezionando fino a tre dimensioni (come Browser, Dispositivo, Paese/Regione) e scegliendo le metriche (come Profondità di Scorrimento, Tempo di Coinvolgimento, Traffico). Richiede un token API Clarity.
Casi d’Uso di questo MCP Server
- Recupero Analisi Sito Web
Recupera istantaneamente dati chiave di analytics da Microsoft Clarity, come sessioni utente, coinvolgimento e profondità di scorrimento, per monitorare le prestazioni del sito direttamente tramite il tuo assistente AI. - Filtraggio Analitico Personalizzato
Filtra i risultati delle analisi fino a tre dimensioni (es. tipo di dispositivo, regione geografica, browser) per concentrarti su segmenti di utenti specifici per un’analisi mirata. - Reportistica Automatizzata
Genera e recupera report giornalieri o su più giorni per un sito web, semplificando le attività di reportistica regolare per product manager o analisti. - Integrazione con Flussi di Lavoro AI
Integra senza soluzione di continuità le analytics del sito web in flussi di lavoro AI più ampi, permettendo agli agenti di estrarre statistiche d’uso e informare decisioni o avviare azioni basate su dati in tempo reale.
Come configurarlo
Windsurf
- Assicurati che Node.js v16 o superiore sia installato.
- Ottieni il tuo token API di Microsoft Clarity.
- Apri il file di configurazione MCP di Windsurf.
- Aggiungi la configurazione del server MCP di Microsoft Clarity come mostrato di seguito.
- Salva la configurazione e riavvia Windsurf.
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server",
"--clarity_api_token=your-api-token-here"
]
}
}
}
Protezione delle Chiavi API:
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "your-api-token-here"
}
}
}
}
Claude
- Installa Node.js v16 o superiore.
- Genera il tuo token API Clarity.
- Apri la configurazione di Claude for Desktop:
- Windows:
%AppData%\Claude\claude_desktop_config.json
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
- Aggiungi la configurazione del server MCP.
- Salva e riavvia Claude for Desktop.
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server",
"--clarity_api_token=your-api-token-here"
]
}
}
}
Protezione delle Chiavi API:
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "your-api-token-here"
}
}
}
}
Cursor
- Verifica che Node.js v16+ sia disponibile.
- Ottieni il tuo token API Clarity dal pannello di controllo Clarity.
- Individua la configurazione MCP di Cursor.
- Aggiungi la configurazione del server come mostrato.
- Salva le modifiche e riavvia Cursor.
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server",
"--clarity_api_token=your-api-token-here"
]
}
}
}
Protezione delle Chiavi API:
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "your-api-token-here"
}
}
}
}
Cline
- Installa Node.js v16 o superiore.
- Ottieni il tuo token API da Clarity.
- Apri il file di configurazione MCP di Cline.
- Inserisci la seguente configurazione del server MCP.
- Salva e riavvia Cline.
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server",
"--clarity_api_token=your-api-token-here"
]
}
}
}
Protezione delle Chiavi API:
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "your-api-token-here"
}
}
}
}
Come usare questo MCP nei flussi
Utilizzo di MCP in FlowHunt
Per integrare i server MCP nel tuo flusso di lavoro FlowHunt, inizia aggiungendo il componente MCP al tuo flow e collegandolo al tuo agente AI:

Clicca sul componente MCP per aprire il pannello di configurazione. Nella sezione di configurazione MCP di sistema, inserisci i dettagli del tuo server MCP usando questo formato JSON:
{
"clarity-mcp": {
"transport": "streamable_http",
"url": "https://yourmcpserver.example/pathtothemcp/url"
}
}
Una volta configurato, l’agente AI sarà in grado di utilizzare questo MCP come strumento con accesso a tutte le sue funzioni e capacità. Ricordati di cambiare “clarity-mcp” con il vero nome del tuo server MCP (es. “clarity-mcp”) e sostituire l’URL con l’indirizzo del tuo server MCP.
Panoramica
Sezione | Disponibilità | Dettagli/Note |
---|---|---|
Panoramica | ✅ | |
Elenco dei Prompt | ⛔ | Nessuno trovato |
Elenco delle Risorse | ⛔ | Nessuna trovata |
Elenco degli Strumenti | ✅ | get-clarity-data |
Protezione delle Chiavi API | ✅ | Supporto variabili d’ambiente mostrato |
Supporto Sampling (meno importante in valutazione) | ⛔ | Non menzionato |
Supporto Roots | ⛔ | Non menzionato |
In base a quanto sopra, il Microsoft Clarity MCP Server fornisce un’integrazione chiara e diretta con l’API di analytics Clarity, ma è focalizzato e relativamente minimale. Copre la configurazione e l’uso essenziali, ma manca di funzionalità MCP avanzate come template di prompt, risorse MCP aggiuntive, roots e sampling.
MCP Score
Ha una LICENSE | ✅ (MIT) |
---|---|
Ha almeno uno strumento | ✅ |
Numero di Forks | 5 |
Numero di Stars | 15 |
La nostra opinione:
Questo MCP server è funzionale, ben documentato per la configurazione ed espone uno strumento utile per l’integrazione delle analytics. Tuttavia, manca di funzionalità MCP più ricche come template di prompt, esposizione di risorse o capacità avanzate quali sampling e roots—rendendolo più utilitaristico che completo. Ottiene un 5/10 per coprire le basi con chiarezza, ma senza sfruttare appieno il potenziale del protocollo MCP.
Domande frequenti
- A cosa serve il Microsoft Clarity MCP Server?
Collega gli assistenti AI con l'API di analisi di Microsoft Clarity, consentendo l'accesso programmato a metriche del sito web come traffico, tempo di coinvolgimento e profondità di scorrimento. Questo permette ai flussi di lavoro guidati da AI di ottenere insight in tempo reale e capacità di reporting sul sito web.
- Quali metriche di analisi posso accedere tramite questo server MCP?
Puoi accedere a metriche come Profondità di Scorrimento, Tempo di Coinvolgimento, Traffico e analisi segmentate per Browser, Dispositivo, Paese/Regione e altro—utilizzando lo strumento 'get-clarity-data' fornito.
- Come posso proteggere il mio token API di Clarity durante la configurazione del server?
Dovresti utilizzare la proprietà 'env' nella configurazione del server MCP per conservare in sicurezza le chiavi API sensibili come variabili d'ambiente, invece di inserirle direttamente nei file di configurazione.
- Posso usare questo server MCP nei flussi di lavoro FlowHunt?
Sì! Aggiungi il componente MCP nel tuo flow di FlowHunt e configurarlo con i dettagli del tuo server MCP. In questo modo i tuoi agenti AI potranno accedere a tutti gli strumenti di analisi esposti dal server Clarity MCP.
- Il Microsoft Clarity MCP Server supporta template di prompt o funzionalità MCP avanzate?
No, è focalizzato sull'integrazione delle analisi e non include template di prompt, esposizione di risorse o funzionalità MCP avanzate come roots o sampling.
Integra Microsoft Clarity nei tuoi flussi di lavoro AI
Dai potere ai tuoi agenti AI di accedere alle analisi di Microsoft Clarity per un monitoraggio avanzato del sito web, segmentazione e reportistica automatizzata grazie all'integrazione MCP di FlowHunt.