Transloadit via MCP

O que seu agente pode fazer

Ao se conectar, ele ganha sete ferramentas, divididas em quatro funções:

• Descobrir o que é possível. transloadit_list_robots retorna o catálogo com um resumo por Robot, e transloadit_get_robot_help retorna os parâmetros de um deles. O agente não precisa ter sido treinado com a nossa documentação para nos usar corretamente.
• Verificar o próprio trabalho antes que ele custe qualquer coisa. transloadit_lint_assembly_instructions valida um conjunto de Assembly Instructions sem criar uma Assembly e retorna problemas estruturados em vez de texto corrido.
• Executar o Job. transloadit_create_assembly cria ou retoma uma Assembly, fazendo upload dos arquivos e aguardando o resultado se você pedir.
• Acompanhá-lo até o fim. transloadit_get_assembly_status e transloadit_wait_for_assembly acompanham uma Assembly em execução, e transloadit_list_templates reutiliza os Templates que você já tem.

Ele pode explorar antes de poder gastar

O catálogo e o linter não precisam de credenciais. Um agente pode listar todos os Robots, ler os parâmetros dos que lhe interessam e ter um rascunho validado, tudo isso antes de existir uma conta. Se você pedir que ele faça o lint de um Step com um erro, ele recebe o erro de volta:

{
  "severity": "error",
  "path": "instructions",
  "message": "Path `steps.resized` has unrecognized keys: `widht`"
}

Qualquer coisa que envolva uma conta é outra história. Listar seus Templates ou criar uma Assembly sem credenciais retorna mcp_missing_auth, e não um palpite nem um resultado parcial. Depois de autorizado, um agente pode criar trabalho faturável sem uma confirmação separada para cada Assembly. Controle as permissões e a política de novas tentativas dele antes de fornecer credenciais.

Por que isso é melhor do que entregar uma chave de API a um agente

Um agente apontado para uma REST API precisa já conhecer o formato da coisa. Ele chuta o nome de um parâmetro, envia a requisição e só descobre que errou depois que o Job falhou, o que custa uma ida e volta, na melhor das hipóteses, e uma cobrança de codificação, na pior.

As Assembly Instructions são JSON declarativo, o tipo de artefato que um agente produz bem. Combinar isso com descoberta e um linter fecha o ciclo antes que qualquer coisa rode: ele pode perguntar o que existe, escrever os Steps, pedir que sejam verificados e só então criar a Assembly. O processamento em si acontece na nossa infraestrutura, então não há FFmpeg para instalar nem disco local para encher.

Como conectar

O caminho mais rápido é o endpoint hospedado:

https://api2.transloadit.com/mcp

Clientes que buscam capacidades podem ler o cartão legível por máquina em /.well-known/mcp/server-card.json⁠, que lista as ferramentas e seus esquemas de entrada.

Rodar o servidor por conta própria via stdio costuma ser a melhor opção depois que você passa da fase de testes, porque o processo passa a guardar TRANSLOADIT_KEY e TRANSLOADIT_SECRET e cuida da autenticação para você. A documentação do servidor MCP traz as duas configurações, incluindo os trechos de configuração do cliente.

O que ele não faz

• Ele orquestra a Transloadit. Não executa código arbitrário nos seus arquivos e não consegue fazer nada que a API não conseguiria.
• A codificação é cobrada normalmente. Limite as novas tentativas e a concorrência do agente, use credenciais com escopo restrito e monitore o uso do Workspace. Autenticação não é um teto de gastos.
• As ferramentas cobrem Assemblies, Robots e Templates. Administração da conta, faturamento e credenciais ficam de fora, de propósito.
• Ele não substitui a leitura da documentação dos Robots quando é você quem está projetando o pipeline. Ele é o que você usa quando quem projeta é o agente.

Crie um Workspace gratuito para obter as credenciais ou leia primeiro a documentação do servidor MCP.