Inicio rápido
Conecta Kubeez MCP y ejecuta tu primera generación en 5 minutos.
#1. Añade el servidor
En tu cliente MCP (Cursor, Claude Desktop, GPT personalizado de ChatGPT, etc.), abre los ajustes de MCP / integraciones y añade:
https://mcp.kubeez.com/mcp
#Cursor — un clic
Abre Cursor directamente mediante el protocolo de instalación MCP — sin pestaña intermedia. Después de confirmar el servidor, completa OAuth en el navegador cuando se te pida.
#Claude Code — CLI
claude mcp add --transport http kubeez https://mcp.kubeez.com/mcp
Pégalo en tu terminal. OAuth se abre en el navegador la primera vez que se usa.
#Codex CLI
codex mcp add kubeez --url https://mcp.kubeez.com/mcp
Pégalo en tu terminal. El servidor se guarda en ~/.codex/config.toml; OAuth se abre en el navegador la primera vez que se usa.
#2. Autoriza
Cuando el cliente te pida iniciar sesión:
- Se te redirige a Kubeez en una pestaña del navegador.
- Inicia sesión (o crea una cuenta).
- Revisa las capacidades solicitadas — por ejemplo Generar medios, Leer saldo.
- Pulsa Aprobar.
El cliente recibe un token y puede invocar herramientas usando tu cuenta y créditos.
#Clientes que solo aceptan API key
Clientes sin OAuth (p. ej. GPTs personalizados de ChatGPT) piden un access token. Genera uno en Ajustes → MCP, cópialo una vez y pégalo en el campo de token del cliente. Misma URL del servidor.
#3. Prueba una generación
Pide a tu asistente algo creativo:
- «Genera una imagen de una puesta de sol sobre montañas, 16:9.»
- «Haz un vídeo de 5 segundos de olas del océano al atardecer.»
- «Crea un beat lofi relajante, 70 BPM, instrumental.»
El asistente elige la herramienta correcta, inicia el trabajo, consulta hasta que esté listo y comparte los enlaces de resultado.
#Herramientas de un vistazo
| Herramienta | Propósito |
|---|---|
| plan | Objetivo en texto libre, plan enrutado de vuelta: modelo, coste, pasos, skills que leer. El arranque natural de sesión. |
| get_models | Catálogo en vivo de modelos, capacidades y precios. Llama siempre primero para elegir un modelo. |
| get_balance | Consulta el saldo de créditos. |
| get_upload_url + get_upload_session | Flujo de dos pasos cuando el usuario tiene un archivo local que subir. |
| estimate | Previsualiza el coste sin descontar créditos. |
| generate_media | Inicia una generación de imagen o vídeo. |
| generate_music | Inicia una canción. |
| generate_dialogue | TTS multivoz. |
| generate_captions | Transcribe un vídeo. |
| generate_separation | Separa el audio en voces + instrumental. |
| remove_background | Recorta el sujeto de una imagen. Transparencia real, sin prompt. |
| regenerate | Vuelve a lanzar una generación de medios anterior con overrides. |
| trim_video | Corta una ventana de una URL de vídeo pública, sin recodificar. |
| list_assets + manage_library | Lee y escribe los assets y personajes guardados. |
| get_status | Consulta cualquier trabajo (medios, música, separación) hasta completar. |
| get_generation / get_generations | Una fila con detalle completo, o el historial reciente. |
La referencia completa por herramienta (parámetros, scopes, forma de respuesta) vive en mcp.kubeez.com/docs.
Siguiente: Conexión para permisos y tokens, o Cómo funciona para el flujo de polling y facturación.