Treza

Dê ao seu assistente um pipeline de vídeo. Conecte o servidor do Model Context Protocol hospedado da Treza e ele pode construir um pipeline a partir de uma descrição, executá-lo, acompanhar a renderização e publicar o resultado em um canal que você conectou. Um URL, um único login.

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

O que seu assistente pode fazer depois de conectado

Cada ferramenta corresponde a uma etapa que um produtor realiza, com escopo limitado à conta que fez login. Os pipelines são o que você construiu no canvas, ou o que o assistente constrói para você.

• Construir um pipeline a partir de uma descrição

  Descreva o vídeo que você deseja. O assistente começa a partir de um template ou do vocabulário de nós, cria o pipeline como rascunho na sua conta e corrige problemas de validação antes de qualquer execução.

• Executá-lo e acompanhar a renderização

  run_pipeline inicia a renderização nos workers da Treza e retorna um ID de execução imediatamente. O assistente faz polling de get_run e retorna resultados por nó e URLs de saída quando o status muda.

• Finalizar o que você já criou

  list_assets encontra os clipes, imagens estáticas e faixas na sua conta. assemble_video junta tudo em um único vídeo com narração, uma trilha sonora da sua biblioteca ou composta a partir de uma descrição, e legendas, e edit_asset adiciona legendas, aumenta a resolução ou corta um único arquivo, sem precisar desenhar um grafo.

• Publicar em um canal conectado

  connect_channel entrega um link para você conectar um canal do YouTube ou uma conta do TikTok no seu navegador. Depois disso, publish_asset prepara um vídeo finalizado para você revisar e o publica quando você pressionar Publicar, e um pipeline pode terminar com o upload em seu próprio cronograma.

• Verificar créditos antes de gastá-los

  estimate_run_cost precifica uma execução em relação ao saldo atual, e get_credit_balance retorna o saldo, o uso do plano e um link de recarga para entregar a uma pessoa quando o saldo estiver baixo.

• Manter um cronograma honesto

  Pipelines cujo snapshot publicado carrega um gatilho de agendamento são executados por conta própria. O assistente relata o estado de cada agendamento e o próximo horário de execução, e pausa ou retoma sem tocar no grafo publicado.

Adicione ao seu cliente

O servidor fala MCP Streamable HTTP padrão, então todo cliente usa o mesmo URL. No primeiro uso, o cliente envia você para a Treza para fazer login e aprovar os escopos solicitados. Nenhuma chave toca o chat ou um arquivo de configuração.

claude.ai (conector personalizado)

Abra Configurações, depois Conectores, depois Adicionar conector personalizado, e insira https://www.trezalabs.com/api/mcp como URL. O Claude guia você pelo login na Treza e aprovação do acesso. Aprove uma vez e o conector permanece vinculado à sua conta.

claude mcp add --transport http treza https://www.trezalabs.com/api/mcp

{

  "mcpServers": {

    "treza": {

      "url": "https://www.trezalabs.com/api/mcp"

    }

  }

}

{

  "schema_version": 1,

  "mcp_servers": {

    "treza": {

      "transport": "streamable_http",

      "url": "https://www.trezalabs.com/api/mcp",

      "mode": "optional"

    }

  }

}

# Any MCP client that speaks Streamable HTTP.

# OAuth sign-in on first use, or a scoped API key as a bearer:

Authorization: Bearer treza_live_...

No Cursor, abra Configurações, Ferramentas e MCP, Novo Servidor MCP, cole o JSON e habilite-o. O Muse Code lê seu próprio arquivo de configurações, onde schema_version é obrigatório e a chave é mcp_servers em snake case; adicione uma entrada headers junto ao URL se preferir enviar uma chave em vez de fazer login. mode tem como padrão required, que aborta toda a sessão se um servidor estiver inacessível, então o trecho define optional em vez disso. Qualquer outro cliente que fale MCP Streamable HTTP conecta com o mesmo URL: ele completa o login OAuth se suportar um, ou envia uma chave de API com escopo com permissões pipelines:read e pipelines:run no cabeçalho Authorization. O passo a passo do Cursor cobre a configuração do editor passo a passo.

As ferramentas, agrupadas por função

Vinte e uma ferramentas, cada uma um passo de produção em vez de um parâmetro de modelo. Isso mantém a seleção de ferramentas confiável quando o assistente está lidando com sua solicitação junto com todo o resto no contexto.

Autoria

Requer o escopo pipelines:write.

• list_pipeline_templates Pipelines prontos que create_pipeline pode copiar, cada um com os nós de entrada aos quais as entradas de uma execução são vinculadas.
• list_node_types Os tipos de nós disponíveis para construir grafos, agrupados por categoria.
• get_node_type Portas e esquema de configuração para um tipo de nó, com o catálogo de modelos ao vivo em nós que carregam modelos.
• create_pipeline Crie um pipeline de rascunho a partir de um ID de template ou um grafo de nós inicial. Problemas de nível de erro bloqueiam o salvamento.
• update_pipeline Renomeie um pipeline, altere sua descrição ou substitua seu grafo. Problemas de nível de erro bloqueiam a escrita.
• publish_pipeline Faça um snapshot do rascunho como uma versão implantada imutável que agendamentos e APIs públicas executam.

Execução

run_pipeline requer o escopo pipelines:run.

• list_pipelines Todos os pipelines na conta, com status, estado do agendamento e um resumo das execuções recentes.
• get_pipeline Metadados e resumo de nós de um pipeline, ou o grafo completo com includeGraph.
• run_pipeline Inicie uma execução em segundo plano e receba um ID de execução imediatamente. As entradas são vinculadas pelo ID do nó de entrada.
• get_run Status geral mais resultados por nó e URLs de saída. Faça polling até o status sair de "executando".
• list_runs Execuções recentes de um pipeline, das mais novas para as mais antigas.
• set_schedule_paused Pause ou retome o agendamento de um pipeline publicado. Retomar pula os slots perdidos enquanto pausado.

Finalização de mídia

assemble_video e edit_asset precisam de pipelines:run e pipelines:write, e gastam créditos da conta. import_media e create_upload_url precisam de pipelines:write e não gastam nada.

• list_assets Imagens, vídeos e áudios da conta, dos mais novos para os mais antigos, como URLs que as duas próximas ferramentas aceitam.
• assemble_video Junte clipes em um vídeo finalizado com narração e uma trilha sonora, composta a partir de uma descrição se você quiser, com legendas se desejar. Um clipe e uma descrição adicionam música a um vídeo.
• edit_asset Execute qualquer nó de transformação em um único arquivo: legendas, aumento de resolução, remoção de fundo, corte.
• import_media Adicione um arquivo anexado no ChatGPT, um link público ou um arquivo local enviado à biblioteca, para que um logotipo possa ir ao canto de um vídeo.
• create_upload_url Um link de uso único que Claude Code, Codex ou Cursor faz PUT de um arquivo local, para import_media adicionar à biblioteca.

Orçamento

Somente leitura, então qualquer conexão pode chamar estas.

• estimate_run_cost Quanto uma execução do grafo de rascunho custará, passo a passo, e se o saldo cobre.
• get_credit_balance Saldo pré-pago, uso do plano e pacotes de crédito compráveis, com um link de recarga para uma pessoa logada.

Publicação e acesso

create_api_key precisa do escopo keys:provision, que apenas um consentimento OAuth ou uma sessão de primeira parte carrega.

• list_connected_channels Os canais do YouTube, contas do TikTok e contas do Instagram na conta, com os IDs que um nó de publicação precisa.
• connect_channel Um link para conectar um canal do YouTube ou conta do TikTok, finalizado por você no seu próprio navegador após fazer login na Treza.
• publish_asset Prepare um vídeo finalizado para revisão antes de publicar no YouTube ou TikTok: a conta, o título e, no TikTok, quem pode vê-lo e suas divulgações.
• confirm_publish Publica o que publish_asset preparou quando você pressiona Publicar no painel. Apenas o painel chama isso.
• create_api_key Gere uma chave treza_live_ durável com escopo para uso headless das APIs de pipeline e do MCP. A chave bruta é mostrada uma única vez.

Uma descrição se torna um pipeline

Como uma solicitação se desenrola pelo conector. O assistente escolhe as ferramentas; o pipeline faz a produção.

1. Você Transforme o episódio mais recente do meu feed de podcast em um Short vertical legendado toda semana e publique no meu canal do YouTube.
2. Assistente Chama list_pipeline_templates e encontra o Podcast Clip Factory, um template que puxa o episódio mais recente de um feed RSS, escolhe o momento mais compartilhável de 30 a 60 segundos, corta e constrói um Short com arte de capa legendada. Chama list_connected_channels para obter o ID do canal para o nó de upload, depois create_pipeline com templateId podcast-clip-factory e o URL do feed, e update_pipeline para apontar o nó de upload para seu canal e definir o gatilho de agendamento semanal.
3. Assistente Chama estimate_run_cost, relata o custo estimado contra o saldo e pergunta se deve prosseguir.
4. Você Pode ir, e execute um agora para eu verificar.
5. Assistente Chama run_pipeline e recebe um ID de execução imediatamente, depois faz polling de get_run enquanto a renderização acontece nos workers da Treza. Relata os resultados por nó e o URL do Short finalizado. Quando você estiver satisfeito, publish_pipeline arma o agendamento semanal.

Perguntas frequentes

Preciso de uma chave de API para conectar?

Não. Adicionar o URL inicia um fluxo OAuth: o cliente envia você para a Treza, você faz login, e uma página de consentimento lista os escopos exatos sendo solicitados para você aprovar. Nenhuma chave toca o chat, um arquivo de configuração ou um repositório commitado. Clientes headless podem usar uma chave de API treza_live_ com escopo como cabeçalho bearer em vez disso.

Quais escopos o conector solicita?

pipelines:read para visualizar pipelines e execuções, pipelines:run para iniciar execuções, pipelines:write para criar, editar e publicar pipelines, e keys:provision para gerar chaves de API com escopo. A página de consentimento mostra cada um, e o servidor concede exatamente o que você aprova. Uma conexão pode ser permitida a acionar trabalho sem ser permitida a alterá-lo.

Quanto custa uma execução iniciada pelo chat?

O mesmo que uma execução iniciada pelo painel ou pela API. Execuções gastam o saldo de crédito pré-pago da conta, aparecem no mesmo histórico de execuções e são reservadas contra o saldo quando começam, para que um agente em loop em run_pipeline não possa gastar demais. estimate_run_cost informa o custo antes de você se comprometer.

O assistente pode ver pipelines de outras pessoas?

Não. Cada chamada de ferramenta resolve o chamador para os identificadores de proprietário que ele provou e verifica o pipeline contra eles. O conector vê e executa apenas pipelines na conta que fez login.

Uma renderização longa bloqueia o chat?

Não. run_pipeline enfileira a execução nos workers da Treza e retorna o ID de execução imediatamente. O assistente faz polling de get_run, que lista as etapas concluídas até agora enquanto a execução ainda está rodando, e retorna os URLs de saída quando termina.

Ele pode conectar meu canal do YouTube por mim?

Ele entrega o link. connect_channel retorna um link que você abre no seu navegador, onde você faz login na Treza e permite que o YouTube ou TikTok deixe a Treza publicar. Depois disso, list_connected_channels retorna o ID do canal que um nó de publicação precisa, e publish_asset pode publicar um vídeo finalizado depois que você confirmar.

Chamando um pipeline publicado do seu próprio código em vez de um assistente? A API REST expõe o endpoint tipado /invoke e um endpoint /chat/completions compatível com OpenAI.

Conecte seu assistente a um pipeline de vídeo

Faça login, cole o URL no seu cliente e peça um vídeo. Créditos pré-pagos, sem assinatura.

Entrar na Treza->