リファレンス
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 の中で行えます。
- 設定 › 一般で MCP 設定をコピーを押します。
- アシスタントの 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 で収録を開始」と話しかけることもできます。