Microsoft Clarity, verificato
Server MCP di Microsoft · Verificato
Interroga metriche di traffico e comportamento di Clarity, elenca le registrazioni delle sessioni e cerca nella documentazione di Clarity in linguaggio naturale.
Installa Microsoft Clarity
Gira sul tuo computer. Il tuo client lo avvia con questo comando:
Richiede Node.js sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.
CLARITY_API_TOKENsegreto Clarity data export API token (or pass --clarity_api_token).
Condividi questo server
Apre questa pagina, con il comando di installazione e i passaggi di configurazione.
mcp.tc/i/clarityDescrizione
Collega un assistente a Microsoft Clarity tramite la sua API di esportazione dati. Puoi porre domande in linguaggio naturale su traffico e metriche di comportamento degli utenti, elencare le registrazioni delle sessioni con le informazioni della timeline e recuperare estratti dalla documentazione di Clarity.
Funziona in locale tramite stdio con npx (@microsoft/clarity-mcp-server) e richiede Node.js. Serve un token dell’API di esportazione dati di Clarity, passato con l’argomento --clarity_api_token. Il token si genera nelle impostazioni del progetto Clarity, in Data Export.
Cosa puoi fare
- Interrogare metriche di traffico e comportamento in linguaggio naturale
- Filtrare i dati per dimensioni come browser, dispositivo e paese
- Elencare le registrazioni delle sessioni con durata e timeline delle interazioni
- Cercare nella documentazione di Microsoft Clarity risposte su configurazione e risoluzione dei problemi
Tool 30
loginSign in to Microsoft Clarity with your Clarity account in the browser.
login-statusShow whether you are signed in to Microsoft Clarity and which credentials the tools use.
logoutSign out of Microsoft Clarity and remove the sign-in from this machine.
list-projectsList the Microsoft Clarity projects you can query.
select-projectChoose the Microsoft Clarity project to query; it stays selected until you choose another.
query-analytics-dashboardFetch Microsoft Clarity analytics data using a simplified natural language search query.
list-session-recordingsElenca le registrazioni delle sessioni con link alla sessione, durata e timeline delle interazioni degli utenti.
get-citation-overviewGet AI Visibility citation counts, share of authority, branded split, AI referred traffic, topic availability, and data freshness for the project's verified domain.
list-citation-queriesList AI queries that cite the project's verified domain, with citation count, share of authority, topic, and branded status.
list-citation-topicsList AI query topics that cite the project's verified domain.
list-top-cited-pagesList pages from the project's verified domain that were cited in AI answers.
get-citation-metric-trendsGet AI Visibility citation trends over time for whole-project metrics: total citations or share of authority.
Mostra altri 18 tool
get-citation-item-trendsGet AI Visibility citation trends over time for specific queries or cited pages.
get-bot-activity-overviewGet Bot Activity summary metrics including AI requests, unique HTML paths, and robots.txt compliance violations.
list-ai-crawlersList AI crawlers and their request counts for the Clarity project.
list-bot-path-requestsList paths requested by AI bots, ranked by request count.
get-bot-activity-distributionGet Bot Activity distribution by content type, page type, or HTTP status code.
get-bot-activity-metric-trendsGet Bot Activity trends over time for whole-project metrics: total requests, site pages crawled, or robots.txt violations.
get-bot-activity-item-trendsGet Bot Activity trends over time for specific crawled paths, HTTP status codes, or content types.
get-ai-crawler-trendsGet Bot Activity trends over time for specific AI crawlers.
get-scrape-to-referral-ratioGet how many AI scrapes each operator performed for every visit it referred back, with per-provider ratios and domain coverage state.
list-connected-cdn-providersList the CDN providers connected to the Clarity project, with connection status and covered domain.
get-topic-insight-constraintsGet the Topic Insights validation rules: topic name length, question count and length, weekly report limit, and regeneration cooldown.
list-topic-insightsList the project's Topic Insight topics, suggested topics, and their generated reports.
get-topic-insight-reportGet a Topic Insight report: citation rate, competitive share, competitor ranking, content strengths and opportunities.
get-topic-insight-statusGet the generation status of Topic Insight report runs.
create-topic-insight-reportCreate a Topic Insight topic and start generating its report.
regenerate-topic-insight-reportRegenerate the report for an existing Topic Insight topic.
delete-topic-insightDelete a Topic Insight topic and its reports.
query-documentation-resourcesRetrieve Microsoft Clarity documentation snippets for finding answers to user questions including step-by-step screenshots for setup guides, features, usage, troubleshooting, and integration…
Dal manifest del pacchetto, non da una connessione attiva (3 ott 2026).
Prompt di esempio
Quante sessioni Clarity abbiamo ricevuto dall’Egitto negli ultimi 3 giorni?
Quali sono i browser più usati nel mio progetto Clarity?
Elenca le sessioni Clarity più recenti da dispositivi mobili
Come tengo traccia degli eventi personalizzati con Microsoft Clarity?
Configurazione
Ogni client avvia Microsoft Clarity sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.
Claude Code
- Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio clarity --env "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" -- npx -y @microsoft/clarity-mcp-server- Avvia Claude Code e digita
/mcp. clarity dovrebbe risultare collegato.
Aggiungi --scope user per renderlo disponibile in tutti i progetti. Sostituisci i segnaposto con i tuoi valori.
Claude Desktop
- Apri Settings → Developer → Edit Config. Si apre
claude_desktop_config.json. Aggiungi:
{
"mcpServers": {
"clarity": {
"command": "npx",
"args": [
"-y",
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
}
}
}
}- Salva il file e riavvia Claude Desktop. Sostituisci i segnaposto con i tuoi valori.
Richiede Node.js sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.
Cursor
Aggiungi a Cursor (si apre in una nuova scheda)
Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):
{
"mcpServers": {
"clarity": {
"command": "npx",
"args": [
"-y",
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
}
}
}
}Richiede Node.js sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
VS Code
Aggiungilo a .vscode/mcp.json. VS Code chiede il segreto la prima volta e lo conserva in modo sicuro:
{
"servers": {
"clarity": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "${input:clarity-api-token}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "clarity-api-token",
"description": "CLARITY_API_TOKEN",
"password": true
}
]
}Richiede Node.js sul tuo computer.
Devin Desktop
- Aggiungilo a
~/.config/devin/mcp_config.json(macOS e Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"clarity": {
"command": "npx",
"args": [
"-y",
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
}
}
}
}- Aggiorna l’elenco dei server MCP in Cascade. Sostituisci i segnaposto con i tuoi valori.
Devin Desktop è il nuovo nome di Windsurf.
Codex
codex mcp add clarity --env "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" -- npx -y @microsoft/clarity-mcp-serverOppure modifica direttamente ~/.codex/config.toml:
[mcp_servers.clarity]
command = "npx"
args = ["-y", "@microsoft/clarity-mcp-server"]
env = { CLARITY_API_TOKEN = "<YOUR_CLARITY_API_TOKEN>" }Richiede Node.js sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
Gemini CLI
gemini mcp add -e "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" clarity npx -- -y @microsoft/clarity-mcp-serverCosì lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.
Qualsiasi client
La maggior parte dei client che avviano server locali accetta questa forma:
{
"mcpServers": {
"clarity": {
"command": "npx",
"args": [
"-y",
"@microsoft/clarity-mcp-server"
],
"env": {
"CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
}
}
}
}Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.
Richiede Node.js sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
Embed
Mostra Microsoft Clarity in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed
Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.
Badge per il README
[](https://mcp.tc/i/clarity)<a href="https://mcp.tc/i/clarity"><img src="https://mcp.tc/i/clarity/badge.svg" alt="Microsoft Clarity on mcp.tc" height="20"></a>Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.
Card per il sito
<script src="https://mcp.tc/w/clarity.js" async></script>La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.
iframe
<iframe src="https://mcp.tc/embed/clarity" title="Microsoft Clarity on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.
JSON
La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).
https://mcp.tc/i/clarity.jsonPrompt per l’AI
Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di Microsoft Clarity al tuo sito.
Aggiungi al mio sito la card di mcp.tc per Microsoft Clarity, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.
Metti questo tag dove deve comparire la card. La card appare subito prima del tag:
```html
<script src="https://mcp.tc/w/clarity.js" async></script>
```
Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.
```html
<div data-mcptc="clarity"><a href="https://mcp.tc/i/clarity">Microsoft Clarity on mcp.tc</a></div>
```
Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.
Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).
Per un README o altra documentazione in Markdown, usa invece il badge:
```markdown
[](https://mcp.tc/i/clarity)
```
Riferimento: https://mcp.tc/it/embedCronologia delle modifiche
Leggiamo ogni 3 ore l’elenco dei tool nel manifest del bundle di questo server su GitHub e registriamo cosa cambia. Ultima lettura: 18 nov 2026, 05:31 UTC.
-
29 tool aggiunti e 2 tool rimossi.
Dettagli, 16 nov 2026, 17:53 UTC
Aggiunti 29
create-topic-insight-reportCreate a Topic Insight topic and start generating its report.
delete-topic-insightDelete a Topic Insight topic and its reports.
get-ai-crawler-trendsGet Bot Activity trends over time for specific AI crawlers.
get-bot-activity-distributionGet Bot Activity distribution by content type, page type, or HTTP status code.
get-bot-activity-item-trendsGet Bot Activity trends over time for specific crawled paths, HTTP status codes, or content types.
get-bot-activity-metric-trendsGet Bot Activity trends over time for whole-project metrics: total requests, site pages crawled, or robots.txt violations.
get-bot-activity-overviewGet Bot Activity summary metrics including AI requests, unique HTML paths, and robots.txt compliance violations.
get-citation-item-trendsGet AI Visibility citation trends over time for specific queries or cited pages.
get-citation-metric-trendsGet AI Visibility citation trends over time for whole-project metrics: total citations or share of authority.
get-citation-overviewGet AI Visibility citation counts, share of authority, branded split, AI referred traffic, topic availability, and data freshness for the project's verified domain.
get-scrape-to-referral-ratioGet how many AI scrapes each operator performed for every visit it referred back, with per-provider ratios and domain coverage state.
get-topic-insight-constraintsGet the Topic Insights validation rules: topic name length, question count and length, weekly report limit, and regeneration cooldown.
get-topic-insight-reportGet a Topic Insight report: citation rate, competitive share, competitor ranking, content strengths and opportunities.
get-topic-insight-statusGet the generation status of Topic Insight report runs.
list-ai-crawlersList AI crawlers and their request counts for the Clarity project.
list-bot-path-requestsList paths requested by AI bots, ranked by request count.
list-citation-queriesList AI queries that cite the project's verified domain, with citation count, share of authority, topic, and branded status.
list-citation-topicsList AI query topics that cite the project's verified domain.
list-connected-cdn-providersList the CDN providers connected to the Clarity project, with connection status and covered domain.
list-projectsList the Microsoft Clarity projects you can query.
list-top-cited-pagesList pages from the project's verified domain that were cited in AI answers.
list-topic-insightsList the project's Topic Insight topics, suggested topics, and their generated reports.
loginSign in to Microsoft Clarity with your Clarity account in the browser.
login-statusShow whether you are signed in to Microsoft Clarity and which credentials the tools use.
logoutSign out of Microsoft Clarity and remove the sign-in from this machine.
query-analytics-dashboardquery-documentation-resourcesregenerate-topic-insight-reportselect-projectRimossi 2
query-analytics-dataFetch Microsoft Clarity analytics data using a simplified natural language search query. The query should be focused on one specific data retrieval or aggregation task. Avoid complex multi-purpose queries. Time ranges should be explicitly specified when possible. If no time range is provided, prompt the user to specify one.
query-documentation-dataFetch Microsoft Clarity documentation snippets for finding answers to user questions including step-by-step screenshots for setup guides, features, usage, troubleshooting, and integration instructions. The query should be focused on one specific documentation topic or question. Avoid complex multi-purpose queries.
-
Nuova versione 3.0.0 (prima 2.0.1). Letta da npm.
-
Inizio del tracciamento: 3 tool.
Domande frequenti
Posso incollare mcp.tc/i/clarity nel mio client MCP?
No. Microsoft Clarity gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è npx -y @microsoft/clarity-mcp-server.
Microsoft Clarity richiede una chiave API?
Sì. Legge CLARITY_API_TOKEN dal suo ambiente, e CLARITY_API_TOKEN è un segreto. Metti il valore nella configurazione del tuo client sul tuo computer, mai in un file condiviso.
Microsoft Clarity è un server remoto o locale?
Locale. Il tuo client lo avvia come processo sul tuo computer con npx -y @microsoft/clarity-mcp-server, che richiede Node.js.
Cosa può fare Microsoft Clarity?
Ha 30 tool, tra cui login, login-status e logout. Puoi interrogare metriche di traffico e comportamento in linguaggio naturale, filtrare i dati per dimensioni come browser, dispositivo e paese e elencare le registrazioni delle sessioni con durata e timeline delle interazioni.
Quali client possono usarlo?
Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.
mcp.tc tiene traccia delle modifiche di Microsoft Clarity?
Sì. Seguiamo l’elenco dei tool nel manifest del bundle di Microsoft Clarity, e la sua sezione Cronologia mostra ogni modifica che troviamo, più le nuove versioni e le modifiche di chi lo gestisce. Segui la scheda per ricevere un’email quando cambia.
Chi ha scritto questa pagina?
Il robot di mcp.tc ha letto i metadati pubblici di Microsoft Clarity (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina. Questa traduzione è stata fatta da un modello di AI a partire dal testo inglese.
mcp.tc non è affiliato a Microsoft. Questa pagina è stata creata a partire dai metadati pubblici di Microsoft Clarity (ultimo controllo: 3 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda. La traduzione è stata fatta da un modello di AI a partire dal testo inglese.