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 和序列化为文本块的同一数据，使旧版客户端仍能看到有用内容。