Noi e terze parti selezionate usiamo cookie o tecnologie simili per finalità tecniche e, con il tuo consenso, per analizzare l’uso del sito.

Puoi liberamente prestare, negare o revocare il tuo consenso in qualsiasi momento.

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.

Gira in locale (Gira sul tuo computer: la sua pagina riporta il comando di installazione)Gira con npxServe una chiave API

Installa Microsoft Clarity

Gira sul tuo computer. Il tuo client lo avvia con questo comando:

npx -y @microsoft/clarity-mcp-server

Richiede Node.js sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.

  • CLARITY_API_TOKEN segreto 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/clarity

Descrizione

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

  • login

    Sign in to Microsoft Clarity with your Clarity account in the browser.

  • login-status

    Show whether you are signed in to Microsoft Clarity and which credentials the tools use.

  • logout

    Sign out of Microsoft Clarity and remove the sign-in from this machine.

  • list-projects

    List the Microsoft Clarity projects you can query.

  • select-project

    Choose the Microsoft Clarity project to query; it stays selected until you choose another.

  • query-analytics-dashboard

    Fetch Microsoft Clarity analytics data using a simplified natural language search query.

  • list-session-recordings

    Elenca le registrazioni delle sessioni con link alla sessione, durata e timeline delle interazioni degli utenti.

  • get-citation-overview

    Get 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-queries

    List AI queries that cite the project's verified domain, with citation count, share of authority, topic, and branded status.

  • list-citation-topics

    List AI query topics that cite the project's verified domain.

  • list-top-cited-pages

    List pages from the project's verified domain that were cited in AI answers.

  • get-citation-metric-trends

    Get AI Visibility citation trends over time for whole-project metrics: total citations or share of authority.

Mostra altri 18 tool
  • get-citation-item-trends

    Get AI Visibility citation trends over time for specific queries or cited pages.

  • get-bot-activity-overview

    Get Bot Activity summary metrics including AI requests, unique HTML paths, and robots.txt compliance violations.

  • list-ai-crawlers

    List AI crawlers and their request counts for the Clarity project.

  • list-bot-path-requests

    List paths requested by AI bots, ranked by request count.

  • get-bot-activity-distribution

    Get Bot Activity distribution by content type, page type, or HTTP status code.

  • get-bot-activity-metric-trends

    Get Bot Activity trends over time for whole-project metrics: total requests, site pages crawled, or robots.txt violations.

  • get-bot-activity-item-trends

    Get Bot Activity trends over time for specific crawled paths, HTTP status codes, or content types.

  • get-ai-crawler-trends

    Get Bot Activity trends over time for specific AI crawlers.

  • get-scrape-to-referral-ratio

    Get how many AI scrapes each operator performed for every visit it referred back, with per-provider ratios and domain coverage state.

  • list-connected-cdn-providers

    List the CDN providers connected to the Clarity project, with connection status and covered domain.

  • get-topic-insight-constraints

    Get the Topic Insights validation rules: topic name length, question count and length, weekly report limit, and regeneration cooldown.

  • list-topic-insights

    List the project's Topic Insight topics, suggested topics, and their generated reports.

  • get-topic-insight-report

    Get a Topic Insight report: citation rate, competitive share, competitor ranking, content strengths and opportunities.

  • get-topic-insight-status

    Get the generation status of Topic Insight report runs.

  • create-topic-insight-report

    Create a Topic Insight topic and start generating its report.

  • regenerate-topic-insight-report

    Regenerate the report for an existing Topic Insight topic.

  • delete-topic-insight

    Delete a Topic Insight topic and its reports.

  • query-documentation-resources

    Retrieve 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

  1. 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
  1. 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

  1. Apri Settings → Developer → Edit Config. Si apre claude_desktop_config.json. Aggiungi:
claude_desktop_config.json
{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}
  1. 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

Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):

mcp.json
{
  "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:

.vscode/mcp.json
{
  "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

  1. Aggiungilo a ~/.config/devin/mcp_config.json (macOS e Linux) o a %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}
  1. 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-server

Oppure modifica direttamente ~/.codex/config.toml:

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-server

Così 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

Anteprima del badge, chiaroAnteprima del badge, scuro
Markdown
[![Microsoft Clarity on mcp.tc](https://mcp.tc/i/clarity/badge.svg)](https://mcp.tc/i/clarity)
HTML
<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

HTML
<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

HTML
<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.json

Cosa significa ogni campo

Prompt 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.

Markdown
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
[![Microsoft Clarity on mcp.tc](https://mcp.tc/i/clarity/badge.svg)](https://mcp.tc/i/clarity)
```

Riferimento: https://mcp.tc/it/embed

Cronologia 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.

Segui Microsoft Clarity e ti mandiamo un’email quando qualcosa cambia.

  1. , Controllo automatico

    29 tool aggiunti e 2 tool rimossi.

    Dettagli, 16 nov 2026, 17:53 UTC

    Aggiunti 29

    • create-topic-insight-report

      Create a Topic Insight topic and start generating its report.

    • delete-topic-insight

      Delete a Topic Insight topic and its reports.

    • get-ai-crawler-trends

      Get Bot Activity trends over time for specific AI crawlers.

    • get-bot-activity-distribution

      Get Bot Activity distribution by content type, page type, or HTTP status code.

    • get-bot-activity-item-trends

      Get Bot Activity trends over time for specific crawled paths, HTTP status codes, or content types.

    • get-bot-activity-metric-trends

      Get Bot Activity trends over time for whole-project metrics: total requests, site pages crawled, or robots.txt violations.

    • get-bot-activity-overview

      Get Bot Activity summary metrics including AI requests, unique HTML paths, and robots.txt compliance violations.

    • get-citation-item-trends

      Get AI Visibility citation trends over time for specific queries or cited pages.

    • get-citation-metric-trends

      Get AI Visibility citation trends over time for whole-project metrics: total citations or share of authority.

    • get-citation-overview

      Get 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-ratio

      Get how many AI scrapes each operator performed for every visit it referred back, with per-provider ratios and domain coverage state.

    • get-topic-insight-constraints

      Get the Topic Insights validation rules: topic name length, question count and length, weekly report limit, and regeneration cooldown.

    • get-topic-insight-report

      Get a Topic Insight report: citation rate, competitive share, competitor ranking, content strengths and opportunities.

    • get-topic-insight-status

      Get the generation status of Topic Insight report runs.

    • list-ai-crawlers

      List AI crawlers and their request counts for the Clarity project.

    • list-bot-path-requests

      List paths requested by AI bots, ranked by request count.

    • list-citation-queries

      List AI queries that cite the project's verified domain, with citation count, share of authority, topic, and branded status.

    • list-citation-topics

      List AI query topics that cite the project's verified domain.

    • list-connected-cdn-providers

      List the CDN providers connected to the Clarity project, with connection status and covered domain.

    • list-projects

      List the Microsoft Clarity projects you can query.

    • list-top-cited-pages

      List pages from the project's verified domain that were cited in AI answers.

    • list-topic-insights

      List the project's Topic Insight topics, suggested topics, and their generated reports.

    • login

      Sign in to Microsoft Clarity with your Clarity account in the browser.

    • login-status

      Show whether you are signed in to Microsoft Clarity and which credentials the tools use.

    • logout

      Sign out of Microsoft Clarity and remove the sign-in from this machine.

    query-analytics-dashboard query-documentation-resources regenerate-topic-insight-report select-project

    Rimossi 2

    • query-analytics-data

      Fetch 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-data

      Fetch 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.

  2. , Controllo automatico

    Nuova versione 3.0.0 (prima 2.0.1). Letta da npm.

  3. , Controllo automatico

    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.