JsonCut
Crie vídeos e imagens impressionantes e de alta qualidade diretamente do seu assistente de IA. Dê vida às suas ideias com mais de 2.500 modelos, animações e elementos de design, controle criativo preciso e renderização escalável—tudo totalmente editável no JsonCut Studio.
Documentação
Dê a um Agente externo acesso focado a projetos editáveis, mídia, modelos, revisão visual e renderização.
Endpoint
Use o endpoint remoto Streamable HTTP para cada nova integração:
https://mcp.jsoncut.com/mcp
Envie sua chave de API JsonCut como o cabeçalho X-API-Key. Conceda apenas os escopos necessários para projetos, modelos, mídia, renderizações e descoberta de recursos.
Configuração MCP remota genérica:
{
"mcpServers": {
"jsoncut": {
"type": "http",
"url": "https://mcp.jsoncut.com/mcp",
"headers": {
"X-API-Key": "${JSONCUT_API_KEY}"
}
}
}
}
As chaves de configuração do cliente diferem ligeiramente. Em clientes com um diálogo de conector visual, escolha Remote HTTP ou Streamable HTTP, cole o endpoint e adicione X-API-Key como um cabeçalho secreto.
Verifique a conexão
Peça ao cliente para listar as ferramentas JsonCut e, em seguida, chame jsoncut_v2_get_authoring_guide. Um servidor MCP V2 corretamente conectado expõe apenas jsoncut_v2_* ferramentas. Se você vir ferramentas de trabalho JSON, o cliente está usando o endpoint V1.
Comportamento recomendado do Agente
- Leia o guia de autoria uma vez no início de uma tarefa de criação.
- Use um projeto durável para trabalho iterativo de imagem ou vídeo.
- Envie ou descubra mídia própria antes de referenciá-la.
- Faça edições limitadas, preservando a versão otimista atual.
- Valide e solicite quadros de revisão visual ou uma folha de contato.
- Repare apenas problemas visíveis e renderize a versão final fixada.
Para um vídeo curto e simples, mantenha o projeto plano. Para um vídeo longo, crie cenas editoriais significativas e trabalhe cena por cena. O Agente não precisa reenviar a fonte completa a cada turno.
Enviando arquivos locais
Arquivos pequenos podem usar a ferramenta Base64 limitada. Arquivos locais grandes ou privados usam jsoncut_v2_create_upload_ticket:
- Solicite um ticket com escopo exatamente para um projeto ou modelo.
- Envie os bytes brutos declarados uma vez para o
uploadUrlretornado comContent-Type: application/octet-stream. - Use o registro de mídia normal retornado em edições posteriores.
Os tickets expiram após 60 a 900 segundos, não revelam credenciais de armazenamento de objetos e não podem ser reutilizados após sucesso, expiração ou incompatibilidade de tamanho.
Modelos através do MCP
Um Agente deve pesquisar modelos, chamar jsoncut_v2_get_template_inputs, enviar qualquer mídia necessária e então renderizar valores que satisfaçam o contrato descoberto. Ele não deve inferir campos a partir de uma miniatura ou título.
Compatibilidade MCP V1
Clientes legados existentes podem continuar em:
https://mcp.jsoncut.com/legacy/mcp
Não configure ambos os endpoints em um único Agente. O endpoint legado está congelado para compatibilidade de trabalhos JSON e não recebe novos recursos de autoria.
Veja todas as ferramentas MCP V2 e os loops recomendados.
[
Webhooks assinados
Receba eventos de conclusão, falha e cancelamento de renderização sem polling agressivo.
](https://jsoncut.com/docs/webhooks/)[
Ferramentas e fluxos de trabalho MCP
Escolha o menor fluxo de trabalho MCP para projetos, mídia, modelos, revisão e renderização.