Guía para principiantes
MCP para Screen Mouse Recorder
Este MCP es un pequeño servidor que se ejecuta en tu ordenador y permite que un asistente de IA (Claude, OpenCode, Antigravity, etc.) abra un Chrome aparte, navegue y grabe un tutorial. No es una extensión de Chrome: no tienes que instalar permisos en tu navegador normal.
El servidor MCP es público y open source: github.com/carlosdmoron/screen-mouse-recorder-mcp. Puedes revisar el código antes de ejecutarlo.
Usa la misma cuenta de Google que en Screen Mouse Recorder. Esta sesión solo desbloquea la guía; no es la cuenta que se graba ni la que se usa para entrar en las páginas de tus tutoriales.
¿Qué vas a conseguir?
- Un Chrome controlado por el asistente, separado de tu Chrome normal.
- Navegación, clics, escritura, scroll y login con email/contraseña.
- Un video del contenido de la página, con cursor y zoom automático.
- El video en WebM y, si tienes ffmpeg, también en MP4.
Antes de empezar
- Ten instalado Node.js 22 o superior.
- Ten git o descarga el ZIP del repositorio público.
- Ten Google Chrome instalado (el MCP lo abre solo).
- Opcional: instala ffmpeg si quieres MP4 automático.
- Usa una cuenta dedicada para grabar, no tu cuenta personal principal.
- El servidor escucha solo en 127.0.0.1: nadie de fuera puede conectarse.
-
Copia tu token local. Es una contraseña larga
que solo se guarda en este navegador y sirve para que tu asistente se
conecte al MCP. No la compartas.
...Si cambias de navegador o borras los datos del sitio, se genera un token nuevo. Tendrás que actualizar la configuración de tu asistente.
-
Descarga y arranca el servidor MCP. El servidor es
público y su código está en GitHub. Clona el
repositorio y entra en la carpeta:
git clone https://github.com/carlosdmoron/screen-mouse-recorder-mcp.git cd screen-mouse-recorder-mcp
Si no tienes git, abre el repositorio y usa Code > Download ZIP; después descomprime la carpeta y entra en ella.
La primera vez, instala las dependencias:npm install
Después, pega el comando que aparece abajo:Deja esa ventana abierta mientras grabas. Para parar el servidor, pulsa Ctrl+C en la terminal.
En macOS/Linux, cambia $env:VAR="..." por export VAR="...".
-
Conecta tu asistente de IA. El MCP usa transporte
Streamable HTTP con una cabecera
Authorization: Bearer <token>.
Esta es la configuración genérica:
No todos los asistentes usan el mismo formato. Elige el tuyo:
Asistente ¿Funciona? Qué necesitas OpenCode Sí MCP remoto apuntando a 127.0.0.1 con cabecera Bearer. Claude Code / Claude Desktop Sí Claude Code con .mcp.json; Claude Desktop con conector remoto o puente local. Google Antigravity Sí App, IDE o CLI. Añade el servidor con serverUrl y la cabecera Bearer. ChatGPT web (chat) No directamente ChatGPT web no acepta 127.0.0.1: necesita una URL HTTPS pública o un Secure MCP Tunnel. La app de escritorio, Codex, la CLI y la extensión de IDE sí pueden configurar MCP local. Otros Depende Cursor, Windsurf, VS Code y similares suelen aceptar MCP; comprueba si tu versión admite Streamable HTTP y cabeceras. OpenCode: configuración exacta
Pega esto en opencode.jsonc (proyecto o global). Sustituye <TOKEN> por tu token.
{ "mcp": { "servers": { "screen-mouse-recorder": { "type": "remote", "url": "http://127.0.0.1:37591/mcp", "oauth": false, "headers": { "Authorization": "Bearer <TOKEN>" } } } } }Luego ejecuta opencode mcp list y comprueba que aparece como conectado. Si no, reinicia OpenCode.
Claude Code: configuración exacta
Crea o edita .mcp.json en la carpeta de tu proyecto. Sustituye <TOKEN> por tu token.
{ "mcpServers": { "screen-mouse-recorder": { "type": "http", "url": "http://127.0.0.1:37591/mcp", "headers": { "Authorization": "Bearer <TOKEN>" } } } }En Claude Desktop, usa la opción de conector remoto o un puente local si tu versión no acepta HTTP directo.
Google Antigravity: configuración exacta
En Antigravity abre Manage MCP Servers y edita el archivo mcp_config.json (o usa ~/.gemini/config/mcp_config.json). Sustituye <TOKEN> por tu token.
{ "mcpServers": { "screen-mouse-recorder": { "serverUrl": "http://127.0.0.1:37591/mcp", "headers": { "Authorization": "Bearer <TOKEN>" } } } }Antigravity pedirá permiso antes de ejecutar herramientas. Permite solo las tools de grabación que necesites.
ChatGPT: qué se puede hacer y qué no
ChatGPT web (el chat normal) no puede conectarse a 127.0.0.1. Solo acepta servidores MCP remotos por HTTPS. Para usar este MCP necesitarías un túnel como Secure MCP Tunnel o publicar el servidor con HTTPS y autenticación.
El soporte completo de MCP en ChatGPT web depende del plan: Business, Enterprise y Edu tienen MCP completo; Pro permite servidores de lectura; Plus no está documentado. La app de escritorio, Codex, la CLI y la extensión de IDE sí pueden usar MCP local.
-
Login con email y contraseña (opcional). El
comando activa SMR_MCP_ALLOW_CREDENTIALS=1.
Pide al asistente que use la tool login
solo para iniciar sesión antes de grabar. El login no se graba,
no se guardan credenciales y
inspect_page/type_text
siguen bloqueando email y contraseña.
La contraseña viaja en la llamada al modelo: usa una cuenta dedicada y solo en sitios propios o autorizados. Si el sitio pide 2FA o CAPTCHA, complétalo tú manualmente. Si no quieres login automático, elimina SMR_MCP_ALLOW_CREDENTIALS del comando.
-
Pide la grabación. Puedes hablar normal. Por
ejemplo:
Usa el MCP screen-mouse-recorder. 1. Abre https://tu-sitio.com/login. 2. Entra con el email ... y la contraseña .... 3. Graba este recorrido: abre el panel, muestra las secciones y explica cada una. 4. Para a los 60 segundos y dame la ruta del MP4.
Si tu asistente no elige bien las herramientas, sé explícito: start_recording para empezar, run_flow para navegar/hacer clics/escribir y stop_recording para terminar.
El video graba el contenido de la página, no la barra de Chrome ni tu escritorio. Por defecto es 1440×900; puedes cambiarlo con SMR_MCP_VIEWPORT_WIDTH y SMR_MCP_VIEWPORT_HEIGHT.
- Encuentra el video. Cuando el asistente llame a stop_recording, el MCP guarda el WebM en la carpeta recordings/ del proyecto y, si ffmpeg está instalado, crea también el MP4. La respuesta de la tool incluye la ruta completa.
Problemas frecuentes
Mi asistente no encuentra el MCP
- Comprueba que la ventana del servidor siga abierta y sin errores.
- La URL debe ser exactamente http://127.0.0.1:37591/mcp.
- El token del cliente debe ser el mismo que aparece en el paso 1.
- Reinicia el asistente después de cambiar la configuración.
ChatGPT web no conecta
Es normal: ChatGPT web no acepta 127.0.0.1. Usa la app de escritorio/Codex/CLI/IDE, o publica el MCP con HTTPS y un túnel. No expongas el servidor local a Internet sin autenticación.
El login falla o se queda a medias
- Si hay 2FA, CAPTCHA o un aviso de cookies, complétalo tú y vuelve a pedir la grabación.
- Si el formulario es de varios pasos, inicia sesión manualmente; el login automático actual espera email y contraseña en la misma página.
- Si los campos tienen nombres raros, indica emailSelector y passwordSelector.
No se genera el MP4
Instala ffmpeg y añádelo al PATH. Si no lo tienes, el WebM sigue disponible y se puede convertir después.
Seguridad y límites
- El MCP controla un Chrome aparte; no toca tu Chrome normal ni tu sesión personal.
- No guarda la contraseña, pero el modelo la ve al enviarla. Usa una cuenta dedicada.
- El login no se graba; la grabación empieza después de confirmar el acceso.
- No incluye cámara ni subtítulos. El zoom en vivo no sobrevive a una navegación.
- Revisa el video antes de compartirlo: puede contener datos privados.
- Para terminar, pulsa Ctrl+C en la terminal del servidor.