工具连接（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、npm 和支持 MCP 的客户端。
- 需要 Clarity 账号，以及已经采集目标网站数据的项目。
- 在 Clarity 的 Settings → Data Export 创建项目 API 令牌，只在本地客户端配置中替换 YOUR_CLARITY_API_TOKEN。
使用限制与费用
- 可查数据、时间范围和请求额度受 Clarity 服务及项目权限限制。
- 会话录屏可能涉及敏感的网站操作，只向已授权的助手和人员开放。
- 它不能代替分析，也不能证明用户离开的原因；不会替你配置网站追踪或同意设置。
依据公开文档整理，未逐一安装实测。
内容介绍
Microsoft Clarity MCP Server 把支持 MCP 的助手连接到你已经在用的 Clarity 项目。你可以询问访问量、设备和用户行为，再找到相关会话录屏，排查页面难用或流程卡住的位置。它负责查询已有分析数据，安装连接工具不会自动给网站装统计代码，也不会凭空产生访问数据。
可以怎么用
- 用日常语言查询 Clarity 分析数据。
- 按支持的筛选和排序条件查找会话录屏。
- 在助手中查询 Clarity 使用文档。
官方项目与文档
用途相近的插件
比较解决相似任务的插件，留意各自的接入条件。
- MCP Reference Servers — MCP 官方参考实现合集，可从 Filesystem 入手，让助手处理你明确授权的文件夹。
- Apify MCP Server — 让AI查找和运行现成的网页采集工具，并读取采集结果。
- MarkItDown MCP — 让 AI 读取 PDF、Word 和表格等文件，转成便于继续整理的文字。