Woven

Woven MCP コネクター

Woven Video は Mac 向けの AI 動画エディターです。映像素材を読み込み、チャットで編集内容を指示し、実際のタイムラインで細かく調整できます。長編・短編を問わず、YouTube 動画や Shorts、ポッドキャスト、ゲーム動画、Reels、TikTok などに対応した本格的なエディターです。

このコネクターを使うと、Claude Code や Codex など、Mac 上の AI アプリで Woven の動画を作成・編集できます。アプリでは、次の操作ができます。

• Mac 上のクリップを検索して、ワークスペースに取り込む
• 映像素材を確認する
• リールを作成・編集し、フレームを確認する
• キャプションを追加する
• 画像、動画、音声を作成する
• 書き出す

編集とレンダリングは Woven が行い、Woven アカウントとクレジットを使用します。

これはローカル MCP サーバーです。AI アプリが Mac 上で起動し、そこにある Woven アプリと通信します。Woven には公開ウェブ API がないため、チャットアプリやクラウド・ウェブセッションではこのコネクターは動作しません。

必要条件

• macOS 15 以降。
• /Applications または ~/Applications にインストールされた Woven。
• プランに加入した Woven アカウント、または 3 日間の無料トライアル（カードが必要です）。料金をご覧ください。
• Mac 上でローカル MCP サーバーを実行できる AI アプリ。

セットアップ

推奨：セットアッププロンプトを貼り付ける

お使いのアプリ用のプロンプトを woven.video/setup.md からコピーし、Mac 上のそのアプリに一度貼り付けてください。同じプロンプトは Woven の Settings → AI apps にもあります。

プロンプトでは、次の操作を行います。

1. Mac 上で実行されていることを確認します。
2. 同意した場合に限り、Homebrew で Woven をインストールします。
3. Woven のコネクターをアプリに追加します。
4. サインインできるよう、Woven を開きます。

この方法では、このパッケージも Node.js も必要ありません。

手動：このパッケージを使う

このパッケージは小さなランチャーです。Mac 上の Woven を見つけ、アプリに同梱されているコネクターを起動します。npx の実行に Node.js が必要です。

1. Woven をインストールします。ダウンロードして Applications に移動するか、次を実行してください。

   brew install --cask woven-video/tap/woven
   

2. Woven を一度開いてサインインします。

3. AI アプリにコネクターを追加します。

Claude Code

claude mcp add --scope user woven -- npx -y @woven-video/mcp

Codex

codex mcp add woven -- npx -y @woven-video/mcp

Cursor など、JSON MCP 設定を受け付けるその他のアプリ：

{
  "mcpServers": {
    "woven": {
      "command": "npx",
      "args": ["-y", "@woven-video/mcp"]
    }
  }
}

4. Woven のツールを読み込ませるため、アプリを再起動するか、新しいセッションを開始します。
5. Woven のワークスペースを一覧表示するよう指示します。

このパッケージを使わず、アプリからコネクターを直接指定することもできます。セットアッププロンプトはこの方法を使います。

• コマンド：/Applications/Woven.app/Contents/Resources/woven-sidecar
• 引数：--mcp-stdio

ツール

ツールは Woven アプリに同梱されているため、Woven のアップデートに伴って変更されます。この一覧は Woven 0.2.23 のものです。

分野	ツール
ワークスペースとファイル	list_workspaces（ここから始めます）、create_workspace、list_files、read_text_file、import_media、download_file、download_video
映像素材と音声	look_at_media、transcribe_media、extract_audio、identify_song
リール	list_reels、read_reel、write_reel_spec、render_frame、export_reel、open_in_woven、read_woven_guide、list_sfx_library
キャプション	generate_captions、edit_caption_words
生成	list_media_models、generate_image、generate_video、generate_audio、get_generation_status、cancel_generation

ガイドの読み取りツールを除くすべてのツールを使うには、プランに加入した Woven アカウント、または無料トライアルにサインインしている必要があります。

5 つのツールは Woven クレジットを消費します。3 つの生成ツール、キャプション、文字起こしです。生成ツールと文字起こしツールは、初回の有料利用前に AI アプリがユーザーの許可を求めるよう指示します。

ランチャーの動作

bin/woven-mcp は短いシェルスクリプトです。

1. /Applications、次に ~/Applications の順に Woven.app を探します。
2. Woven.app/Contents/Resources/woven-sidecar --mcp-stdio を実行します。

標準出力は MCP 接続に使われるため、標準出力には何も書き込みません。Woven がインストールされていない場合は、入手先を標準エラー出力に表示し、コード 1 で終了します。スクリプト自体が何かをダウンロードすることはありません。

トラブルシューティング

• アプリの MCP ログに「Woven がインストールされていません」と表示される場合： Woven を /Applications または ~/Applications にインストールしてから、アプリを再起動してください。
• ツールからサインインまたはプランの開始を求められる場合： Woven を開いてサインインし、プランまたはトライアルを開始してください。
• セットアップ後に Woven のツールが表示されない場合： アプリを再起動するか、新しいセッションを開始してください。アプリは起動時に新しい MCP サーバーを読み込みます。
• Woven が古い場合： メニューバーの Woven → Check for Updates… から更新してください。

リンク

• Woven 製品ガイド
• 動画編集 MCP サーバーとは？
• プライバシー · 利用規約 · お問い合わせ
• MCP Registry 名：io.github.woven-video/woven

ライセンス

LICENSE に記載されている MIT ライセンスは、このランチャーとそのパッケージングのみを対象とします。Woven アプリとそのコネクターはプロプライエタリであり、Woven の利用規約が適用されます。