Claude・Gemini CLIからZimakuを操作する（MCP連携）

MCP（Model Context Protocol）連携をONにすると、ZimakuはローカルのMCPサーバー（zimaku-mcp）として動き、接続した外部AIクライアントから起動中のZimakuを操作できるようになります。ツールは5系統です。

読み取り（5ツール）
- list_jobs — ジョブ一覧をstatusで絞り込み取得（最大件数1〜100、既定20）
- get_transcript — 文字起こし本文をoffset/limitでページ送り取得（1ページ最大500件、既定200件）
- search_segments — セグメント全文検索（話者IDでの絞り込みは任意）
- get_speaker_segments — 指定した話者の発言だけを抽出
- search_knowledge — プロジェクト内の参照資料やチャット添付を横断するRAG検索（project/session/bothでスコープ指定、ヒット数1〜20・既定5）

編集（6ツール）
- edit_segment / split_segment / merge_segment — セグメントの本文・時間修正、分割、結合
- manage_speakers — 話者の作成・リネーム・統合・削除
- undo / redo — 直前の操作を取り消し・やり直し

ジョブ（4ツール）
- start_transcription — 新規の文字起こし開始（話者数は0〜10、0で自動判定）
- batch_submit — 最大100ファイルの一括投入（結合して1ジョブにするconcatオプションあり）
- get_job_status — 進捗のポーリング
- batch_control — キューの開始・並べ替え・再試行（retryはresume/restartの2モード）

エクスポート（2ツール）
- export — SRT・Premiere・Premiere XML・FCPXML・字幕焼き込みMP4の5形式で書き出し。形式ごとに失われる装飾を警告として返す
- get_export_status — MP4焼き込みなど時間のかかる書き出しの進捗確認

スタイル（3ツール）
- get_subtitle_style — 現在のスタイル設定を取得
- update_subtitle_style — フォント・色・太字・縁取り・影・背景・位置・字間行間・拡大縮小・回転など21属性を更新（clear_fieldsで個別設定を解除しグローバル値の継承に戻せる）
- reset_segment_style — セグメント単位の上書きをリセット

音声・映像ファイル自体はAIクライアントに送られません。やり取りされるのはテキストデータ（文字起こし本文・スタイル設定・ジョブ状態など）のみです。

MCP連携は既定で無効です。有効化から実際にAIクライアントで使えるようになるまでの流れは次のとおりです。

- 既定OFF＋明示同意: トグルをONにする前に必ず「MCP 連携を有効化しますか？」の確認ダイアログが挟まります。「起動中のZimakuで開いているすべての文字起こしデータが、接続した外部AIクライアントから閲覧・編集できるようになります」という注意文を読んだ上で「有効化する」を押さない限り、有効化されません。
- 破壊的操作は既定で無効: 話者削除やジョブのキャンセルなど取り返しのつかない操作は、サーバー側の環境変数（ZIMAKU_MCP_ALLOW_DESTRUCTIVE）で明示的にopt-inしない限り実行できません。AIに「話者を削除して」と頼んでも、既定設定では拒否されます。
- アクセス範囲はMCP Rootsで許可したフォルダ内のみ: start_transcriptionなどファイルパスを扱うツールは、クライアント側で許可したフォルダの外を指定しても実行できません。
- Pro以上のプラン限定: Freeプランではトグル自体が無効化され「MCP 連携には Pro 以上のプランが必要です。」と表示されます。「Pro を確認」ボタンからアップグレード導線に進めます。ライセンスが期限切れ・解約・返金・停止になった場合も自動でMCP連携が無効化されます。
- いつでも遮断できる: トグルをOFFにすると接続情報が削除され、即座に接続が遮断されます。
- ChatGPTは現時点で非対応: MCPのローカル接続方式（stdio）に対応していないため、設定画面にもその旨の注記が表示されます。対応クライアントはClaude Desktop・Claude Code・VS Code・Gemini CLIです。