Διακομιστής MCP

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.

Ο έλεγχος ταυτότητας γίνεται με ένα κανονικό κλειδί API ανάγνωσης του MousePlayer - του ίδιου τύπου που δημιουργείτε στην ενότητα Ρυθμίσεις, Κλειδιά API και του ίδιου τύπου που δέχεται το REST API. Δεν υπάρχει δεύτερο διαπιστευτήριο. Η ανάκληση του κλειδιού ανακαλεί την πρόσβαση του πράκτορα την ίδια στιγμή.

Έπειτα ενεργοποιήστε το έργο

Ένα κλειδί API ανοίγει ολόκληρο τον χώρο εργασίας σας. Αυτό σκόπιμα δεν το κάνει: κάθε έργο έχει δικό του διακόπτη στη σελίδα ενσωματώσεων, απενεργοποιημένο από προεπιλογή. Ένα έργο που δεν έχει ενεργοποιηθεί δεν εμφανίζεται στο mp_projects και δεν μπορεί να διαβαστεί ακόμη κι αν ο πράκτορας μαντέψει το ID του.

Αυτό δεν είναι γραφειοκρατία. Ένα κλειδί API σε script εγκατάστασης βρίσκεται σε ένα σημείο που ελέγχετε· ένα κλειδί API στο αρχείο διαμόρφωσης ενός πράκτορα τροφοδοτεί το πλαίσιο ενός μοντέλου και αυτό σημαίνει πολύ πιο χαλαρή φύλαξη. Η παραχώρηση πρόσβασης σε ένα έργο κάθε φορά είναι ο έλεγχος που ταιριάζει.

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 όσο και τα ίδια δεδομένα σειριοποιημένα σε τμήμα κειμένου, ώστε και οι παλαιότεροι πελάτες να βλέπουν κάτι χρήσιμο.