Conectar Codex y Claude Code
Conecta tu agente local con Screengaze: configura el MCP y, si quieres, añade la skill que guía las grabaciones, ediciones y exportaciones.
Índice del artículo
Qué conecta cada pieza
Screengaze realiza la captura, la edición y el render en la aplicación nativa del Mac. Su MCP local permite que Codex o Claude Code consulten el estado y utilicen las herramientas de la app mediante un helper incluido en Screengaze.
La skill incluida enseña al agente el procedimiento: preparar una toma, comprobar el estado, editar con la revisión actual, revisar el resultado y esperar a que termine una exportación. El MCP funciona sin ella; instalarla ayuda a utilizarlo correctamente. No necesitas publicarla en un repositorio oficial.
Elige tu cliente y la ruta de la app
Necesitas Screengaze en un Mac con Apple Silicon y el cliente elegido instalado en ese mismo Mac. La compatibilidad beta sigue en validación; consulta las versiones exactas y configuraciones validadas en la página de descarga de cada lanzamiento. La descarga pública de Screengaze todavía no está disponible; esta guía sirve si ya tienes una copia de la app con su helper y su skill incluidos.
Elige Codex o Claude Code y confirma dónde está Screengaze.app. La ruta convencional es /Applications/Screengaze.app; puedes cambiarla si la guardas en otra carpeta. Los comandos y el prompt se actualizan con tu elección.
Puedes configurar todo por chat o seguir los pasos manuales. Copiar un prompt o un comando solo coloca texto en el portapapeles: revisa el contenido y pégalo en el agente o en Terminal para ejecutarlo.
La ruta actualiza todos los comandos y el prompt. Cambiarla aquí no instala nada.
Configurar por chat
Copia el prompt completo y pégalo en una sesión local del cliente seleccionado con acceso a Terminal. Incluye la autorización para registrar o actualizar únicamente Screengaze e instalar su skill personal, conservando el resto de tu configuración.
El agente debe comprobar los archivos de la app y la configuración existente, evitar duplicados y guardar un respaldo antes de actualizar una skill diferente. Si el cliente necesita una sesión nueva, debe darte un mensaje exacto para continuar y dejar pendiente la consulta real hasta poder ejecutarla.
Setup completo para Codex
Configurar manualmente
Sigue estos siete pasos en el Mac donde usarás Screengaze. Los comandos de abajo corresponden al cliente y a la ruta seleccionados. Revisa una entrada existente antes de registrar otra con el mismo nombre.
- Instala tu copia de Screengaze y abre la app. Comprueba que la ruta elegida contiene el helper y la skill indicados en esta guía.
- En Screengaze, abre «Edición y salida → Integraciones · Agentes» y activa «Permitir conexiones MCP locales». No necesitas tener un proyecto abierto.
- Registra el servidor screengaze en el cliente elegido con el comando de registro. Si ya existe, conserva una configuración correcta o actualiza únicamente su ruta, sin duplicar la entrada ni reemplazar otras integraciones.
- Opcionalmente, copia la skill incluida al directorio personal del cliente. El comando sirve para instalarla o actualizarla: conserva una copia idéntica y guarda un respaldo si su contenido es diferente.
- Reconecta el servidor en el cliente o abre una sesión nueva para cargar las herramientas y la skill. Un registro guardado no garantiza que esta conversación ya las tenga disponibles.
- Cuando aparezca «Revisar conexión» en Screengaze, comprueba el nombre del cliente y pulsa «Permitir sesión». Activar la integración no aprueba automáticamente la sesión.
- Pide al agente una consulta de get_status sin otras acciones. Si aparece una aprobación pendiente, complétala en Screengaze y repite la consulta. Confirma el resultado real antes de dar el setup por terminado.
Comprobar los archivos incluidos
El comando termina con código 0 si encuentra el helper ejecutable y SKILL.md; no imprime nada al tener éxito. Abre la app y activa la integración con sus controles.
Abrir Screengaze
Comprobar un registro existente
Si no existe, registra la integración con el comando siguiente. Si ya coincide con esta ruta y stdio, consérvala y pasa a la verificación.
Registrar MCP en Codex
Codex usa por defecto ~/.codex/config.toml para el registro personal; no requiere --scope user. Respeta una ubicación personalizada de configuración.
Si el registro existe pero su ruta es incorrecta
Conserva antes un respaldo de la configuración del cliente. Ejecuta este reemplazo solo si has comprobado que la entrada screengaze personal es incorrecta; retira y vuelve a registrar únicamente esa entrada. Conserva cualquier ajuste adicional que necesites volver a aplicar y no cambies otros servidores o ámbitos.
Reemplazar solo el registro personal de Screengaze
Verificar el registro
Comprobar versión, ayuda y catálogo
Estas opciones no modifican proyectos. El catálogo no demuestra conexión ni autorización. Sin opciones, el helper espera mensajes stdio; no es un instalador y no tiene --install.
Instalar o actualizar la skill opcional de Codex
Destino personal: ~/.agents/skills/screengaze. El comando compara la carpeta completa. Si difiere, mueve la copia anterior a skill-backups junto a skills y después instala la nueva. La ruta del respaldo aparece en Terminal. Para restaurarla, cierra el cliente, conserva la copia actual y devuelve la carpeta screengaze del respaldo al destino personal. Invoca la skill con $screengaze.
Comprueba cada estado
Comprueba el registro con el CLI del cliente y el catálogo con los diagnósticos del helper. Después verifica la conexión desde el propio agente. Leer el catálogo no consulta Screengaze ni demuestra que su sesión esté autorizada.
get_status no recibe argumentos y permite diagnosticar la conexión antes de aprobarla. Comprueba enabled, authorized y requires_approval. Para terminar el setup, vuelve a consultarlo tras pulsar «Permitir sesión» y confirma authorized: true. Esta consulta no modifica el proyecto.
| Comprobación | Qué demuestra |
|---|---|
| Helper localizado | Existe el ejecutable dentro de la app seleccionada. |
| MCP registrado | El cliente conserva una entrada con el helper correcto. |
| Catálogo y herramientas | El helper ofrece su catálogo; las herramientas deben cargarse además en esta sesión del cliente. |
| Skill instalada | El workflow está en el directorio del cliente y se carga en una sesión compatible. |
| Sesión autorizada | Screengaze ha aprobado esta conexión concreta. |
| Consulta real de estado | El agente llamó a get_status y recibió el estado de la app. |
Mensaje para continuar tras reconectar
Permisos y contenido compartido
El cliente puede pedir permiso para ejecutar comandos o utilizar herramientas. Screengaze requiere que actives MCP y apruebes la sesión. macOS concede por separado los permisos de pantalla, micrófono y cámara según las fuentes que vayas a grabar. Ninguna de estas aprobaciones sustituye las demás.
«Compartir fotogramas» y «Compartir transcripción» son opciones independientes, inicialmente desactivadas. El agente no debe activarlas por su cuenta. Una conexión MCP local no implica que el modelo del cliente sea local: las imágenes y palabras que compartas pueden llegar a su proveedor.
La aprobación de sesión permite acceder a proyectos y medios locales, editar, grabar y crear exportaciones. Puedes retirar ese acceso con «Revocar acceso» o desactivar las conexiones MCP en Screengaze. No compartas el archivo privado de conexión, que contiene un token de sesión.
Después del setup
Cuando la consulta de estado esté comprobada, puedes pedir estas acciones por separado. Empieza con una consulta sin cambios; para editar o grabar, utiliza material de ensayo y revisa el resultado antes de exportar.
Una demo autónoma necesita además herramientas de navegador o escritorio que actúen sobre una ventana visible en el mismo Mac. Screengaze captura y edita; el MCP no controla por sí solo los clics, la escritura ni la navegación de la aplicación demostrada.
La skill ayuda a seguir el estado de las tareas y a revisar las ediciones. Una tarea de inicio completada significa que la grabación ha empezado: hay que detenerla y esperar al guardado. Una transcripción creada tampoco añade por sí sola subtítulos visibles. Las exportaciones conservan las reglas de licencia de la app y deben usar un archivo de destino nuevo.
Consultar sin modificar
Editar el proyecto abierto
Grabar una demo
Si algo no conecta
- App movida: corrige la ruta de Screengaze.app y actualiza únicamente la entrada screengaze. Reconecta el servidor y comprueba de nuevo el estado.
- CLI ausente: abre Terminal en este Mac y comprueba que el cliente elegido esté instalado y disponible. Usa su documentación oficial para resolverlo; no necesitas instalar un segundo cliente.
- Configuración existente: inspecciona la entrada y su ámbito antes de cambiarla. Conserva una configuración correcta, evita duplicados y guarda un respaldo si debes editar ajustes manualmente. No sustituyas el archivo completo de configuración.
- Skill existente: compara la copia personal con la incluida en la app. Si son iguales, no cambies nada. Si difieren, conserva un respaldo antes de actualizar únicamente screengaze.
- MCP desactivado o aprobación pendiente: activa la integración y revisa la solicitud en Screengaze. Si rechazaste o revocaste la sesión, reconecta una nueva y apruébala.
- Herramientas o skill sin cargar: reconecta el servidor o abre una sesión nueva. Usa el mensaje de continuación y deja la consulta real pendiente hasta que las herramientas estén disponibles.
- App reiniciada: las autorizaciones y tareas de sesión no persisten después de reiniciar Screengaze. Reconecta, aprueba cuando corresponda y consulta el estado; los proyectos y archivos exportados sí se guardan.
- Agente remoto: continúa en un agente local con acceso a Terminal y a Screengaze en este Mac. Una sesión en un contenedor remoto no accede directamente al helper local.
Fuentes y alcance de la verificación
Contenido revisado el 25 de octubre de 2026 a partir de la guía MCP, el informe de verificación y la skill incluidos en el proyecto de Screengaze. El informe distingue las pruebas del helper y la aplicación de las sesiones reales de Codex y Claude Code, que figuran como pendientes. Esta guía describe el recorrido y sus resultados esperados; no acredita por sí sola una conexión real en tu cliente.
Los nombres de controles entre comillas corresponden a la interfaz actual de la app.