Inicio rápido
1. Vincula tu Repositorio Semántico
En Repositorio, vincula un repositorio de GitHub. Puede estar vacío: qontexta
le escribe la estructura de un proyecto Cube (model/cubes, model/views,
cube.js, un README) sin tocar nada de lo que ya hubiera.
Dos formas de dar acceso:
- GitHub App (recomendada) — instalas la app en tu cuenta y pegas el id de instalación. Los tokens se emiten al vuelo y caducan en una hora: aquí no se guarda ningún secreto de larga vida.
- Token de acceso personal — necesita permiso de escritura sobre el contenido
(
contents:write). Se guarda cifrado y no se vuelve a mostrar.
2. Conecta tu Plataforma de Datos
En Conexiones, añade tu base de datos. Con permisos de solo lectura es suficiente: qontexta lee esquemas y ejecuta consultas, nunca escribe.
→ Conectar tu Plataforma de Datos
3. Dile qué quieres medir
En Asistente, elige la conexión, acota un esquema y escríbelo en tus palabras: “quiero medir los ingresos por región y el ticket medio”.
El asistente lee tus tablas y te propone cubes, métricas y vistas semánticas, con el por qué de cada uno y las preguntas que no ha podido decidir por su cuenta. Revisas, pides cambios si hace falta, y lo que aceptas se escribe en un solo commit.
No hay que traer ninguna clave de IA: el asistente va incluido y funciona con la cuenta de qontexta. Tu plan lleva un consumo mensual asociado.
4. Firma el significado
En Modelo, abre una métrica. Verás dos pestañas: Negocio y Técnica. Completa qué mide, qué deja fuera y quién responde de ella, y valídala. Sin título, descripción y dueño no se puede validar —validar algo sin explicar sería decir que un número que nadie ha descrito es de fiar—.
5. Conéctale un agente
En Entornos, pulsa Conectar en producción. Ahí están el endpoint MCP, el de SQL semántica, REST y GraphQL, con un token acotado a ti.