Microsoft Clarity, verificado

Q: Does Microsoft Clarity need an API key?

Yes. It reads CLARITY_API_TOKEN from its environment, and CLARITY_API_TOKEN is a secret. Put the value in your client’s config on your own machine, never in a shared file.

Q: What can Microsoft Clarity do?

It has 3 tools: list-session-recordings, query-documentation-data y query-analytics-data. You can query traffic and behavior metrics with natural language, filter data by dimensions such as browser, device and country y list session recordings with duration and interaction timeline.

Servidor MCP de Microsoft · Verificado

Query Clarity traffic and behavior metrics, list session recordings and search Clarity documentation in plain language.

Se ejecuta en localSe ejecuta con npxRequiere clave API

Instalar Microsoft Clarity

Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:

npx -y @microsoft/clarity-mcp-server

Requiere Node.js en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.

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

Añadir a Cursor

Descripción

Connects an assistant to Microsoft Clarity through its data export API. You can ask natural language questions about traffic and user behavior metrics, list session recordings with timeline information, and pull snippets from the Clarity documentation.

Runs locally over stdio with npx (@microsoft/clarity-mcp-server) and needs Node.js. A Clarity data export API token is required, passed with the --clarity_api_token argument. The token is generated in the Clarity project settings under Data Export.

Qué puedes hacer

Query traffic and behavior metrics with natural language
Filter data by dimensions such as browser, device and country
List session recordings with duration and interaction timeline
Search Microsoft Clarity documentation for setup and troubleshooting answers

Herramientas 3

list-session-recordings
List session recordings with session link, duration and a timeline of user interactions.
query-documentation-data
Fetch Clarity documentation snippets for setup, features, usage and troubleshooting questions.
query-analytics-data
Fetch Clarity analytics data using a focused natural language query with an explicit time range.

Tomadas del manifiesto del paquete, no de una conexión en directo, el 3 oct 2026.

Prompts de ejemplo

How many Clarity sessions did we get from Egypt in the past 3 days?
What are the most used browsers in my Clarity project?
List the most recent Clarity sessions from mobile devices
How do I track custom events using Microsoft Clarity?

Configuración

Todos los clientes inician Microsoft Clarity en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.

Claude Code

Run this in a terminal, in your project folder:

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

Start Claude Code and type /mcp. clarity should show as connected.

Add --scope user to make it available in every project. Replace the placeholders with your own values.

Claude Desktop

Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:

claude_desktop_config.json

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

Save the file and restart Claude Desktop. Replace the placeholders with your own values.

Needs Node.js on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Añadir a Cursor (se abre en una pestaña nueva)

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json

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

Needs Node.js on your computer. Replace the placeholders with your own values.

VS Code

Add it to .vscode/mcp.json. VS Code asks for the secret the first time and stores it securely:

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

Needs Node.js on your computer.

Devin Desktop

Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %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>"
      }
    }
  }
}

Refresh the MCP server list in Cascade. Replace the placeholders with your own values.

Devin Desktop is the new name for Windsurf.

Codex

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

Or edit ~/.codex/config.toml directly:

config.toml

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

Needs Node.js on your computer. Replace the placeholders with your own values.

Gemini CLI

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

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

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

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs Node.js on your computer. Replace the placeholders with your own values.

Preguntas frecuentes

Can I paste mcp.tc/i/clarity into my MCP client?

No. Microsoft Clarity runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is npx -y @microsoft/clarity-mcp-server.

Does Microsoft Clarity need an API key?

Yes. It reads CLARITY_API_TOKEN from its environment, and CLARITY_API_TOKEN is a secret. Put the value in your client’s config on your own machine, never in a shared file.

Is Microsoft Clarity a remote or a local server?

Local. Your client starts it as a process on your computer with npx -y @microsoft/clarity-mcp-server, which needs Node.js.

What can Microsoft Clarity do?

It has 3 tools: list-session-recordings, query-documentation-data y query-analytics-data. You can query traffic and behavior metrics with natural language, filter data by dimensions such as browser, device and country y list session recordings with duration and interaction timeline.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Who wrote this page?

mcp.tc’s robot read Microsoft Clarity’s public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

Insertar

Muestra Microsoft Clarity en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones

Insignia para README

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>

Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.

Tarjeta para web

HTML

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

La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.

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>

Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.

JSON

La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).

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

Qué significa cada campo

mcp.tc no tiene relación con Microsoft. Esta página se creó a partir de los metadatos públicos de Microsoft Clarity, comprobados por última vez el 3 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha.

Instalar Microsoft Clarity

Compartir este servidor

Descripción

Qué puedes hacer

Herramientas 3

Prompts de ejemplo

Configuración

Claude Code

Claude Desktop

Cursor

VS Code

Devin Desktop

Codex

Gemini CLI

Any client

Preguntas frecuentes

Insertar

Insignia para README

Tarjeta para web

iframe

JSON

Servidores relacionados

Microsoft Fabric, verificado

Power BI Modeling, verificado

Power BI (Fabric IQ), verificado

Azure DevOps, verificado

MarkItDown, verificado

Awesome Copilot