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.»
- «Genera 3 variantes de anuncio a partir de esta imagen de referencia y mi producto.»
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 |
|---|---|
| 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_generation_cost | 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. |
| create_ad_copy | Genera variantes de anuncio. |
| get_*_status | Consulta un trabajo hasta completar. |
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.
