Conecta tus agentes

Un entorno expone cuatro salidas. Las cuatro sirven el mismo modelo, así que las cifras coinciden.

MCP (para agentes de IA)

El servidor MCP es la salida pensada para agentes, y hace algo que un endpoint de datos no hace: les da el significado antes de que consulten.

qontexta_get_model_context devuelve, en una llamada, todos los vistas semánticas de una rama con la definición de negocio de cada métrica resuelta hasta el cube que la define: qué mide, qué deja fuera, en qué unidad, cómo se lee, cómo lo llama el negocio y qué preguntas responde. Lo que nadie ha descrito viene marcado, para que el agente pueda decir “esto no está definido” en vez de inventárselo.

Configura tu cliente MCP contra:

https://mcp.qontexta.ai

Al conectarlo, inicias sesión en qontexta y autorizas el acceso. Las consultas van con tus permisos: el token que se emite lleva tu identidad y tu rol, así que dos personas del mismo tenant no ven necesariamente lo mismo.

Los tools disponibles:

Tool	Para qué
`qontexta_get_model_context`	El modelo entero con su significado. Lo primero.
`qontexta_list_domains`, `qontexta_describe_domain`	Navegar la capa de negocio
`qontexta_list_cubes`, `qontexta_describe_cube`	De dónde sale un número
`qontexta_list_environments`	Qué entornos hay y qué versión sirven
`qontexta_query_metrics`	Ejecutar la consulta

Las consultas se escriben nombrando miembros (revenue.total_amount), nunca SQL: la agregación, los joins y las exclusiones ya están en la definición, así que no hay forma de equivocarse en ellos.

El MCP no escribe en el modelo. Escribir es un commit a tu Repositorio Semántico, con autor y revisión: no algo que haga una API key por detrás.

SQL semántica (para BI)

Un endpoint que habla el protocolo de Postgres. Conecta Tableau, Power BI, Metabase o cualquier cliente que hable Postgres, y consulta los vistas semánticas como si fueran tablas —sin escribir el SQL de tu Plataforma de Datos—.

Host y puerto están en Entornos → Conectar, y el token es la contraseña.

REST y GraphQL

Para tus aplicaciones. La misma definición, otra forma:

curl https://cube.qontexta.ai/cubejs-api/v1/load \
  -H "Authorization: <TU_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
        "query": {
          "measures": ["revenue.total_amount"],
          "dimensions": ["revenue.region"],
          "timeDimensions": [
            { "dimension": "revenue.order_date", "granularity": "month",
              "dateRange": "last 12 months" }
          ]
        }
      }'

Los tokens

Los tokens de las salidas caducan en horas y llevan dentro el tenant, el entorno y la persona. Para una integración permanente, pide uno nuevo con tu API key contra /api/v1/public/environments/:id/outputs en lugar de guardarlo.

Entornos