工具連接（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 和表格等文件，轉成便於繼續整理的文字。