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.

ავთენტიფიკაციისთვის გამოიყენება ჩვეულებრივი MousePlayer-ის წაკითხვის API გასაღები — ისეთივე, როგორსაც ქმნით პარამეტრებში, API გასაღებების განყოფილებაში, და როგორსაც REST API იღებს. მეორე ავტორიზაციის მონაცემი არ არსებობს. გასაღების გაუქმებისას აგენტის წვდომაც იმავე წამს უქმდება.

შემდეგ ჩართეთ პროექტი

API გასაღები მთელ თქვენს სამუშაო სივრცეს ხსნის. ეს წვდომა განზრახ განსხვავდება: თითოეულ პროექტს ინტეგრაციების გვერდზე საკუთარი ჩამრთველი აქვს და ნაგულისხმევად გამორთულია. გამორთული პროექტი არ ჩანს აქ: mp_projects და მისი წაკითხვა შეუძლებელია მაშინაც კი, თუ აგენტი მის ID-ს გამოიცნობს.

ეს ბიუროკრატია არ არის. განთავსების სკრიპტში API გასაღები თქვენს მიერ კონტროლირებულ ერთ ადგილას რჩება; აგენტის კონფიგურაციის ფაილში 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 , ისე იმავე მონაცემებს ტექსტურ ბლოკში სერიალიზებულად, რათა ძველმა კლიენტებმაც მიიღონ სასარგებლო ინფორმაცია.