Muxara

Conversões de vídeo online via API

Documentação

Usamos cookies essenciais para preferências de tema e idioma. Com sua permissão, também usamos análises de terceiros do Google e da Microsoft para entender como o site é usado e melhorar o conversor. As análises não são usadas para publicidade. Veja nossa Política de Privacidade.

Aceitar análises Somente essenciais Muxara English Deutsch Français Español Italiano Nederlands Polski Svenska Українська 日本語 한국어 中文

Para agentes de IA

Converta vídeo com MCP

A Muxara expõe um servidor MCP remoto para que Claude, Cursor e outros agentes possam criar trabalhos de conversão, enviar mídia e baixar resultados.

Ferramentas

Oito ferramentas MCP espelham o fluxo de conversão do site. Os agentes chamam essas ferramentas via Streamable HTTP no endpoint abaixo.

list_conversions

Lista todas as opções de conversão com extensões de entrada aceitas e formato de saída.

get_conversion_defaults

Obtém parâmetros padrão e válidos de codec, qualidade e corte para um slug.

create_conversion_job

Cria um trabalho e recebe uma URL de upload assinada (entrada máxima de 500 MB).

confirm_upload

Confirma que o arquivo foi enviado para a URL assinada.

update_conversion_job

Altera o formato de saída ou as configurações de conversão antes do processamento.

start_conversion

Enfileira a conversão FFmpeg no worker.

get_conversion_status

Consulta o status e o progresso do trabalho quando estiver pronto.

get_media_info

Inspeciona o arquivo enviado para duração, resolução, codecs e bitrate.

Casos de uso

Assistentes de chat de IA

Um usuário pede ao assistente para converter um MKV em MP4. O agente lista formatos, cria um trabalho, orienta o upload e retorna um link de download quando estiver pronto.

Pipelines de automação

Scripts ou trabalhos de CI criam trabalhos de conversão, enviam via URLs assinadas e consultam o status sem navegador - útil para fluxos de preparação de mídia.

Descoberta de formatos

Os agentes chamam list_conversions e get_conversion_defaults antes de escolher o slug certo para a extensão de arquivo e o dispositivo de destino do usuário.

Integrações com editores e CMS

Crie ferramentas personalizadas que transferem a transcodificação para a Muxara mantendo os mesmos limites do site público.

Fluxo de trabalho

Os bytes do arquivo não são enviados por chamadas de ferramenta MCP. O upload usa uma URL assinada, igual ao site.

  1. create_conversion_job - retorna jobId e uploadUrl
  2. PUT o arquivo para uploadUrl (Content-Type: application/octet-stream)
  3. confirm_upload
  4. start_conversion (opcionalmente update_conversion_job primeiro)
  5. get_conversion_status até que o status esteja pronto
  6. Baixe da URL na resposta de status

Conectar

Use transporte Streamable HTTP. O endpoint é https://api.muxara.com/mcp.

Cursor

Adicione à sua configuração MCP (.cursor/mcp.json ou configurações do Cursor):

{
  "mcpServers": {
    "muxara": {
      "url": "https://api.muxara.com/mcp"
    }
  }
}

MCP Inspector

Execute o inspetor, escolha Streamable HTTP e insira a URL completa do endpoint:

npx @modelcontextprotocol/inspector
# Streamable HTTP → https://api.muxara.com/mcp

Autenticação

O servidor MCP é público - não são necessárias chaves de API, OAuth ou conta Muxara.

  • ✓ Sem chave de API ou cadastro
  • ✓ Streamable HTTP em api.muxara.com/mcp
  • ✓ Limites de uso justo se aplicam
  • ✓ Conversão e download gratuitos

FAQ

Preciso de uma chave de API?

Não. O servidor MCP é público com limites de uso justo, igual ao site. Não é necessário OAuth ou conta.

Posso enviar arquivos por chamadas de ferramenta MCP?

Não. create_conversion_job retorna um uploadUrl assinado. PUT o arquivo diretamente nessa URL (até 500 MB) e depois chame confirm_upload. Isso corresponde a como o uploader do navegador funciona.

A conversão MCP custa algo?

Não. Conversão e download são gratuitos, igual a muxara.com.