도구 연결(MCP)
Microsoft Clarity MCP Server
도우미에게 내 웹사이트의 Clarity 방문 데이터와 세션 녹화에 관해 질문할 수 있습니다.
설치 방법
macOS / Linux · Claude Desktop 설정 파일붙여 넣을 설정
- 다음 명령어는 macOS 또는 Linux 터미널에서 실행하세요.
- 프로젝트에서 요구하는 버전의 Node.js와 npm을 먼저 설치하세요.
- 해당 서비스 계정이 필요합니다. 요금제와 권한을 확인하세요.
- 해당 서비스에서 API 키를 발급받아 로컬 설정에만 입력하세요.
- 기존 설정에 병합하고 다른 도구와 설정은 유지하세요.
- 실행하거나 저장하기 전에 아래 자리표시자 값을 바꾸세요.
- 설정을 저장한 뒤 도우미나 편집기를 다시 시작하거나 새로고침하세요.
Claude Desktop 설정 파일
설정 파일 ~/Library/Application Support/Claude/claude_desktop_config.json
다음 값 바꾸기: YOUR_CLARITY_API_TOKEN
{
"mcpServers": {
"clarity": {
"command": "npx",
"args": [
"-y",
"@microsoft/clarity-mcp-server",
"--clarity_api_token=YOUR_CLARITY_API_TOKEN"
]
}
}
}Cursor MCP 설정붙여 넣을 설정
- 프로젝트에서 요구하는 버전의 Node.js와 npm을 먼저 설치하세요.
- 해당 서비스 계정이 필요합니다. 요금제와 권한을 확인하세요.
- 해당 서비스에서 API 키를 발급받아 로컬 설정에만 입력하세요.
- 기존 설정에 병합하고 다른 도구와 설정은 유지하세요.
- 실행하거나 저장하기 전에 아래 자리표시자 값을 바꾸세요.
- 설정을 저장한 뒤 도우미나 편집기를 다시 시작하거나 새로고침하세요.
Cursor MCP 설정
설정 파일 ~/.cursor/mcp.json
다음 값 바꾸기: YOUR_CLARITY_API_TOKEN
{
"mcpServers": {
"clarity": {
"command": "npx",
"args": [
"-y",
"@microsoft/clarity-mcp-server",
"--clarity_api_token=YOUR_CLARITY_API_TOKEN"
]
}
}
}요구 사항, 비용 및 자세한 단계
시작하기
준비 사항
- 현재 Node.js LTS 버전, npm과 MCP 지원 클라이언트를 준비합니다.
- Clarity 계정과 대상 사이트 데이터를 이미 수집하는 프로젝트가 필요합니다.
- Clarity의 Settings → Data Export에서 프로젝트 API 토큰을 만들고 로컬 클라이언트 설정에서만 YOUR_CLARITY_API_TOKEN을 바꾸세요.
제한 및 비용
- 조회 가능한 데이터, 기간과 요청 한도는 Clarity 서비스 및 프로젝트 권한에 따라 달라집니다.
- 세션 녹화에는 민감한 사이트 활동이 포함될 수 있으므로 허가된 도우미와 담당자에게만 공유하세요.
- 분석을 대신하거나 사용자가 이탈한 이유를 증명하지 않습니다. 사이트 추적 코드나 동의 설정도 구성하지 않습니다.
공개 문서를 기반으로 합니다. 모든 프로젝트를 직접 설치해 테스트하지는 않았습니다.
소개
Microsoft Clarity MCP Server는 MCP 지원 도우미를 이미 사용하는 Clarity 프로젝트에 연결합니다. 방문 수, 기기와 사용자 행동을 질문한 뒤 관련 세션 녹화를 찾아 혼란스러운 페이지나 막힌 흐름을 조사할 수 있습니다. 기존 분석 데이터를 조회하는 도구이며 설치만으로 웹사이트에 Clarity 추적 코드가 추가되거나 방문 데이터가 생성되지는 않습니다.
활용 방법
- 일상적인 질문으로 Clarity 분석 데이터를 조회합니다.
- 지원하는 필터와 정렬로 세션 녹화를 찾습니다.
- 도우미에서 Clarity 사용 문서를 검색합니다.
공식 프로젝트 및 문서
비슷한 작업의 플러그인
비슷한 작업을 위한 플러그인을 비교하고 각각의 연결 조건을 확인하세요.
- MCP Reference Servers — MCP 공식 참고 구현 모음으로, Filesystem 서버를 통해 명시적으로 허용한 폴더 안에서 작업할 수 있습니다.
- Apify MCP Server — AI가 웹 데이터 도구를 찾아 실행하고 결과를 읽습니다.
- MarkItDown MCP — PDF, Word, 스프레드시트를 AI가 처리할 텍스트로 변환합니다.