MCP सर्भर

1. एजेन्टले के गर्न सक्छ

MCP क्लाइन्टलाई एन्डपोइन्ट दिनुहोस् र “यो महिना कुन पृष्ठमा सबैभन्दा धेरै आक्रोशपूर्ण क्लिक छन्” वा “जर्मनीका दुई मिनेटभन्दा लामा तीन सत्र देखाऊ” सोध्न सक्छ — अनि प्लेब्याक लिङ्क दिन्छ।

उपकरण	उत्तर
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 र उही डेटा पाठ ब्लकमा सिरियलाइज गरिएको, ताकि पुराना क्लाइन्टले पनि उपयोगी कुरा पाऊन्।