Referência

CLI, MCP e Atalhos

Controle o ZumCast pelo Terminal, por um assistente de IA como o Claude, pela Siri ou pelo app Atalhos.

Instalar o comando

Em Ajustes › Geral › Linha de comando e agentes de IA, clique em Instalar o comando zumcast… e digite a senha do seu Mac. Depois, no 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>

Adicione --json para ter uma saída que scripts conseguem ler. Os limites do plano gratuito também valem na linha de comando.

Conectar um assistente de IA (MCP)

O ZumCast inclui um servidor MCP, para que assistentes como o Claude possam gravar, editar com o Zumi, fazer capturas e exportar, tudo no seu Mac.

  1. Em Ajustes › Geral, clique em Copiar configuração MCP.
  2. Cole nos ajustes de MCP do seu assistente (por exemplo, no arquivo de configuração do Claude Desktop). Fica assim:
{
  "mcpServers": {
    "zumcast": {
      "command": "/Applications/Zumcast.app/Contents/SharedSupport/zumcast",
      "args": ["mcp"]
    }
  }
}

As ferramentas abrangem projetos e gravação (list_projects, search, start_recording, stop_recording), o Zumi (zumi_plan, zumi_apply), exportações (export_video, export_all, polish, export_captions), guias e transcrições, zooms, capturas (shot_take, shot_web, shot_render) e predefinições.

Você continua no controle

  • Sempre que a linha de comando, um assistente, os Atalhos ou um link fazem uma captura ou iniciam uma gravação, um aviso aparece na tela, como “Captura de tela feita por Claude (MCP)”. Ele nunca aparece na captura. Desative-o em Ajustes › Geral.
  • Links zumcast:// sem assinatura perguntam “Permitir esta solicitação?” primeiro.
  • Os assistentes só podem pesquisar na sua biblioteca se você permitir em Ajustes › Organizar.

Roteiros de gravação

Um roteiro de gravação é um arquivo JSON com etapas (open, wait, click, hover, type, key, scroll) que o ZumCast executa enquanto grava, para que a demo saia igual todas as vezes. Execute um em Arquivo › Executar Script…, com zumcast run ou com a ferramenta MCP run_script.

Siri e Atalhos

O ZumCast adiciona ações ao app Atalhos: Fazer Captura de Tela (área, janela ou tela), Capturar Texto, Iniciar Gravação, Parar Gravação e Abrir Hub. Você também pode dizer à Siri “Fazer uma captura de tela com o ZumCast” ou “Começar a gravar com o ZumCast”.