Это сервер Model Context Protocol (MCP) для Microsoft Clarity. Он позволяет получать доступ к записям сессий, аналитике проектов и документации из Clarity с помощью Claude for Desktop или других совместимых с MCP клиентами.

Ключевые особенности

• Analytics Data Access: Запросите данные Microsoft Clarity, включая метрики трафика, инсайты поведения пользователей и статистику производительности
• Поиск записи сессии: доступ и анализ записей сессий для понимания взаимодействия пользователей и выявления возможностей оптимизации
• Запросы на естественном языке: Задавайте вопросы на простом английском, чтобы получить инсайты из данных — не нужно учить сложный синтаксис запросов или API
• Гибкая фильтрация данных: Фильтруйте результаты по различным параметрам, таким как браузер, устройство, страна и многие другие
• Доступ к данным в реальном времени: Получите последние аналитические данные и инсайты из ваших проектов Clarity по запросу
• Интеграция документации: Получите быстрые ответы и рекомендации от документации Microsoft Clarity непосредственно в вашем рабочем процессе

Microsoft Clarity MCP Server

This is a Model Context Protocol (MCP) server for the Microsoft Clarity. It allows you to access your session recordings, project analytics, and documentation from Clarity using Claude for Desktop or other MCP-compatible clients.

Key Features

• Analytics Data Access: Query your Microsoft Clarity analytics data including traffic metrics, user behavior insights, and performance statistics
• Session Recording Retrieval: Access and analyze session recordings to understand user interactions and identify optimization opportunities
• Natural Language Querying: Ask questions in plain English to get insights from your data - no need to learn complex query syntax or API endpoints
• Flexible Data Filtering: Filter results by various dimensions such as browser, device, country, and many more
• Real-Time Data Access: Fetch the latest analytics data and insights from your Clarity projects on-demand
• Documentation Integration: Get quick answers and guidance from Microsoft Clarity documentation directly within your workflow
• Seamless MCP Integration: Works natively with Claude for Desktop, Visual Studio Code, and other Model Context Protocol (MCP) compatible clients

Setup and Installation

Prerequisites

• Node.js v16 or higher
• A Microsoft Clarity account and API token
• Any MCP-compatible client (Claude for Desktop, etc.)

Installation

Option 1: Install via npm (recommended)

You can install and run this package directly using npm:

# Install globally
npm install -g @microsoft/clarity-mcp-server

# Run the server
clarity-mcp-server

Option 2: Run with npx without installing

You can run the server directly using npx without installing:

npx @microsoft/clarity-mcp-server

With either option, you can provide your Clarity API token using the --clarity_api_token parameter:

npx @microsoft/clarity-mcp-server --clarity_api_token=your-token-here

Option 3: Manual Installation

1. Clone or download this repository
2. Install dependencies:

   npm install
   

3. Build the TypeScript code:

   npm run build
   

4. Run the server:

   npm run start
   

Extension/Plugin Installation

Visual Studio Code Extension

Click the button above to install the Microsoft Clarity MCP server directly in Visual Studio Code.

Claude Desktop Plugin

Install from Claude’s extension gallery:

1. Open Claude Desktop
2. Navigate to File → Settings → Extensions
3. Search for Microsoft Clarity
4. Click Install to add the extension