Conexión rápida

    Añade Kubeez a Cursor en un clic

    OAuth se abre en tu navegador — sin editar JSON, sin pegar tokens.

    Descripción general de MCP

    El servidor MCP de Kubeez permite que asistentes de IA como Claude, Cursor y ChatGPT usen las herramientas de Kubeez de forma nativa — sin instalar SDK ni escribir código de integración. Una sola conexión, todas las herramientas creativas.

    #Qué puedes hacer

    • Imágenes y vídeo — más de 40 modelos para texto a imagen, imagen a imagen, texto a vídeo, imagen a vídeo, control de movimiento y lip-sync.
    • Música — canciones completas con voces o instrumentales, con letras personalizadas, estilo y BPM opcionales.
    • Diálogo — text-to-speech multivoz con más de 80 voces.
    • Subtítulos — transcripciones con marcas de tiempo a nivel de palabra desde cualquier vídeo.
    • Separación de audio — divide una pista en pistas de voz + instrumental.
    • Anuncios — varias variantes a partir de un anuncio de referencia y tu producto.

    #Conectar

    Usa esta URL al añadir el servidor en tu cliente MCP:

    https://mcp.kubeez.com/mcp
    

    #Cursor — un clic

    Añadir a Cursor

    Este enlace usa el flujo oficial de instalación de Cursor — sin editar JSON.

    #Iniciar sesión

    MétodoCuándo usarlo
    OAuth (recomendado)Cursor, Claude Desktop y la mayoría de clientes abren el navegador, inicias sesión en Kubeez y el cliente guarda el token. Nada que pegar.
    Token de acceso personalClientes que solo aceptan API key (p. ej. GPTs personalizados de ChatGPT). Genera uno en Ajustes → MCP, pégalo como Bearer / API key. Mismos permisos que OAuth, revocable cuando quieras.

    Si tu cliente admite cabeceras personalizadas, usa Authorization: Bearer <token> con un token de acceso personal.

    #Cómo funciona

    1. Añade la URL del servidor en tu cliente MCP.
    2. Inicia sesión en Kubeez (OAuth) y aprueba las capacidades que el cliente solicita.
    3. El cliente obtiene un token y puede invocar herramientas — las generaciones usan tus créditos de Kubeez.

    Todas las herramientas de generación son asíncronas: inicias un trabajo y consultas hasta terminar. El cliente gestiona la consulta automáticamente; la página Cómo funciona explica el flujo si construyes uno propio.

    #Requisitos

    • Una cuenta de Kubeez con créditos.
    • Cualquier cliente compatible con MCP (Claude Desktop, Cursor, Claude.ai, GPTs personalizados de ChatGPT, tu propia integración).

    Para acceso HTTP / API key directo (servidores, scripts, backends móviles), usa la API REST.


    Siguiente: Inicio rápido — conecta y ejecuta tu primera generación en 5 minutos.

    Secuencias reales de herramientas

    Cómo encadenan estas herramientas los asistentes de IA

    Separación de música — divide una canción en voz + instrumental

    Separación de audio con facturación exacta por duración.

    1. 1
      get_upload_url(model_id="mvsep-40")

      Devuelve un enlace temporal de navegador. Pásalo al usuario tal cual.

    2. 2
      get_upload_session(token)

      Devuelve media_urls + total_audio_seconds + billing_readiness:"exact".

    3. 3
      estimate_generation_cost(model="mvsep-40", reference_audio_seconds=…)

      Cita el precio. No se descuentan créditos.

    4. 4
      generate_separation(media_url=…) → get_separation_status

      Primer sondeo ~20s, luego cada 5s. Devuelve URLs de voz + instrumental.

    Motion control — anima un personaje a partir de un vídeo

    Dos subidas, en orden, facturadas por la duración del vídeo de referencia.

    1. 1
      get_upload_url(model_id="kling-3-0-motion-control-720p")

      El enlace exige 1 imagen + 1 vídeo.

    2. 2
      get_upload_session(token)

      media_urls ordenados + total_video_seconds.

    3. 3
      estimate_generation_cost(model="…motion-control-720p", reference_video_seconds=…)

      Confirma antes de cobrar.

    4. 4
      generate_media(source_media_urls=[image_url, video_url])

      El orden importa: imagen primero, vídeo segundo.

    AutoCaptions — transcribe un vídeo en subtítulos a nivel de palabra

    Síncrono — los subtítulos vuelven dentro de la respuesta.

    1. 1
      get_upload_url(model_id="auto-caption")

      Mismo patrón: pasa el enlace al usuario.

    2. 2
      get_upload_session(token) → total_video_seconds

      Lee la duración directamente de la sesión.

    3. 3
      estimate_generation_cost(model="auto-caption", reference_video_seconds=…)

      Cita el coste por segundo de antemano.

    4. 4
      generate_captions(media_url=…)

      Llamada síncrona — devuelve JSON a nivel de palabra en la respuesta (sin sondeo).

    Consejos

    Hazlo bien a la primera

    Previsualiza siempre el coste antes de generar

    Los modelos por duración (Music Separation, AutoCaptions, motion control, P-Video, Seedance 2 con vídeo de referencia) facturan por segundos de referencia. Llama a estimate_generation_cost primero, cita el número y espera el visto bueno.

    Sondea con cadencia baja

    El primer sondeo usa estimated_time_seconds de get_models, luego cada 5s. Sondear cada segundo desperdicia el rate-limit para el mismo tiempo de finalización.

    Subidas por navegador → facturación exacta

    Los archivos subidos vía get_upload_url tienen su duración medida en el cliente. billing_readiness:"exact". Las URLs externas usan un valor pesimista de 15s por defecto.

    Los scopes son a nivel de herramienta

    get_models no requiere scope. generate_* requiere generate:media / generate:music / generate:speech / generate:ads. read:balance y read:generations cubren consultas.