Transloadit via MCP

O que seu agente pode fazer

As ferramentas se dividem em quatro funções. A documentação do servidor MCP lista cada ferramenta com as permissões de que ela precisa.

• 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 trabalho. transloadit_create_assembly cria ou retoma uma Assembly, fazendo upload dos arquivos e aguardando o resultado se você pedir.
• Acompanhar o trabalho 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

A descoberta e o lint não criam Assemblies. Um agente pode listar todos os Robots, ler os parâmetros dos que lhe interessam e ter um rascunho validado antes de executar qualquer coisa. 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`"
}

O endpoint hospedado pede que você faça login antes que qualquer ferramenta seja executada, incluindo a descoberta e o lint. Para usá-los sem uma conta, rode o servidor por conta própria. Listar seus Templates e criar Assemblies sempre exige credenciais, também em um servidor com hospedagem própria.

Criar uma Assembly pode iniciar trabalho faturável. A ferramenta transloadit_create_assembly é marcada como destrutiva, e se você precisará confirmar cada chamada depende do seu cliente. Não confie nessa confirmação: defina as permissões e a política de novas tentativas do agente antes de conectá-lo.

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

Um agente apontado para uma API REST 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: o agente 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

Recomendamos adicionar o endpoint hospedado ao seu cliente de agente:

https://api2.transloadit.com/mcp

Em seguida, você aprova o acesso no navegador e escolhe o Workspace que o agente pode usar. Não há nada para instalar nem chaves para copiar.

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

Para CI e outros clientes em que ninguém pode aprovar o acesso no navegador, ou para rodar o servidor por conta própria, veja Escolha como se conectar. A documentação do servidor MCP também traz a configuração de cada cliente.

O que ele não faz

• Ele orquestra a Transloadit. Não consegue fazer nada que a nossa API e os nossos Robots não suportem.
• A codificação é cobrada normalmente. Limite as novas tentativas e a concorrência do agente, conecte apenas o Workspace de que ele precisa, mantenha com escopo restrito qualquer Auth Key que você criar para ele e monitore o uso do Workspace. Nem a autenticação nem o pedido de confirmação de um cliente são um teto de gastos.
• As ferramentas trabalham com Assemblies, Robots e Templates e conseguem identificar o Workspace conectado. 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 conectar seu agente ou leia primeiro a documentação do servidor MCP.