Servidor MCP
Permita que un agente de IA lea sus análisis: siete herramientas mediante Model Context Protocol, todas de solo lectura, autenticadas con una clave API que ya tiene.
1. Qué puede hacer un agente
Conecte un cliente Model Context Protocol al endpoint y podrá preguntar «qué página produce más clics de rabia este mes» o «muéstreme tres sesiones de Alemania de más de dos minutos», y recibir un enlace para reproducirlas.
| Herramienta | Responde |
|---|---|
mp_projects | qué proyectos puede leer esta clave |
mp_overview | sesiones, personas, vistas de página, duración y señales de frustración |
mp_sessions | sesiones recientes con enlaces, filtradas por país, dispositivo o duración |
mp_session | una sesión: páginas en orden, eventos, origen y dispositivo |
mp_pages | páginas por vistas, con visitantes únicos |
mp_frustration | clics de rabia, clics muertos y errores JavaScript agrupados por página |
mp_goals | sus objetivos y cuántas veces se alcanzó cada uno |
Cada sesión que presenta el agente incluye un enlace que una persona puede abrir. Un agente que resume lo observado es útil; uno que además muestra los veinte segundos en que se basa permite comprobarlo.
2. Conexión
El endpoint acepta POST en /mcp y utiliza Streamable HTTP, versión del protocolo 2026-07-28.
La autenticación utiliza una clave API de lectura normal de MousePlayer, del mismo tipo que se crea en Ajustes, Claves API y que utiliza la API REST. No hay una segunda credencial. Revocar la clave revoca al instante el acceso del agente.
Después active el proyecto
Una clave API abre todo su espacio. Este acceso no lo hace deliberadamente: cada proyecto tiene su propio interruptor en integraciones, desactivado por defecto. Un proyecto no activado no aparece en mp_projects y no puede leerse aunque el agente adivine el ID.
No es burocracia. Una clave API en un script de despliegue reside en un lugar controlado por usted; en la configuración de un agente alimenta el contexto de un modelo y queda bajo una custodia mucho menos estricta. Autorizar cada proyecto por separado es el control adecuado.
3. Solo lectura y por qué no cambiará
Ninguna de las siete herramientas escribe nada. No hay eliminación, exportación ni cambios de configuración en este endpoint, no por falta de tiempo, sino porque una herramienta que un agente puede llamar también puede llamarla por error.
Qué no devuelve
Ni las grabaciones, ni capturas del DOM, ni direcciones IP. El agente recibe lo que ve una persona en la interfaz y el enlace para ver el resto.
Límites de frecuencia e intervalo
Sesenta solicitudes por minuto y clave, igual que la API REST. El intervalo se limita a 365 días y la lista a 200 filas; una respuesta truncada lo indica, porque una lista recortada sin aviso parece completa.
4. Para quienes desarrollan el cliente
Tres métodos: server/discover, tools/list, tools/call. Sin sesiones, flujo GET ni Last-Event-ID - pertenecen a versiones del protocolo hasta 2025-11-25 y no forman parte de esta. GET o DELETE recibe 405.
Cada POST incluye MCP-Protocol-Version, Mcp-Method y, para tools/call, Mcp-Name, y cada uno debe coincidir con el cuerpo. Una discrepancia devuelve 400 con el error JSON-RPC -32020; una versión no compatible devuelve 400 con -32022 y la lista de versiones admitidas, para que el cliente elija una y reintente.
Dos tipos de error, deliberadamente
Una solicitud mal formada o una herramienta desconocida es un error JSON-RPC. «Este proyecto no está autorizado» o «no existe esa sesión» vuelve como resultado normal con isError: true - un modelo puede recuperarse del segundo tipo solicitando mp_projects y reintentando, pero no del primero.
Los resultados incluyen tanto structuredContent como los mismos datos serializados en un bloque de texto, para que los clientes antiguos también reciban información útil.
Todas las marcas mencionadas pertenecen a sus respectivos propietarios. MousePlayer no mantiene ninguna relación comercial con estos proveedores.