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

  1. Leia o guia de autoria uma vez no início de uma tarefa de criação.
  2. Use um projeto durável para trabalho iterativo de imagem ou vídeo.
  3. Envie ou descubra mídia própria antes de referenciá-la.
  4. Faça edições limitadas, preservando a versão otimista atual.
  5. Valide e solicite quadros de revisão visual ou uma folha de contato.
  6. 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:

  1. Solicite um ticket com escopo exatamente para um projeto ou modelo.
  2. Envie os bytes brutos declarados uma vez para o uploadUrl retornado com Content-Type: application/octet-stream.
  3. 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.

](https://jsoncut.com/docs/mcp-tools/)