リファレンス

CLI、MCP、ショートカット App

ターミナル、Claude などの AI アシスタント、Siri、ショートカット App から ZumCast を操作できます。

コマンドをインストールする

設定 › 一般 › コマンドラインと AI エージェントで zumcast コマンドをインストール…を押し、Mac のパスワードを入力します。そのあと、ターミナルで次を実行します:

zumcast list --json

コマンド

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>

--json を付けると、スクリプトで読み取れる形式で出力します。無料版の上限はコマンドラインにも適用されます。

AI アシスタントを接続する(MCP)

ZumCast には MCP サーバが含まれているので、Claude などのアシスタントが、収録、Zumi での編集、ショットの撮影、書き出しをすべて Mac の中で行えます。

  1. 設定 › 一般で MCP 設定をコピーを押します。
  2. アシスタントの MCP 設定(たとえば Claude Desktop の設定ファイル)に貼り付けます。内容は次のようになります:
{
  "mcpServers": {
    "zumcast": {
      "command": "/Applications/Zumcast.app/Contents/SharedSupport/zumcast",
      "args": ["mcp"]
    }
  }
}

ツールは、プロジェクトと収録(list_projects、search、start_recording、stop_recording)、Zumi(zumi_plan、zumi_apply)、書き出し(export_video、export_all、polish、export_captions)、ガイドと文字起こし、ズーム、ショット(shot_take、shot_web、shot_render)、プリセットに対応しています。

主導権はあなたに

  • コマンドライン、アシスタント、ショートカット App、リンクがショットを撮ったり収録を始めたりすると、「Claude (MCP) がスクリーンショットを撮影しました」のような通知が画面に表示されます。この通知がキャプチャに写ることはありません。設定 › 一般でオフにできます。
  • 署名のない zumcast:// リンクは、実行前に「このリクエストを許可しますか?」と確認します。
  • アシスタントがライブラリを検索できるのは、設定 › 整理で許可した場合だけです。

収録スクリプト

収録スクリプトは、ステップ(open、wait、click、hover、type、key、scroll)を並べた JSON ファイルです。ZumCast が収録しながら再生するので、デモが毎回同じ仕上がりになります。ファイル › スクリプトを実行…、zumcast run、または MCP ツールの run_script で実行します。

Siri とショートカット App

ZumCast はショートカット App にアクションを追加します:スクリーンショットを撮る(範囲、ウインドウ、ディスプレイ)、テキストを取り込む、収録を開始、収録を停止、Hub を開く。Siri に「ZumCast でスクリーンショットを撮って」「ZumCast で収録を開始」と話しかけることもできます。