Referencia

CLI, MCP y Atajos

Controla ZumCast desde Terminal, un asistente de IA como Claude, Siri o la app Atajos.

Instalar el comando

En Ajustes › General › Línea de comandos y agentes de IA, pulsa Instalar el comando zumcast… e introduce la contraseña de tu Mac. Después, en Terminal:

zumcast list --json

Comandos

zumcast record start [--window <app>] [--camera] [--mic]
zumcast record stop | pause | resume | discard
zumcast list [--json]
zumcast info <project>
zumcast export <project> [--format mp4|mov|gif] [--codec h264|hevc]
               [--height 1080] [--fps 60] [--aspect 16:9|9:16|1:1|4:5|4:3]
               [--version <name>|--all] [--brand <kit|default>] [--out <path>]
zumcast guide <project> [--format markdown|html|pdf|interactive]
zumcast captions <project> [--vtt]
zumcast zoom regenerate <project>
zumcast zumi <project|shot> "cut the pauses" [--apply] [--json]
zumcast polish <project> [--apply]
zumcast brand list
zumcast shot take [--mode area|window|display|scrolling]
zumcast shot export <shot> [--format png|jpeg|pdf] [--scale 1|2]
zumcast shot web <url> [--width mobile|tablet|desktop|1440] [--dark] [--full]
zumcast search "pricing page" [--kind shot|recording] [--limit 10]
zumcast run <script.json>

Añade --json para obtener una salida que los scripts puedan leer. Los límites del plan gratis también se aplican en la línea de comandos.

Conectar un asistente de IA (MCP)

ZumCast incluye un servidor MCP, así que asistentes como Claude pueden grabar, editar con Zumi, hacer capturas y exportar, todo en tu Mac.

  1. En Ajustes › General, pulsa Copiar configuración MCP.
  2. Pégala en los ajustes MCP de tu asistente (por ejemplo, el archivo de configuración de Claude Desktop). Tiene este aspecto:
{
  "mcpServers": {
    "zumcast": {
      "command": "/Applications/Zumcast.app/Contents/SharedSupport/zumcast",
      "args": ["mcp"]
    }
  }
}

Las herramientas cubren proyectos y grabación (list_projects, search, start_recording, stop_recording), Zumi (zumi_plan, zumi_apply), exportaciones (export_video, export_all, polish, export_captions), guías y transcripciones, zooms, capturas (shot_take, shot_web, shot_render) y preajustes.

Tú tienes el control

  • Siempre que la línea de comandos, un asistente, Atajos o un enlace hace una captura o inicia una grabación, aparece un aviso en pantalla, como “Captura de pantalla hecha por Claude (MCP)”. Nunca aparece en la captura. Desactívalo en Ajustes › General.
  • Los enlaces zumcast:// que no están firmados preguntan primero “¿Permitir esta solicitud?”.
  • Los asistentes solo pueden buscar en tu biblioteca si lo permites en Ajustes › Organizar.

Guiones de grabación

Un guion de grabación es un archivo JSON de pasos (open, wait, click, hover, type, key, scroll) que ZumCast reproduce mientras graba, para que una demo salga igual cada vez. Ejecuta uno con Archivo › Ejecutar guion…, zumcast run o la herramienta MCP run_script.

Siri y Atajos

ZumCast añade acciones a la app Atajos: Hacer captura de pantalla (área, ventana o pantalla), Capturar texto, Iniciar grabación, Detener grabación y Abrir Hub. También puedes decirle a Siri “Haz una captura de pantalla con ZumCast” o “Empieza a grabar con ZumCast”.