MCP के ज़रिए अपने Heatmaps को Claude से जोड़ें (1 मिनट, एक Command)
- how-to
- mcp
- claude
- ai
- integration
TL;DR
- HeatMapX MCP सपोर्ट करता है (AI असिस्टेंट से tools जोड़ने का open standard)। हर plan पर मुफ़्त
- Setup सिर्फ़ दो steps में होता है — एक API key issue करें, एक command चलाएं — करीब एक मिनट
- कनेक्ट करने के बाद, Claude conversation के अंदर ही आपके heatmaps, page stats और A/B test नतीजों को query कर सकता है
"Dashboard खोलो → numbers copy करो → AI में paste करो" — यह चक्कर जल्दी ही थकाने लगता है। MCP के साथ, Claude खुद आपका HeatMapX data fetch करता है, और पूरा analysis एक ही conversation में हो जाता है।
MCP क्या है?
MCP (Model Context Protocol) external tools को Claude जैसे AI असिस्टेंट से जोड़ने का standard है। इसे एक universal power socket समझिए: एक बार plug in करो, और AI को जब भी data चाहिए, वह खुद ले लेता है।
claude.ai / Claude Desktop से कनेक्ट करें (सबसे आसान — 3 क्लिक)
claude.ai या Claude Desktop पर आपको terminal या API key की ज़रूरत नहीं है:
- Settings → Connectors → "Add custom connector" खोलें
- नाम में "HeatMapX" और URL में
https://heatmapx.com/api/mcpडालें → add → "Connect" - HeatMapX में login करें और consent screen देखें (read access / create & start / stop experiments / register sites), फिर "Allow" पर क्लिक करें
बस हो गया — chat में जो चाहे पूछें। आप कभी भी HeatMapX की Settings → Connected apps से disconnect कर सकते हैं।
Claude Code से कनेक्ट करें (terminal, 2 steps)
1. API key issue करें
अपने HeatMapX dashboard में, Settings → API keys पर जाएं और "Issue new key" पर क्लिक करें। Key सिर्फ़ एक बार दिखाई जाती है — उसे तुरंत copy कर लें।
2. एक command चलाएं
अपने terminal में (YOUR_API_KEY को copy की गई key से बदलें):
claude mcp add --transport http heatmapx https://heatmapx.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
बस हो गया। Claude Code को restart करें (या एक नया conversation शुरू करें) और HeatMapX के tools उपलब्ध हो जाएंगे।
आप क्या कर सकते हैं
कनेक्ट करने के बाद, इस तरह के सवाल बस काम करते हैं:
- "मुझे मेरी sites दिखाओ" → आपकी रजिस्टर्ड साइटें और URLs
- "kpop-ticket.com पर किस page का scroll depth सबसे कम है?" → page-वार stats से पता चलता है
- "/pricing के heatmap का summary दो" → click hotspots और scroll reach
- "मेरा A/B test कैसा चल रहा है? क्या अभी winner बता सकते हैं?" → variant metrics के साथ एक statistically grounded winner suggestion
Numbers HeatMapX देता है; समझने का काम Claude करता है। दोनों अपने-अपने सबसे अच्छे काम में लगे रहते हैं।
सिर्फ़ पढ़ना नहीं: A/B test बनाएं और लॉन्च करें
Write access के साथ कनेक्ट करें और पूरा loop conversation के अंदर ही हो जाता है:
- "मेरे homepage पर एक A/B test बनाओ: दो CTA copies" → एक draft बन जाता है
- "इसे शुरू करो" → Claude experiment को summarize करता है और हमेशा आपकी confirmation मांगता है → OK बोलिए और यह live हो जाता है
- "इसे रोको" → वही confirmation, फिर यह रुक जाता है
Design से ही सुरक्षा:
- बनाना हमेशा एक draft के रूप में होता है (कुछ भी अपने आप traffic serve नहीं करता)
- Start / stop आपकी स्पष्ट मंज़ूरी के बिना कभी execute नहीं होते (two-step confirmation)
- AI के ज़रिए delete करना संभव नहीं है (irreversible operations उपलब्ध नहीं हैं)
- Permissions consent screen पर साफ़ लिखे होते हैं और Settings → Connected apps में कभी भी revoke किए जा सकते हैं
उपलब्ध tools
| Tool | क्या रिटर्न करता है |
|---|---|
| list_sites | आपकी रजिस्टर्ड साइटें |
| get_page_stats | पेज-वार sessions, clicks, average scroll depth |
| get_heatmap_summary | एक पेज के लिए heatmap aggregates (time window के साथ) |
| list_experiments | आपके A/B experiments |
| get_experiment_results | Variant metrics, uplift, winner suggestion |
पांच read tools और पांच write tools (create_site / create_experiment / start·pause·stop_experiment)। Write tools सिर्फ़ उन connections पर काम करते हैं जहां आपने साफ़ तौर पर write access approve किया है, और start/stop के लिए हमेशा conversation के अंदर confirmation ज़रूरी है।
अगर कनेक्ट न हो — checklist
- Key गलत paste हुई? पक्का करें कि आपने
hmx_live_से शुरू होने वाली पूरी string paste की है - Key revoke तो नहीं हुई? Settings → API keys में active key चेक करें
Pricing
MCP access हर plan पर मुफ़्त है (सिर्फ़ एक sensible burst limit के साथ)। Heatmaps और A/B tests, सीधे Claude से — आज़मा कर देखें।