เซิร์ฟเวอร์ 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 ตามปกติ แบบเดียวกับที่สร้างใน Settings, API keys และที่ REST API ใช้ ไม่มีข้อมูลรับรองชุดที่สอง เพิกถอนคีย์แล้วสิทธิ์เอเจนต์สิ้นสุดทันที

จากนั้นเปิดโปรเจกต์

คีย์ API เปิดทั้งพื้นที่ทำงาน แต่ส่วนนี้ตั้งใจไม่ทำ แต่ละโปรเจกต์มีสวิตช์บนหน้าการเชื่อมต่อและปิดโดยค่าเริ่มต้น โปรเจกต์ที่ไม่เปิดจะไม่ปรากฏใน mp_projects และอ่านไม่ได้แม้เอเจนต์เดา ID ถูก

ไม่ใช่งานเอกสารเกินจำเป็น คีย์ในสคริปต์ deploy อยู่ในที่เดียวที่คุณควบคุม แต่คีย์ในไฟล์ตั้งค่าเอเจนต์เข้าบริบทโมเดลซึ่งควบคุมหลวมกว่า การอนุญาตทีละโปรเจกต์จึงเหมาะสม

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 และข้อมูลเดียวกัน serialize เป็นบล็อกข้อความ เพื่อให้ไคลเอนต์เก่ายังเห็นสิ่งที่ใช้ได้