DeepSeek で KwaFlux を使う方法：DeepSeek Harness（DSH）を MCP で接続する

要点

• DeepSeek Harness（DSH）は、cordis.patch.yml ファイルに書いた insert 行 1 つで KwaFlux につながります。この行は KwaFlux が生成してくれます。
• 行は、実際に使う DSH が読み込む場所に置きます。ホームパッチの ~/.dsh/cordis.patch.yml はすべてのプロファイルに、各プロファイル専用のファイルはそのプロファイルだけに適用されます。
• DSH はパッチファイルをホットリロードするので、たいてい再起動しなくてもツールが表示されます。
• DeepSeek が長い動画ジョブを待っている途中で打ち切られないよう、1 回の呼び出しあたりのツールタイムアウトを延ばしておきましょう。

DeepSeek のエージェントは、アプリと一緒にインストールされるローカル MCP サーバーを通じて KwaFlux を操作できます。DeepSeek Harness（DSH）は、cordis.patch.yml という階層型の設定ファイルに書かれたプラグイン行として MCP サーバーを読み込みます。KwaFlux の MCP ホストで DeepSeek を選んで行をコピーし、使っている DSH プロファイルが読み込むパッチファイルに追記します。

この記事では、行をどこに書くか、なぜプロファイルが重要なのか、どのタイムアウトを延ばすか、そして DeepSeek に最初に頼むとよいことを解説します。

目次

1. DSH は MCP サーバーをどう読み込むか
2. 始める前に
3. ステップ 1：KwaFlux から行をコピーする
4. ステップ 2：正しいパッチファイルを選ぶ
5. ステップ 3：行を追記する
6. ステップ 4：読み込まれたか確認する
7. 最初の依頼
8. トラブルシューティング
9. よくある質問

DSH は MCP サーバーをどう読み込むか

DeepSeek Harness は、パッチファイルを何層にも重ねて設定を組み立てます。プロファイルにはそれぞれ専用の cordis.patch.yml があり、ホームレベルの $DSH_HOME/cordis.patch.yml は、CLI リファレンスの言葉を借りれば「すべてのプロファイルで共有される、そのマシン固有の設定であり、そのためプロファイルごとのレイヤーより優先される」ものです。

MCP サーバーは、DSH の MCP クライアントプラグイン @deepseek-ai/dsh-mcp-client を使う行として書きます。DSH は初期状態では MCP サーバーを 1 つも有効にしていません。リファレンスはその理由を「各サーバーのコマンドは、エージェントのサンドボックスの外で動く、信頼された実行可能コードである」と説明しています。KwaFlux を追加するということは、KwaFlux のサーバーを信頼すると明示的に選ぶことです。

始める前に

• KwaFlux 1.0.14 以降を起動しておく。
• PATH の通った Node.js 18 以降。 node --version で確認します。KwaFlux の設定カードも Node.js を探し、下の例のようにそのフルパスを設定に書き込みます。見つからない場合はその旨を表示し、代わりに node と書き込みます。
• DeepSeek Harness をインストール済み。 DSH はドキュメントで Preview と表記されているため、リリースごとにパスやコマンドが変わる可能性があります。

ステップ 1：KwaFlux から行をコピーする

KwaFlux で 設定 › Agent（MCP） を開き、MCP ホスト で DeepSeek を選んで、設定をコピー をクリックします。Windows に既定の場所でインストールした場合、行は次のとおりです。

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']

補足： パスはシングルクォートで囲んであります。YAML ではシングルクォートの文字列はバックスラッシュをそのまま残すので、Windows のパスをエスケープする必要はありません。

ステップ 2：正しいパッチファイルを選ぶ

KwaFlux のヒントが挙げているファイルは 1 つだけです。「~/.dsh/profiles/web/cordis.patch.yml にこの insert 行を追加し、DSH セッションを再起動します。」DSH の web プロファイル（dsh web）を使っているなら、これで合っています。それ以外の使い方なら、次の表に沿って選んでください。

Windows では ~ は C:\Users\<you> です。DSH_HOME を設定している場合は、~/.dsh の代わりにそのフォルダーを使います。

DSH で KwaFlux が「表示されない」原因としていちばん多いのは、使っていないプロファイルに行を追加してしまうことです。

ステップ 3：行を追記する

1. まずファイルをバックアップします。
2. パッチファイルは YAML のリストです。KwaFlux の行を末尾に、ほかの最上位の - insert: や - replace: の項目と同じインデントで追加します。
3. ファイルがまだない場合は、KwaFlux の行だけを書いて作成します。
4. 必要に応じて、config: の中でツールのタイムアウトを延ばします。

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
        toolCallTimeoutMs: 330000

サードパーティの設定ガイドによると、DSH の 1 回の呼び出しあたりの既定のタイムアウトは 60 秒とされています。KwaFlux の待機ツールは 1 回の呼び出しで最大 300 秒待つことがあるので、330,000 ミリ秒にしておけば余裕があります。お使いの DSH のバージョンがこのフィールドを受け付けない場合は削除してください。打ち切られても、DeepSeek はもう一度待つことができます。

ステップ 4：読み込まれたか確認する

DSH はパッチファイルを監視し、正しい編集をホットリロードで反映するので、保存してから数秒でサーバーが起動するのがふつうです。何も変わらない場合は、KwaFlux のヒントにあるとおり DSH セッションを再起動します。

そのうえで、次のように頼みます。

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

DSH では、KwaFlux のツールは mcp__kwaflux__kwaflux_get_app_status のように mcp__kwaflux__<tool> という名前になります。KwaFlux が閉じている場合、ツールは app_not_running で始まるエラーを返します。

最初の依頼

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

トラブルシューティング

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

まとめ

KwaFlux から行をコピーし、実際に使っている DSH が読み込むパッチファイルに書き、動画ジョブ向けにツールのタイムアウトを長めにします。保存すれば DSH が再読み込みします。あとは KwaFlux を開いたままにして、最初の本番ジョブの前に、DeepSeek にアプリの状態を確認させましょう。

DeepSeek から KwaFlux を操作する

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

KwaFlux を入手 · プランを見る