Construa um Agente de Edição de Vídeo com Claude e FFmpeg Micro MCP

Publicado originalmente em ffmpeg-micro.com

A maioria dos desenvolvedores que usam IA para edição de vídeo ainda faz isso manualmente. Eles pedem ao Claude ou ao ChatGPT para gerar um comando FFmpeg, copiam, colam em um terminal, depuram os erros e repetem. Isso funciona para trabalhos pontuais. Mas se você está construindo um produto ou fluxo de trabalho onde os usuários descrevem edições de vídeo em inglês simples e recebem resultados automaticamente, você precisa de algo diferente.

Você precisa de um agente. Um agente de IA que entende operações de vídeo, chama a API correta e retorna o vídeo finalizado sem que ninguém toque em um terminal.

Este tutorial constrói exatamente isso usando Claude e o servidor FFmpeg Micro MCP. Ao final, você terá um agente funcional que aceita instruções em linguagem natural como "corte este vídeo para os primeiros 30 segundos e converta-o para 720p" e executa todo o trabalho.

O Que Você Está Construindo

O fluxo é assim:

1. O usuário descreve uma edição de vídeo em inglês simples
2. Claude interpreta o pedido e escolhe as operações FFmpeg corretas
3. O servidor MCP chama a API de nuvem FFmpeg Micro
4. A API processa o vídeo e retorna uma URL de download
5. O agente entrega o resultado

Sem instalação local do FFmpeg. Sem comandos de shell. Sem intervenção manual após o prompt inicial.

Pré-requisitos

Você precisa de três coisas:

• Uma conta FFmpeg Micro. Cadastre-se em ffmpeg-micro.com (o plano gratuito funciona para testes).
• Claude Desktop, Claude Code ou Cursor. Qualquer ferramenta de IA compatível com MCP funciona.
• 2 minutos para configuração. A configuração do servidor MCP é um único bloco JSON.

Passo 1: Conectar o Servidor FFmpeg Micro MCP

Adicione isso ao seu arquivo de configuração MCP:

{
  "mcpServers": {
    "ffmpeg-micro": {
      "type": "http",
      "url": "https://mcp.ffmpeg-micro.com"
    }
  }
}

Na primeira vez que você usar, seu navegador abrirá para o login OAuth. Depois disso, o token é armazenado em cache.

Locais dos arquivos de configuração:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)
• Claude Code: arquivo de nível de projeto .mcp.json ou ~/.claude.json
• Cursor: Configurações > Configurações do Cursor > MCP

Se sua ferramenta ainda não suporta HTTP MCP, use o transporte stdio em vez disso:

{
  "mcpServers": {
    "ffmpeg-micro": {
      "command": "npx",
      "args": ["-y", "@ffmpeg-micro/mcp-server"],
      "env": {
        "FFMPEG_MICRO_API_KEY": "seu_api_key_aqui"
      }
    }
  }
}

Passo 2: Entender as Ferramentas Disponíveis

Uma vez conectado, Claude pode chamar seis ferramentas MCP:

Para a maioria dos fluxos de trabalho de agentes, transcode_and_wait é o que você deseja. Ele cria o trabalho e bloqueia até que o vídeo esteja pronto, para que o agente possa retornar o link de download em uma única vez.

Passo 3: Execute Seu Primeiro Comando de Agente

Abra o Claude (ou qualquer ferramenta que você conectou) e tente isso:

Pegue este vídeo e converta-o para 720p MP4 com qualidade média:
https://www.ffmpeg-micro.com/samples/quickstart-sample.mp4

Claude lê seu pedido, escolhe a ferramenta certa (transcode_and_wait), constrói a chamada da API com os parâmetros corretos e aguarda o resultado. Você recebe de volta uma URL de download para o vídeo processado.

Nos bastidores, a chamada MCP se parece com isso:

{
  "inputs": [
    { "url": "https://www.ffmpeg-micro.com/samples/quickstart-sample.mp4" }
  ],
  "outputFormat": "mp4",
  "preset": {
    "quality": "média",
    "resolution": "720p"
  }
}

Você não escreveu esse JSON. Claude descobriu isso a partir da sua instrução em inglês simples.

Passo 4: Tente Operações Mais Complexas

O agente lida com