JsonCut

Crea videos e imágenes impresionantes y de alta calidad directamente desde tu asistente de IA. Dale vida a tus ideas con más de 2,500 plantillas, animaciones y elementos de diseño, control creativo preciso y renderizado escalable, todo totalmente editable en JsonCut Studio.

Documentación

Proporciona a un Agente externo acceso enfocado a proyectos editables, medios, plantillas, revisión visual y renderizado.

Endpoint

Usa el endpoint remoto Streamable HTTP para cada nueva integración:

https://mcp.jsoncut.com/mcp

Envía tu clave de API de JsonCut como el encabezado X-API-Key. Otorga solo los alcances necesarios para proyectos, plantillas, medios, renders y descubrimiento de recursos.

Configuración MCP remota genérica:

{
  "mcpServers": {
    "jsoncut": {
      "type": "http",
      "url": "https://mcp.jsoncut.com/mcp",
      "headers": {
        "X-API-Key": "${JSONCUT_API_KEY}"
      }
    }
  }
}

Las claves de configuración del cliente difieren ligeramente. En clientes con un diálogo de conector visual, elige Remote HTTP o Streamable HTTP, pega el endpoint y luego agrega X-API-Key como un encabezado secreto.

Verificar la conexión

Pide al cliente que liste las herramientas de JsonCut y luego llama a jsoncut_v2_get_authoring_guide. Un servidor MCP V2 correctamente conectado expone solo jsoncut_v2_* herramientas. Si ves herramientas de trabajos JSON, el cliente está usando el endpoint V1.

Comportamiento recomendado del Agente

  1. Lee la guía de autoría una vez al inicio de una tarea de creación.
  2. Usa un proyecto duradero para trabajo iterativo de imágenes o videos.
  3. Sube o descubre medios propios antes de hacer referencia a ellos.
  4. Realiza ediciones acotadas, preservando la versión optimista actual.
  5. Valida y solicita fotogramas de revisión visual o una hoja de contactos.
  6. Repara solo los problemas visibles y luego renderiza la versión final fijada.

Para un video corto simple, mantén el proyecto plano. Para un video largo, crea escenas editoriales significativas y trabaja escena por escena. El Agente no necesita reenviar la fuente completa en cada turno.

Subir archivos locales

Los archivos pequeños pueden usar la herramienta Base64 acotada. Los archivos locales grandes o privados usan jsoncut_v2_create_upload_ticket:

  1. Solicita un ticket con alcance exactamente a un proyecto o plantilla.
  2. Sube los bytes brutos declarados una vez al uploadUrl devuelto con Content-Type: application/octet-stream.
  3. Usa el registro de medio normal devuelto en ediciones posteriores.

Los tickets expiran después de 60 a 900 segundos, no revelan credenciales de almacenamiento de objetos y no pueden reutilizarse después del éxito, la expiración o una discrepancia de tamaño.

Plantillas a través de MCP

Un Agente debe buscar plantillas, llamar a jsoncut_v2_get_template_inputs, subir cualquier medio necesario y luego renderizar valores que satisfagan el contrato descubierto. No debe inferir campos a partir de una miniatura o un título.

Compatibilidad con MCP V1

Los clientes heredados existentes pueden continuar en:

https://mcp.jsoncut.com/legacy/mcp

No configures ambos endpoints en un solo Agente. El endpoint heredado está congelado para compatibilidad con trabajos JSON y no recibe nuevas funciones de autoría.

Consulta cada herramienta MCP V2 y los bucles recomendados.

[

Webhooks firmados

Recibe eventos de finalización, fallo y cancelación de render sin sondeo agresivo.

](https://jsoncut.com/docs/webhooks/)[

Herramientas MCP y flujos de trabajo

Elige el flujo de trabajo MCP más pequeño para proyectos, medios, plantillas, revisión y renderizado.

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