Microsoft Clarity MCP服务器
这是Microsoft Clarity的模型上下文协议（MCP）服务器。 它允许您使用Claude for Desktop或其他MCP兼容客户端从Clarity访问会话录制、项目分析和文档。
主要特点
- 分析数据访问：查询您的Microsoft Clarity分析数据，包括流量指标、用户行为洞察和性能统计数据
- 会话记录检索：访问和分析会话记录，以了解用户交互并确定优化机会
- 自然语言查询：用简明的英语提问，从数据中获得见解-无需学习复杂的查询语法或API端点
- 灵活的数据过滤：按浏览器、设备、国家等不同维度筛选结果
- 实时数据访问：按需从您的Clarity项目中获取最新的分析数据和见解
- 文档集成：直接在您的工作流程中从Microsoft Clarity文档中获取快速答案和指导
- 无缝MCP集成：与Claude原生兼容，适用于桌面、Visual Studio代码和其他与模型上下文协议（MCP）兼容的客户端
设置和安装
先决条件
- Node.js v16或更高版本
- Microsoft Clarity帐户和API令牌
- 任何兼容MCP的客户端（Claude for Desktop等）
安装
选项1：通过npm安装（推荐）
你可以直接使用npm安装并运行这个包：
# Install globally
npm install -g @microsoft/clarity-mcp-server
# Run the server
clarity-mcp-server选项2：使用npx运行而不安装
您可以直接使用npx运行服务器，而无需安装：
npx @microsoft/clarity-mcp-server使用任一选项，您都可以使用 --clarity_api_token 参数：
npx @microsoft/clarity-mcp-server --clarity_api_token=your-token-here选项3：手动安装
- 克隆或下载此存储库
- 安装依赖项：
npm install- 构建TypeScript代码：
npm run build- 运行服务器：
npm run start扩展/插件安装
Visual Studio代码扩展
单击上面的按钮直接在Visual Studio代码中安装Microsoft Clarity MCP服务器。
Claude桌面插件
从Claude的扩展库安装：
- 打开 Claude桌面版
- 引导到 File → 设置→ 扩展
- 搜索 微软清晰度
- 点击 安装 添加扩展名
- 配置您的 API代币:
按照中的说明进行操作 API代币部分 以正确检索和设置它。
配置
您可以提供 清晰度数据导出API 令牌有两种方式：
- 命令行参数:
npx @microsoft/clarity-mcp-server --clarity_api_token=your-token- 刀具参数:
提供 token 作为调用时的参数 get-clarity-data 工具
配置MCP客户端
通用MCP客户端配置
MCP客户端通常需要配置才能连接到服务器。以下是如何配置MCP客户端的一般示例：
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server",
"--clarity_api_token=your-api-token-here"
]
}
}
}添加此配置的具体位置和方式将取决于您的特定MCP客户端。
Claude用于桌面配置
要配置Claude for Desktop以使用此服务器，请执行以下操作：
- 打开Claude for Desktop配置文件：
- 视窗: %AppData%\Claude\claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- 添加上面通用示例中显示的配置
- 保存配置文件并重新启动Claude for Desktop
服务器使用情况
服务器提供了各种工具，您可以从任何MCP客户端调用这些工具。 自然地提问，让每个请求都集中在一件事上。
查询分析仪表板
- 姓名：
query-analytics-dashboard - 说明： 使用简化的自然语言搜索查询从项目的仪表板中检索分析数据和指标。
- 示例：
- 在过去的3天里，我们从埃及参加了多少次Clarity课程？ - 我的Clarity项目中使用最多的浏览器是什么？ - 显示上周Clarity项目的流量指标
列出会话记录
- 姓名：
list-session-recordings - 说明： 根据指定的筛选条件列出项目的会话录制。筛选器允许您按各种字段（如URL、设备类型、浏览器、操作系统、国家、城市等）缩小录制范围。
- 示例：
- 列出移动设备上最近的Clarity会话 - 显示用户点击次数最多的前5个Clarity会话 - 获取用户遇到JavaScript错误时的清晰记录
查询文档资源
- 姓名：
query-documentation-resources - 说明： 从Microsoft Clarity文档中检索片段，以查找用户问题的答案，包括安装指南、功能、使用、故障排除和集成说明的分步屏幕截图。
- 示例：
- 如何使用Microsoft Clarity跟踪自定义事件？ - 在Microsoft Clarity中，我可以为录音添加多少个标签？
API代币
获取您的API代币
要生成API令牌，请执行以下操作：
- 转到您的Clarity项目
- 选择设置→ 数据导出→ 生成新的API令牌
- 为令牌提供描述性名称
- 安全地保存生成的令牌
隐私政策
有关数据隐私和使用的信息，请参阅 Microsoft Clarity隐私政策.
许可证
该项目根据 麻省理工学院 许可证。