MCP

Servidor MCP

Use o MLMux em assistentes de IA e agentes de código como Claude Code, Cursor e VS Code por meio do Model Context Protocol: liste modelos, estime custos, gere imagens e crie vídeos.

Endpoint e autenticação

O servidor MCP do MLMux é um servidor remoto que utiliza o transporte Streamable HTTP. Adicione-o ao seu cliente com esta URL:

Streamable HTTP

https://www.mlmux.com/api/mcp

Autentique-se com sua chave de API do MLMux no cabeçalho Authorization: Bearer; crie uma em Chaves de API. O servidor repassa a chave para a API do MLMux a cada chamada e não a armazena. Sem uma chave, apenas list_models e estimate_cost funcionam.

Conectar um cliente

Escolha seu cliente e adicione o servidor. Cada exemplo lê a chave do seu ambiente ou a solicita, para que ela nunca fique salva em um arquivo de configuração que você possa compartilhar.

claude mcp add --transport http mlmux https://www.mlmux.com/api/mcp \
  --header "Authorization: Bearer $MLMUX_API_KEY"

Defina MLMUX_API_KEY no seu shell primeiro e, em seguida, execute o comando uma vez.

Qualquer cliente compatível com servidores MCP remotos via Streamable HTTP com um cabeçalho personalizado funciona da mesma forma.

Ferramentas

O servidor oferece sete ferramentas. Os clientes as exibem ao assistente, que escolhe uma com base no que você solicitar.

Ferramenta	Chave de API	Descrição
`list_models`	Não necessária	Lista modelos de imagem e vídeo com seus IDs de modelo, tarefas, dimensões e preços estimados em cada rota.
`estimate_cost`	Não necessária	Estima o custo de uma quantidade de imagens ou clipes de vídeo em ambas as rotas, com os mesmos preços da calculadora de preços.
`generate_image`	Obrigatória	Gera imagens a partir de um prompt e retorna suas URLs. Debita do seu saldo.
`edit_image`	Obrigatória	Edita ou combina imagens de referência (URLs públicas) com um prompt e retorna as URLs das novas imagens. Debita do seu saldo.
`create_video`	Obrigatória	Inicia uma tarefa de vídeo do Seedance (texto para vídeo, imagem para vídeo ou primeiro e último quadro) e retorna o ID da tarefa. Debita do seu saldo quando o vídeo for concluído com sucesso.
`get_task`	Obrigatória	Retorna o status de uma tarefa e, assim que concluída com sucesso, as URLs de saída e o valor cobrado.
`get_balance`	Obrigatória	Retorna o saldo dos seus créditos.

Faturamento

generate_image, edit_image e create_video são faturados exatamente como as requisições normais da API, de acordo com as tarifas na página de preços: 1 crédito = 1 dólar americano, e requisições com falha não são cobradas. A maioria dos clientes solicita sua aprovação antes de executar uma ferramenta; peça ao assistente para executar estimate_cost primeiro quando o custo for relevante.

Limites

As ferramentas de imagem aguardam até cerca de quatro minutos pelo resultado. Uma imagem mais lenta retorna um ID de tarefa; solicite get_task para buscá-la mais tarde.
create_video retorna imediatamente com um ID de tarefa. O assistente então chama get_task até que o vídeo esteja pronto.
As requisições via MCP contam para o limite da sua conta de 60 tarefas em execução simultânea.
O login com OAuth ainda não está disponível, portanto conectores que o exigem, como os dos apps web claude.ai e ChatGPT, não conseguem se conectar por enquanto. Clientes que aceitam cabeçalhos personalizados funcionam normalmente hoje.