Claude Code と Claude Desktop から KwaFlux を使う方法（MCP の設定）

要点

• Claude Code は、KwaFlux が生成する claude mcp add コマンド 1 つで KwaFlux に接続できます。Claude Desktop は、claude_desktop_config.json に項目を 1 つ加えれば接続できます。
• Claude Code ではユーザースコープを使いましょう。そうすれば、1 つのフォルダーだけでなく、すべてのプロジェクトで KwaFlux を使えます。
• Claude Desktop の設定を編集したら、システムトレイに残ったアプリも含めて完全終了してください。そうしないとサーバーが読み込まれません。
• どちらのクライアントも MCP ツールを実行する前に確認を求めます。Claude Code の /mcp では、KwaFlux が接続されたかどうかと、提供されているツールの数を確認できます。

Claude は、アプリと一緒にインストールされるローカル MCP サーバーを通じて、あなたのパソコン上の KwaFlux を操作できます。Claude Code 向けには、KwaFlux がそのまま使える claude mcp add コマンドを用意します。Claude Desktop 向けには、claude_desktop_config.json にマージする JSON の項目を用意します。どちらの場合も、Claude が作業している間は KwaFlux を開いたままにしておきます。

この記事では、それぞれの Claude クライアントの接続方法、設定の保存場所、接続の確認方法、最初に頼むとよいこと、よくある問題の直し方を解説します。

目次

1. Claude Code と Claude Desktop のどちらを使う？
2. 始める前に
3. Claude Code：コマンド 1 つで設定する
4. Claude Code：プロジェクトで共有する
5. Claude Desktop：設定ファイルを編集する
6. 最初の依頼
7. 長いジョブとタイムアウト
8. トラブルシューティング
9. よくある質問

Claude Code と Claude Desktop のどちらを使う？

Claude Code は、ターミナルや IDE で使う Anthropic のコーディングエージェントです。Claude Desktop は、Windows と macOS 向けの Claude のチャットアプリです。どちらもローカルの MCP サーバーを動かせるので、どちらでも KwaFlux を使えます。

主に Claude と動画について話したいなら、Claude Desktop のほうが手軽に始められます。普段からターミナルや IDE で作業しているなら、Claude Code がそこになじみます。ほかのアシスタントについては比較記事をご覧ください。

始める前に

• KwaFlux 1.0.14 以降を起動しておく。 MCP サーバーは起動中のアプリとやり取りします。
• Node.js 18 以降を PATH の通った状態で入れておく。 KwaFlux の設定カードには「ホストは Node.js 18 以降でサーバーを起動します。Node がインストール済みで PATH にある必要があります。」と表示されます。node --version が失敗する場合は、nodejs.org から現在の LTS 版をインストールしてください。KwaFlux の設定カードは Node.js も探し、下の例のようにそのフルパスを設定に書き込みます。Node.js が見つからない場合はその旨を表示し、代わりに node と書き込みます。
• KwaFlux では： 設定 › Agent（MCP） を開き、MCP ホスト で Claude を選んでから、Claude Code か Claude Desktop を選びます。

Claude Code：コマンド 1 つで設定する

1. Claude Code を選んだ状態で、インストールコマンドをコピー をクリックします。
2. ターミナルに貼り付けて実行します。Windows に既定の場所でインストールした場合、コマンドは次のとおりです。

claude mcp add --scope user kwaflux -- "C:\Program Files\nodejs\node.exe" "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

3. 新しい Claude Code セッションを始めて /mcp を実行します。kwaflux が接続済みと表示され、ツールの数も出ていれば成功です。

このコマンドで大事なのは 2 か所です。

• **--scope user** は、すべてのプロジェクトで使えるようにサーバーを ~/.claude.json に保存します。Claude Code の既定であるローカルスコープのままだと、コマンドを実行したフォルダーでしか KwaFlux が表示されません。
• **--** は、Claude 自身のオプションと、サーバーを起動するコマンドとを区切ります。Claude Code のドキュメントには「-- 以降はすべて、手を加えずにそのままサーバーに渡されます」とあります。

Claude Code：プロジェクトで共有する

KwaFlux のヒントでは、プロジェクトのファイルを使う方法も案内しています。「プロジェクトルートの .mcp.json に追加するか、CLI を実行します。」プロジェクトの .mcp.json は、バージョン管理を通じて、そのフォルダーで作業する全員とサーバーを共有するためのものです。チームで動画プロジェクトをリポジトリに置いていて、全員が同じ場所に KwaFlux をインストールしているなら、こちらを使いましょう。

Claude Code を選んだ状態で 設定をコピー をクリックし、プロジェクトのルートに .mcp.json として保存します。

{
  "mcpServers": {
    "kwaflux": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
      ]
    }
  }
}

Claude Code は、対話型のセッションでプロジェクトの .mcp.json にあるサーバーを使う前に、承認を求めます。承認するまで、/mcp ではそのサーバーが保留中と表示されます。

Claude Desktop：設定ファイルを編集する

1. KwaFlux で Claude › Claude Desktop を選び、設定をコピー をクリックします。
2. Claude Desktop で、Claude メニューから Settings（設定）を開き、Developer（開発者）に進んで Edit Config（設定を編集）をクリックします。次のファイルが開きます。ない場合は作成されます。 - Windows：%APPDATA%\Claude\claude_desktop_config.json - macOS：~/Library/Application Support/Claude/claude_desktop_config.json
3. kwaflux の項目を mcpServers にマージします。すでにあるサーバーは消さないでください。
4. システムトレイやメニューバーのアイコンも含めて Claude Desktop を完全終了し、もう一度開きます。KwaFlux のヒントもこの点ははっきり書いています。「編集後は Claude Desktop を完全終了して再起動してください。」
5. 会話の中で、入力欄の左下にあるメニューを開いて Connectors（コネクタ）に進み、kwaflux がツールと一緒に表示されていることを確認します。

Claude Desktop は、会話の間ずっとツールを許可した場合を除き、ツールを実行するたびに承認を求めます。

最初の依頼

まずは読み取りだけの確認から始めます。

KwaFlux のツールを使って、KwaFlux が起動しているか、私がログインしているかを確認して。

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

フレーム補間と、切り抜き・置き換え系のツールはアプリに残してあり、これらを頼まれたアシスタントはあなたをアプリへ案内するよう指示されています。エージェントによるダウンロードは、エージェント許可 の エージェントによるダウンロードを許可 を 毎回確認 にしない限りオフのままです。その設定にすると、KwaFlux はダウンロードのたびにポップアップを表示し、アシスタントもチャットで、そのコンテンツをダウンロードする権利があるかをあなたに確認します。

ヒント： Claude Code では、KwaFlux のツールは mcp__kwaflux__<tool> という名前で表示されます。たとえば mcp__kwaflux__kwaflux_get_app_status です。この名前を権限ルールに書いて読み取り専用のツールを許可しておけば、Claude がタスクリストを確認するたびに承認を求められることはなくなります。

長いジョブとタイムアウト

動画のジョブには数分かかることがあります。KwaFlux の待機ツールは 1 回の呼び出しで最大 300 秒（既定は 60 秒）待ち、タスクが終わったかどうかを報告します。終わっていなければ、Claude はもう一度待つだけです。

パソコンが遅く、サーバー自体の起動に時間がかかる場合は、Claude Code のドキュメントにある起動用の環境変数 MCP_TIMEOUT を使えます。たとえば MCP_TIMEOUT=10000 claude です。ツールの呼び出しについては、プロジェクトの .mcp.json の項目にミリ秒単位の timeout フィールドを指定できます。長い待機を頼むなら、300,000 より大きい値にしてください。

トラブルシューティング

どのホストにも共通する問題は、KwaFlux MCP のトラブルシューティングガイドをご覧ください。

まとめ

Claude Code では、KwaFlux がコピーしてくれるコマンドをユーザースコープで実行し、/mcp で確認します。Claude Desktop では、claude_desktop_config.json に項目をマージし、アプリを完全終了してから開き直します。あとは KwaFlux を開いたままにして、まず状態の確認から始めましょう。

Claude から KwaFlux を操作する

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

KwaFlux を入手 · プランを見る