Máy chủ MCP

1. Tác nhân có thể làm gì

Trỏ máy khách Model Context Protocol đến điểm cuối để hỏi như “trang nào tạo nhiều lượt nhấp do bực bội nhất tháng này” hoặc “cho tôi ba phiên từ Đức dài hơn hai phút” - rồi nhận liên kết phát lại phiên.

Công cụ	Câu trả lời
mp_projects	những dự án khóa này có thể đọc
mp_overview	phiên, người, lượt xem trang, thời lượng, tín hiệu bức xúc
mp_sessions	phiên gần đây kèm liên kết phát lại, lọc theo quốc gia, thiết bị hoặc độ dài
mp_session	một phiên: các trang theo thứ tự, sự kiện, nguồn, thiết bị
mp_pages	trang theo lượt xem, kèm khách duy nhất
mp_frustration	nhấp do bực bội, nhấp không có phản hồi và lỗi JavaScript nhóm theo trang
mp_goals	mục tiêu của bạn và tần suất đạt từng mục tiêu

2. Kết nối

Điểm cuối nhận POST tại /mcp và dùng Streamable HTTP, phiên bản giao thức 2026-07-28.

Xác thực bằng khóa API đọc MousePlayer thông thường - cùng loại bạn tạo trong Cài đặt, Khóa API và cùng loại REST API nhận. Không có thông tin xác thực thứ hai. Thu hồi khóa sẽ thu hồi quyền truy cập của tác nhân ngay cùng thời điểm.

Sau đó bật dự án

Khóa API mở toàn bộ không gian làm việc. Cách này chủ động không làm vậy: mỗi dự án có công tắc riêng trên trang tích hợp và mặc định tắt. Dự án chưa bật không xuất hiện trong mp_projects và không thể đọc dù tác nhân đoán đúng ID.

Đây không phải thủ tục rườm rà. Khóa API trong tập lệnh triển khai nằm ở một nơi bạn kiểm soát; khóa API trong tệp cấu hình tác nhân đi vào ngữ cảnh mô hình và cách quản giữ đó lỏng hơn nhiều. Cho phép từng dự án là mức kiểm soát phù hợp.

3. Chỉ đọc và vì sao điều đó sẽ không đổi

Không công cụ nào trong bảy công cụ ghi dữ liệu. Không xóa, không xuất, không đổi cấu hình qua điểm cuối này - không phải vì thiếu thời gian mà vì công cụ tác nhân có thể gọi cũng là công cụ tác nhân có thể gọi nhầm.

Dữ liệu không trả về

Không có chính bản ghi, ảnh chụp DOM hay địa chỉ IP. Tác nhân nhận những gì con người thấy trong giao diện cùng liên kết để xem phần còn lại.

Giới hạn tần suất và phạm vi

Sáu mươi yêu cầu mỗi phút cho mỗi khóa, như REST API. Khoảng thời gian giới hạn 365 ngày và danh sách kết quả giới hạn 200 hàng; câu trả lời bị cắt ngắn sẽ nói rõ vì danh sách âm thầm bị cắt trông giống hệt danh sách đầy đủ.

4. Dành cho người xây dựng máy khách

Ba phương thức: server/discover, tools/list, tools/call. Không phiên, không luồng GET, không Last-Event-ID - những thành phần đó thuộc các phiên bản giao thức đến 2025-11-25 và không nằm trong phiên bản này. GET hoặc DELETE nhận lỗi 405.

Mọi POST đều có MCP-Protocol-Version, Mcp-Method và với tools/call thì có Mcp-Name, mỗi giá trị phải khớp nội dung. Không khớp nhận 400 với lỗi JSON-RPC -32020; phiên bản không được hỗ trợ nhận 400 với -32022 và danh sách phiên bản được hỗ trợ để máy khách chọn và thử lại.

Chủ động có hai loại lỗi

Yêu cầu sai định dạng hoặc công cụ không xác định là lỗi JSON-RPC. “Dự án này chưa được cho phép” hoặc “không có phiên đó” được trả như kết quả bình thường với isError: true vì mô hình có thể khắc phục loại thứ hai bằng cách hỏi mp_projects và thử lại, còn loại thứ nhất thì không.

Kết quả chứa cả structuredContent và cùng dữ liệu được tuần tự hóa thành khối văn bản để máy khách cũ vẫn thấy thông tin hữu ích.