Nous et des tiers sélectionnés utilisons des cookies ou des technologies similaires à des fins techniques et, avec votre consentement, pour analyser l’utilisation du site.

Vous pouvez librement donner, refuser ou retirer votre consentement à tout moment.

Microsoft Clarity, vérifié

Serveur MCP par Microsoft · Vérifié

Interroger les métriques de trafic et de comportement de Clarity, lister les enregistrements de sessions et chercher dans la documentation Clarity en langage naturel.

S’exécute en local (Tourne sur votre machine : sa page donne la commande d’installation)S’exécute avec npxClé API requise

Installer Microsoft Clarity

Tourne sur votre machine. Votre client le lance avec cette commande :

npx -y @microsoft/clarity-mcp-server

Nécessite Node.js sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.

  • CLARITY_API_TOKEN secret Clarity data export API token (or pass --clarity_api_token).

Partager ce serveur

Ouvre cette page, avec la commande d’installation et les étapes de configuration.

mcp.tc/i/clarity

Présentation

Connecte un assistant à Microsoft Clarity via son API d’export de données. Vous pouvez poser des questions en langage naturel sur les métriques de trafic et de comportement des utilisateurs, lister les enregistrements de sessions avec leur chronologie et extraire des passages de la documentation Clarity.

S’exécute en local via stdio avec npx (@microsoft/clarity-mcp-server) et nécessite Node.js. Un jeton de l’API d’export de données Clarity est requis, transmis avec l’argument --clarity_api_token. Le jeton se génère dans les paramètres du projet Clarity, sous Data Export.

Ce que vous pouvez faire

  • Interroger les métriques de trafic et de comportement en langage naturel
  • Filtrer les données par dimensions telles que navigateur, appareil et pays
  • Lister les enregistrements de sessions avec durée et chronologie des interactions
  • Chercher dans la documentation Microsoft Clarity des réponses sur la configuration et le dépannage

Outils 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

    Lister les enregistrements de sessions avec le lien de session, la durée et une chronologie des interactions des utilisateurs.

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

Afficher 18 outils de plus
  • 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…

Tirés le 3 oct. 2026 du manifeste du paquet, sans connexion au serveur.

Exemples de prompts

  • Combien de sessions Clarity avons-nous eues depuis l’Égypte ces 3 derniers jours ?

  • Quels sont les navigateurs les plus utilisés dans mon projet Clarity ?

  • Liste les sessions Clarity les plus récentes depuis des appareils mobiles

  • Comment suivre des événements personnalisés avec Microsoft Clarity ?

Configuration

Chaque client lance Microsoft Clarity sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.

Claude Code

  1. Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio clarity --env "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" -- npx -y @microsoft/clarity-mcp-server
  1. Démarrez Claude Code et tapez /mcp. clarity devrait apparaître comme connecté.

Ajoutez --scope user pour le rendre disponible dans tous vos projets. Remplacez les espaces réservés par vos propres valeurs.

Claude Desktop

  1. Ouvrez Settings → Developer → Edit Config. Cela ouvre claude_desktop_config.json. Ajoutez :
claude_desktop_config.json
{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}
  1. Enregistrez le fichier et redémarrez Claude Desktop. Remplacez les espaces réservés par vos propres valeurs.

Nécessite Node.js sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.

Cursor

Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :

mcp.json
{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

VS Code

Ajoutez-le à .vscode/mcp.json. VS Code demande le secret la première fois et le stocke de façon sécurisée :

.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
    }
  ]
}

Nécessite Node.js sur votre ordinateur.

Devin Desktop

  1. Ajoutez-le à ~/.config/devin/mcp_config.json (macOS et Linux) ou %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. Actualisez la liste des serveurs MCP dans Cascade. Remplacez les espaces réservés par vos propres valeurs.

Devin Desktop est le nouveau nom de Windsurf.

Codex

codex mcp add clarity --env "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" -- npx -y @microsoft/clarity-mcp-server

Ou modifiez directement ~/.codex/config.toml :

config.toml
[mcp_servers.clarity]
command = "npx"
args = ["-y", "@microsoft/clarity-mcp-server"]
env = { CLARITY_API_TOKEN = "<YOUR_CLARITY_API_TOKEN>" }

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

Gemini CLI

gemini mcp add -e "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" clarity npx -- -y @microsoft/clarity-mcp-server

Cela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.

Tout client

La plupart des clients qui lancent des serveurs locaux acceptent cette forme :

{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}

Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

Intégrer

Affichez Microsoft Clarity dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations

La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.

Badge pour README

Aperçu du badge, clairAperçu du badge, sombre
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>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

HTML
<script src="https://mcp.tc/w/clarity.js" async></script>

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun 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>

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

https://mcp.tc/i/clarity.json

Ce que signifie chaque champ

Prompt pour l’IA

Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de Microsoft Clarity à votre site.

Markdown
Ajoute à mon site la carte mcp.tc de Microsoft Clarity, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.

Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :

```html
<script src="https://mcp.tc/w/clarity.js" async></script>
```

Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.

```html
<div data-mcptc="clarity"><a href="https://mcp.tc/i/clarity">Microsoft Clarity on mcp.tc</a></div>
```

Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.

Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).

Pour un README ou une autre doc en Markdown, utilise plutôt le badge :

```markdown
[![Microsoft Clarity on mcp.tc](https://mcp.tc/i/clarity/badge.svg)](https://mcp.tc/i/clarity)
```

Référence : https://mcp.tc/fr/embed

Historique des changements

Nous lisons la liste d’outils du manifeste de bundle de ce serveur sur GitHub toutes les 3 heures et notons ce qui change. Dernière lecture : 18 nov. 2026, 05:31 UTC.

Suivez Microsoft Clarity et nous vous enverrons un e-mail quand quelque chose change.

  1. , Vérification automatique

    29 outils ajoutés et 2 outils retirés.

    Détails, 16 nov. 2026, 17:53 UTC

    Ajoutés 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

    Retirés 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. , Vérification automatique

    Nouvelle version 3.0.0 (avant : 2.0.1). Lue sur npm.

  3. , Vérification automatique

    Début de l’observation : 3 outils.

FAQ

Puis-je coller mcp.tc/i/clarity dans mon client MCP ?

Non. Microsoft Clarity tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est npx -y @microsoft/clarity-mcp-server.

Microsoft Clarity a-t-il besoin d’une clé API ?

Oui. Il lit CLARITY_API_TOKEN dans son environnement, et CLARITY_API_TOKEN est un secret. Mettez la valeur dans la configuration de votre client, sur votre propre machine, jamais dans un fichier partagé.

Microsoft Clarity est-il un serveur distant ou local ?

Local. Votre client le lance comme un processus sur votre ordinateur avec npx -y @microsoft/clarity-mcp-server, qui nécessite Node.js.

Que peut faire Microsoft Clarity ?

Il a 30 outils, dont login, login-status et logout. Vous pouvez interroger les métriques de trafic et de comportement en langage naturel, filtrer les données par dimensions telles que navigateur, appareil et pays et lister les enregistrements de sessions avec durée et chronologie des interactions.

Quels clients peuvent l’utiliser ?

Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.

mcp.tc suit-il les changements de Microsoft Clarity ?

Oui. Nous suivons la liste d’outils du manifeste de bundle de Microsoft Clarity, et son onglet Historique montre chaque changement que nous trouvons, ainsi que les nouvelles versions et les modifications de son propriétaire. Suivez la fiche pour recevoir un e-mail quand elle change.

Qui a rédigé cette page ?

Le robot de mcp.tc a lu les métadonnées publiques de Microsoft Clarity (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page. Cette traduction a été réalisée par un modèle d’IA à partir du texte anglais.

mcp.tc n’est pas affilié à Microsoft. Cette page a été construite à partir des métadonnées publiques de Microsoft Clarity, vérifiées pour la dernière fois le 3 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche. La traduction a été réalisée par un modèle d’IA à partir du texte anglais.