Woven

Permite que o Claude Code, o Codex e outros apps de IA criem e editem vídeos no Woven, o editor de vídeo com IA para Mac. Requer o app Woven.

GitHub

Documentação

Conector MCP do Woven

O Woven Video é um editor de vídeo com IA para Mac. Você importa seu material, pede a edição no chat e faz os ajustes finos em uma linha do tempo real. É um editor completo para vídeos longos e curtos: vídeos para YouTube e Shorts, podcasts, vídeos de games, Reels, TikToks e muito mais.

Este conector permite que apps de IA no seu Mac, como o Claude Code e o Codex, criem e editem vídeos no Woven. Por meio dele, o app pode:

encontrar clipes no seu Mac e trazê-los para um workspace
examinar o material
montar e editar reels, e conferir frames
adicionar legendas
gerar imagens, vídeo e áudio
exportar

O Woven faz a edição e a renderização, usando sua conta e seus créditos do Woven.

É um servidor MCP local: seu app de IA o inicia no seu Mac, e ele se comunica com o app Woven instalado ali. O Woven não tem uma API web pública, então o conector não funciona em apps de chat nem em sessões na nuvem ou na web.

Requisitos

macOS 15 ou posterior.
Woven instalado em /Applications ou ~/Applications.
Uma conta Woven com um plano ou o teste gratuito de 3 dias (cartão obrigatório). Veja preços.
Um app de IA que execute servidores MCP locais no seu Mac.

Configuração

Recomendado: cole o prompt de configuração

Copie o prompt do seu app em woven.video/setup.md e cole-o nesse app no seu Mac, uma vez. Os mesmos prompts estão no Woven em Settings → AI apps.

O prompt:

verifica se está sendo executado em um Mac;
instala o Woven com o Homebrew, somente se você concordar;
adiciona o conector do Woven ao app;
abre o Woven para você fazer login.

Esse caminho não precisa deste pacote nem do Node.js.

Manual: use este pacote

Este pacote é um pequeno inicializador. Ele encontra o Woven no seu Mac e inicia o conector que vem dentro do app. Ele precisa do Node.js para npx.

Instale o Woven. Ou baixe-o e mova-o para Aplicativos, ou execute:
```
brew install --cask woven-video/tap/woven
```
Abra o Woven uma vez e faça login.
Adicione o conector ao seu app de IA.

Claude Code

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

Codex

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

Outros apps que aceitam uma configuração MCP em JSON, como o Cursor:

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

Reinicie o app, ou inicie uma nova sessão, para que ele carregue as ferramentas do Woven.
Peça a ele para listar seus workspaces do Woven.

Você também pode dispensar este pacote e apontar seu app diretamente para o conector. É o que o prompt de configuração faz:

comando: /Applications/Woven.app/Contents/Resources/woven-sidecar
argumento: --mcp-stdio

Ferramentas

As ferramentas vêm do app Woven, então mudam quando o Woven é atualizado. Esta lista é do Woven 0.2.23.

Área	Ferramentas
Workspaces e arquivos	`list_workspaces` (comece aqui), `create_workspace`, `list_files`, `read_text_file`, `import_media`, `download_file`, `download_video`
Material e áudio	`look_at_media`, `transcribe_media`, `extract_audio`, `identify_song`
Reels	`list_reels`, `read_reel`, `write_reel_spec`, `render_frame`, `export_reel`, `open_in_woven`, `read_woven_guide`, `list_sfx_library`
Legendas	`generate_captions`, `edit_caption_words`
Geração	`list_media_models`, `generate_image`, `generate_video`, `generate_audio`, `get_generation_status`, `cancel_generation`

Todas as ferramentas, exceto o leitor de guia, precisam de uma conta Woven conectada com um plano ou o teste gratuito.

Cinco ferramentas gastam créditos do Woven: os três geradores, as legendas e a transcrição. As ferramentas de geração e transcrição instruem seu app de IA a obter sua aprovação antes do primeiro uso pago.

Como o inicializador funciona

bin/woven-mcp é um pequeno script de shell:

Ele procura Woven.app em /Applications, depois em ~/Applications.
Ele executa Woven.app/Contents/Resources/woven-sidecar --mcp-stdio.

Ele nunca escreve em stdout, porque o stdout transporta a conexão MCP. Se o Woven não estiver instalado, ele imprime em stderr onde obtê-lo e encerra com código 1. O script em si não baixa nada.

Solução de problemas

"Woven isn't installed" no log MCP do seu app: instale o Woven em /Applications ou ~/Applications e reinicie o app.
As ferramentas dizem que você precisa fazer login ou iniciar um plano: abra o Woven, faça login e inicie um plano ou o teste.
Nenhuma ferramenta do Woven após a configuração: reinicie o app ou inicie uma nova sessão. Os apps carregam novos servidores MCP quando iniciam.
Um Woven mais antigo: atualize-o pela barra de menus com Woven → Check for Updates….

Licença

A licença MIT em LICENSE cobre apenas este inicializador e seu empacotamento. O app Woven e seu conector são proprietários e regidos pelos termos do Woven.