MCP सर्वर
AI एजेंट को विश्लेषण पढ़ने दें: Model Context Protocol पर सात टूल, सभी केवल पढ़ने के लिए, मौजूदा API कुंजी से प्रमाणित।
1. एजेंट क्या कर सकता है
Model Context Protocol क्लाइंट एंडपॉइंट से जोड़ें, वह पूछ सकता है "इस माह किस पृष्ठ में सबसे गुस्से वाले क्लिक" या "जर्मनी के दो मिनट से लंबे तीन सत्र दिखाएँ" — और चलाने वाला लिंक दे।
| टूल | उत्तर |
|---|---|
mp_projects | कुंजी कौन प्रोजेक्ट पढ़ सकती है |
mp_overview | सत्र, लोग, पृष्ठ दृश्य, अवधि, निराशा संकेत |
mp_sessions | देश, डिवाइस या अवधि से फ़िल्टर हाल के सत्र और लिंक |
mp_session | एक सत्र: क्रम में पृष्ठ, इवेंट, स्रोत, डिवाइस |
mp_pages | दृश्यों से पृष्ठ, अद्वितीय आगंतुक सहित |
mp_frustration | पृष्ठ अनुसार गुस्से में क्लिक, निष्प्रभावी क्लिक और JavaScript त्रुटियाँ |
mp_goals | लक्ष्य और उनकी प्राप्ति संख्या |
हर सत्र के साथ व्यक्ति खोल सकने वाला लिंक है। सार देता एजेंट उपयोगी; आधार के बीस सेकंड दिखाने वाला जाँचा जा सकता है।
2. कनेक्शन
एंडपॉइंट यहाँ POST लेता है: /mcp और Streamable HTTP बोलता है, प्रोटोकॉल संस्करण 2026-07-28।
सामान्य MousePlayer रीड API कुंजी से प्रमाणीकरण — सेटिंग, API कुंजी में वही जो REST API लेती है। दूसरा क्रेडेंशियल नहीं। कुंजी रद्द होते ही एजेंट की पहुँच भी रद्द।
फिर प्रोजेक्ट चालू करें
API कुंजी पूरा वर्कस्पेस खोलती है। यह जानबूझकर नहीं: हर प्रोजेक्ट का इंटीग्रेशन स्विच डिफ़ॉल्ट बंद। बंद प्रोजेक्ट यहाँ नहीं दिखता: mp_projects और ID अनुमान पर भी नहीं पढ़ सकता।
औपचारिकता नहीं। डिप्लॉय स्क्रिप्ट की कुंजी आपके नियंत्रण में है; एजेंट कॉन्फ़िगरेशन की कुंजी मॉडल संदर्भ को मिलती है और नियंत्रण कम है। एक-एक प्रोजेक्ट की अनुमति उचित नियंत्रण है।
3. केवल पढ़ना और क्यों यही रहेगा
सातों टूल कुछ नहीं लिखते। इस एंडपॉइंट में हटाना, एक्सपोर्ट या सेटिंग बदलाव नहीं — समय कम था इसलिए नहीं, एजेंट गलती से भी टूल बुला सकता है इसलिए।
क्या नहीं लौटाता
रिकॉर्डिंग, DOM स्नैपशॉट या IP नहीं। इंटरफ़ेस में व्यक्ति को दिखने वाली जानकारी और बाकी देखने का लिंक।
दर और दायरा
प्रति कुंजी प्रति मिनट साठ अनुरोध, REST API जैसे। अवधि अधिकतम 365 दिन और सूची 200 पंक्तियाँ; कटे उत्तर में बताते हैं, क्योंकि चुप कटी सूची पूरी लगती है।
4. क्लाइंट बनाने वालों के लिए
तीन विधियाँ: server/discover, tools/list, tools/call। सत्र नहीं, GET स्ट्रीम नहीं, यह नहीं: Last-Event-ID — वे 2025-11-25 तक के प्रोटोकॉल के हैं, इस संस्करण के नहीं। GET या DELETE पर 405।
हर POST में है: MCP-Protocol-Version, Mcp-Method और इसके लिए: tools/call, Mcp-Name, हर एक बॉडी से मिलना चाहिए। अंतर का उत्तर 400 और JSON-RPC त्रुटि -32020; असमर्थित संस्करण पर 400 और -32022 तथा समर्थित संस्करण सूची ताकि क्लाइंट चुनकर फिर कोशिश करे।
जानबूझकर दो तरह त्रुटि
ग़लत अनुरोध या अज्ञात टूल JSON-RPC त्रुटि है। "प्रोजेक्ट स्वीकृत नहीं" या "सत्र नहीं" सामान्य परिणाम में यह देता है: isError: true — मॉडल दूसरे में यह पूछकर: mp_projects फिर कोशिश कर सकता है, पहले में नहीं।
परिणाम में दोनों हैं: structuredContent और वही डेटा पाठ ब्लॉक में, ताकि पुराने क्लाइंट को भी उपयोगी जानकारी मिले।
यहाँ बताए ट्रेडमार्क संबंधित स्वामियों के हैं। MousePlayer का इन प्रदाताओं से व्यावसायिक संबंध नहीं।