Conectarse
Kubeez MCP usa OAuth 2.1 estándar para que tu cliente actúe en tu nombre con tu consentimiento.
#Autorización en 4 pasos
- Tu cliente contacta con el servidor de Kubeez y abre una pestaña del navegador.
- Inicias sesión en Kubeez y ves las capacidades que el cliente solicita.
- Apruebas o deniegas. Si apruebas, el cliente recibe un token.
- El cliente envía ese token con cada petición — las generaciones usan tus créditos.
Puedes revocar cualquier cliente cuando quieras desde Ajustes → MCP.
#Capacidades (scopes)
| Scope | Qué permite hacer al cliente |
|---|---|
generate:media | Iniciar trabajos de imagen, vídeo, subtítulos y separación de audio + usar las herramientas de subida |
generate:music | Iniciar generaciones de música |
generate:speech | Iniciar text-to-dialogue / TTS |
generate:ads | Iniciar generaciones de anuncios |
read:balance | Consultar tu saldo de créditos |
read:generations | Listar e inspeccionar tu historial de generaciones |
El cliente solo puede usar lo que apruebas. Falta de scope → la llamada se rechaza con un error claro.
#Tokens
- El cliente recibe un access token corto y lo usa en cada petición.
- Los tokens se refrescan automáticamente para que no tengas que reautorizar en cada sesión.
- Si un token falta o no es válido, el cliente debe pedirte que reautorices.
No se comparte ninguna contraseña ni secreto duradero con el cliente. Los tokens de acceso personal (alternativa al API key) también son revocables desde Ajustes → MCP.
#Cursor — un clic
Abre Cursor directamente. Completa OAuth en el navegador cuando se te pida (mismo flujo que arriba).
#Claude Code — CLI
claude mcp add --transport http kubeez https://mcp.kubeez.com/mcp
Ejecútalo en tu terminal. Claude Code registra el servidor y abre OAuth en el navegador la primera vez que se usa.
#Codex CLI
codex mcp add kubeez --url https://mcp.kubeez.com/mcp
Ejecútalo en tu terminal. Codex CLI guarda el servidor en ~/.codex/config.toml y abre OAuth en el navegador la primera vez que se usa.
Siguiente: Herramientas de medios, música o anuncios.