Microsoft Clarity MCP Server

@urdigital/mcp-server-clarity

Un servidor MCP (Model Context Protocol) que expone los análisis de comportamiento de Microsoft Clarity a Claude, Claude Code y cualquier otro cliente compatible con MCP.

Instalación

No se necesita instalación: ejecútalo directamente con npx:

   npx -y @urdigital/mcp-server-clarity

Configuración

Obtén un token desde tu proyecto de Clarity → Configuración → Exportación de datos → Generar nuevo token de API. Los tokens están limitados a un solo proyecto: necesitas un token separado por proyecto si estás rastreando varios sitios.

Añádelo a la configuración de tu cliente MCP (por ejemplo, el claude_desktop_config.json de Claude Desktop):

   {
     "mcpServers": {
       "clarity": {
         "command": "npx",
         "args": ["-y", "@urdigital/mcp-server-clarity"],
         "env": { "CLARITY_API_TOKEN": "your-project-token" }
       }
     }
   }

Herramientas

Herramienta	Descripción
clarity_get_insights	Análisis de comportamiento para el proyecto configurado: tráfico, interacción, profundidad de desplazamiento y señales de frustración (clics de ira, clics muertos, clics de retroceso rápido, errores de script)

Comportamiento importante, confirmado mediante pruebas con un proyecto real

La API de Exportación de Datos de Clarity es un único endpoint estrecho con limitaciones reales que vale la pena conocer antes de construir sobre ella:

• Solo se pueden recuperar los últimos 1-3 días de datos. No hay forma de consultar datos más antiguos a través de esta API.
• Sin dimensiones vs. con dimensiones es un intercambio, no algo aditivo. Llamar sin dimension1/2/3 devuelve una instantánea amplia de 16 categorías (tráfico, interacción, métricas de frustración, más desgloses por Navegador/Dispositivo/SO/País/TítuloDePágina/UrlDeReferencia/PáginasPopulares). Especificar cualquier dimensión reemplaza por completo eso con un conjunto de métricas más reducido (solo frustración + interacción + tráfico), tabulado de forma cruzada por la(s) dimensión(es) que hayas indicado. Obtienes profundidad en un eje o amplitud en muchos, pero no ambos en la misma llamada.
• numOfDays se valida; los nombres de las dimensiones no. Un numOfDays fuera de rango (cualquier valor que no sea 1, 2 o 3) devuelve un error HTTP 400 con cuerpo vacío, sin mensaje de error. Un nombre de dimensión inválido, en cambio, devuelve HTTP 200 y cae silenciosamente en la instantánea predeterminada sin dimensiones en lugar de dar error. Esta herramienta restringe las entradas de dimensión a una enumeración estricta de los valores válidos precisamente por esta razón: es la única salvaguarda real contra un resultado silenciosamente incorrecto, ya que Clarity mismo no te lo indicará.
• Cuota diaria pequeña de solicitudes por proyecto (Clarity no expone tu recuento exacto restante en ningún lugar de la respuesta de la API): elige numOfDays y las dimensiones deliberadamente en lugar de sondear repetidamente.

Licencia

MIT