How to Use the Microsoft Clarity MCP in Windsurf
Stop guessing why your users bounce. Let Windsurf pull live heatmaps and session data to fix your UI friction in real-time.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Microsoft Clarity MCP to Windsurf
Create your Vinkius account to connect Microsoft Clarity to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.
Windsurf automates your UX analysis
Cascade doesn't wait for you to hunt through dashboards. You tell it to find the problem, and it runs `list_rage_clicks` or `list_dead_clicks` to isolate exactly where users are struggling. Once it finds the friction, it pulls the `get_recording` data so you can see the session yourself. It connects the behavior to the code without you lifting a finger.
Visual data straight into Windsurf
You need to know if users actually scroll to your CTA. Cascade uses `get_scroll_depth` and `get_heatmap` to map user engagement directly into your project context. This MCP server feeds the raw behavioral data into the IDE. You get the evidence you need to justify a UI change without switching tabs.
Real-time insights for your codebase
Stop digging through raw logs to check if your latest deploy broke the button. Cascade uses `check_clarity_status` and `get_live_insights` to verify site health. It checks the metrics while you work on the fix. You'll see the impact of your changes instantly.
Set up Microsoft Clarity MCP in Windsurf
Prerequisites
- Windsurf IDE installed (macOS, Windows, or Linux)
- Active Vinkius subscription with a valid endpoint token
- 1
Open MCP configuration
Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open
~/.codeium/windsurf/mcp_config.json. - 2
Add the Microsoft Clarity MCP
Paste the JSON snippet shown on the right into the
mcpServersobject. Replace[YOUR_TOKEN_HERE]with your endpoint token from cloud.vinkius.com. - 3
Refresh MCPs
Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
- 4
Verify in Cascade
Start a new Cascade conversation and ask something like "Show my Microsoft Clarity payment history." If connected, Cascade will call the Microsoft Clarity tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"microsoft-clarity-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Microsoft Clarity. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
Why Choose Vinkius
Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.
Real-time monitoring
Live
visibility into every interaction
Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.
Built-in savings
60%
lower AI costs
Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.
Single dashboard
One
place for every integration
Every tool your AI connects to, managed from a single screen. One account, complete control.
Common questions about Microsoft Clarity MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Microsoft Clarity MCP today
We host it, we monitor it, we maintain it. You just paste one token.
