AI アシスタントに動画ソフトを操作させる：KwaFlux MCP クイックスタート

ひと言でいうと

KwaFlux にはローカルの MCP サーバーが入っているので、Cursor、Claude、Codex などの AI アシスタントが、あなたのパソコン上で KwaFlux の処理を実際に動かせます。壊れたクリップの修復、高画質化、音声のノイズ除去、圧縮、変換といった処理です。あなたは依頼を書くだけ。処理は KwaFlux が行い、各タスクは KwaFlux のウィンドウに表示されます。

• KwaFlux にはローカルの MCP サーバーが入っています。Cursor、Claude、Codex などの AI アシスタントが、貼り付け用の ffmpeg コマンドを書くのではなく、あなたのパソコン上で KwaFlux の処理そのものを実行できます。
• 設定は 3 ステップです。Node.js をインストールし、KwaFlux の設定から設定スニペットをコピーし、アシスタントで MCP を再読み込みします。
• 現在の KwaFlux にある 40 の機能のうち 31 をチャットから開始できます。16 の AI エンハンスツール、ファイル修復、圧縮、64 形式への変換などです。
• 主導権はあなたにあります。エージェントによるダウンロードは初期状態でオフ、スイッチ 1 つで AI からの操作をすべて止められ、アシスタントが始めたタスクはどれも KwaFlux に表示されます。

設定は 3 ステップで、コマンドラインは使いません。結果は元のファイルと同じ場所に保存され、あなたが許可しない限り、Web から何かがダウンロードされることはありません。

この記事では、KwaFlux MCP とは何か、アシスタントの接続方法、頼める内容、そしてデスクトップアプリに残る機能を解説します。

目次

1. KwaFlux MCP とは？
2. 頼めること
3. ステップ 1：Node.js をインストールする
4. ステップ 2：KwaFlux から設定をコピーする
5. ステップ 3：アシスタントに頼む
6. アシスタントにあなたの許可が必要なとき
7. 一度で通る依頼のコツ
8. トラブルシューティング
9. デスクトップアプリに残る機能
10. よくある質問

KwaFlux MCP とは？

KwaFlux MCP は KwaFlux と一緒にインストールされる小さなサーバーです。同じパソコン上の AI アシスタントが、Model Context Protocol を通じて KwaFlux の機能をツールとして呼び出せるようにします。

MCP は、AI アプリが外部のツールとつながるためのオープンなプロトコルです。アシスタント（「ホスト」）が KwaFlux のサーバーをローカルのプロセスとして起動し、標準入出力でやり取りします。サーバーは受け取った依頼を起動中の KwaFlux アプリに渡し、アプリがそれをチェックしたうえで、あなたがクリックで始めたジョブと同じタスクキューに入れます。

ここが大事なところです。アシスタントはコマンドラインのオプションを当て推量で組み立てるわけではありません。ファイル、モジュール、出力サイズといった型の決まった項目をいくつか埋めるだけで、ジョブ全体は KwaFlux が、あなたが書き出しをクリックしたときと同じルールで組み立てます。そのしくみはAI アシスタントが KwaFlux でできることをご覧ください。

頼めること

アシスタントはほかにも、タスクの一覧表示、リアルタイムの進捗バーを見ながらの完了待ち、そして自分が始めたタスクの一時停止、再開、キャンセル、再試行ができます。

ステップ 1：Node.js をインストールする

アシスタントは、ほとんどのローカル MCP サーバーと同じように、Node.js で KwaFlux の MCP サーバーを起動します。KwaFlux にはサーバーのスクリプトが含まれていますが、Node.js 本体は含まれていません。

1. KwaFlux で 設定 を開き、Agent（MCP） に進みます。
2. Node.js が見つからない、またはバージョンが古いと表示されたら、ページのリンクから nodejs.org で現在の LTS 版をダウンロードしてインストールします。
3. ページに戻ると再チェックが行われ、見つかったバージョンが表示されます。

補足： KwaFlux が出力する設定には、Node.js のフルパスが書き込まれます。Dock やスタートメニューから起動したアシスタントが自分の PATH で Node を見つけられず、「サーバーが起動しない」というよくある問題を避けられます。

ステップ 2：KwaFlux から設定をコピーする

同じ Agent（MCP） ページの MCP ホスト で、使っているアシスタントを選びます。KwaFlux は Codex、Claude、OpenClaw、DeepSeek（DSH）、Hermes、Cursor の 6 つのホスト向けに設定を生成します。

1. ホストを選びます。
2. スニペットをコピーします。ホストがインストール機能に対応していれば、それを使ってもかまいません。
3. ホストの MCP 設定に追加します。追加するのは kwaflux の項目だけで、ファイル全体を置き換えないでください。
4. アシスタントで MCP を再読み込みするか、新しいセッションを始めます。

設定ファイルの場所はホストごとに違います。それぞれの置き場所はホスト別の設定ガイドにまとめています。ローカルの stdio MCP サーバーに対応したほかのアプリも、MCP の設定ページの手順で接続できます。

アシスタントを使っている間は KwaFlux を開いたままにしておきます。MCP サーバーは伝言役で、実際の処理はアプリで行われます。

ステップ 3：アシスタントに頼む

まずは読み取りだけの依頼で、接続できているか確かめましょう。

KwaFlux は起動してる？最近のタスクを一覧にして。

次に、ファイルのフルパスを添えて実際のジョブを試します。

D:\Videos\trip.mp4 を TikTok のフォーマットに変換して、終わったら教えて。

アシスタントは変換ツールを呼び出し、そのタスクの完了を待ちます。KwaFlux のタスクリストには、どのアシスタントが送ったかを示すタグ付きでタスクが表示されるので、自分のジョブと区別できます。完了すると新しいファイルが trip.mp4 と同じ場所に保存され、アシスタントにはそのファイル名が返されます。

ホストによっては、KwaFlux に組み込まれた 4 つのワークフローがプロンプトやスラッシュコマンドとして表示されます。破損した動画の修復、プラットフォーム向けの書き出し、ダウンロードしてから変換、AI 画質修復の 4 つで、アシスタントが適切なツールを順番に使えるよう導きます。

アシスタントにあなたの許可が必要なとき

アシスタントではなく、あなたが決めるべきこともあります。KwaFlux はそうした操作を、あなたしかクリックできないアプリ側で扱います。

• ダウンロードは初期状態でオフです。 エージェント許可 の エージェントによるダウンロードを許可 は、オフ のままにしておくことも、毎回確認 にしてリンク、保存先フォルダー、形式をデスクトップのポップアップで確かめることも、確認なしでダウンロードを通す 3 つ目の選択肢にすることもできます。応答のないポップアップは 120 秒で失効します。詳しくはAI がダウンロードを代わりに承認できない理由をご覧ください。
• スイッチ 1 つで AI からの操作をすべてオフにできます。 そのスイッチが AI エージェントによる KwaFlux の操作を許可 です。同じページには接続中のアシスタントが表示され、最近のエージェント操作 には、それらが行った直近 200 件の呼び出しがパラメーター抜きで並びます。
• アシスタントが管理できるのは自分のタスクだけです。 あなたがウィンドウで始めたジョブは見えますが、一時停止、キャンセル、再試行はできません。

一度で通る依頼のコツ

• フルパスを伝える。 KwaFlux が受け付けるのは D:\Videos\clip.mp4 や /Users/you/Movies/clip.mov のようなローカルのパスだけで、ネットワークドライブは使えません。
• 設定値ではなく目的を伝える。 「メールで送れるくらい小さく」「Instagram 用に」と言えば、アシスタントが合うプリセットを選びます。
• 修復の前に診断する。 破損ファイルのチェックはすぐ終わり、そのあとの修復には診断が推奨したモードが使われます。
• 待つように頼む。 「終わったら教えて」と添えると、アシスタントはジョブがキューに入った時点で成功と報告せず、タスクを最後まで追いかけます。

ヒント： サーバーが読み込むツールをホスト側で絞れる場合は、環境変数 KWAFLUX_MCP_TOOLSETS に、convert,repair のように使うグループだけを指定できます。ツールが少ないほど、モデルのコンテキストに余裕が残ります。

トラブルシューティング

デスクトップアプリに残る機能

9 つの機能は、作業中にあなたが画面を見る必要があります。範囲を囲む、被写体をクリックする、プレビューを見て判断する、といった操作です。これらはあえてアプリに残しています。人物背景除去、空の置き換え、物体除去、フレーム補間、字幕編集などです。こうした機能を頼まれた場合、アシスタントは、あなたがどこをクリックしたいのかを推測せず、KwaFlux で操作するよう案内する指示を受けます。

無料の 1・3・5 秒のプレビューも、アプリでのみ使えます。

まとめ

Node.js をインストールし、設定をコピーして、アプリを開いておく。それだけで、修復、高画質化、圧縮、変換のように普段クリックで進めているジョブを一文で始められ、しかもそのすべてを確認し、止めることができます。壊れたファイルからアップロードできる状態のコピーまでの一連の例は、AI エージェントによる修復ワークフローの全手順をご覧ください。

KwaFlux には、Codex、Claude、Cursor などの MCP アプリ向けのローカル MCP サーバーが入っています。AI 処理はご自身の GPU 上で実行され、メディアファイルが処理のためにアップロードされることはありません。Windows 10（64 ビット、バージョン 1809 以降）、Windows 11、Apple Silicon 搭載の macOS 12 以降で動きます。ファイルの読み込みやアプリの操作にアカウントは不要です。ログインと有料プランが必要なのは、書き出し、変換、ファイル修復、リンクからのファイルダウンロードだけです。

KwaFlux を入手 · プランを見る