이 서버는 Microsoft Clarity용 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude for Desktop 또는 기타 MCP 호환 클라이언트를 통해 Clarity의 세션 녹화, 프로젝트 분석, 문서에 접근할 수 있습니다.

주요 특징

• 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