MCP/API
MCP/API es la única interfaz de programación de Qubix. Los clientes externos —un asistente de IA, un script de BI, una herramienta de automatización— se conectan a un único endpoint mediante MCP (Model Context Protocol) y llaman a los métodos que figuran en esta página. Cada llamada se ejecuta estrictamente dentro de sus permisos: un administrador alcanza toda la cuenta, un comprador solo los datos de su equipo.
No hay una API REST separada que aprender: los métodos que ve aquí son exactamente lo que sirve el endpoint, por lo que el catálogo nunca puede desviarse de la interfaz real.
Los mismos métodos impulsan el asistente integrado
Estos métodos no son solo para clientes externos. El asistente de IA integrado de Qubix —el panel disponible en cada pantalla del panel de administración, sin configuración alguna— llama al mismo catálogo. Así, tanto si pregunta al asistente integrado como si conecta su propio agente de IA mediante MCP, ambos leen sus datos y ejecutan acciones a través de los mismos métodos, siempre dentro de sus permisos.
- Integrado — el asistente en cada página. Consulte Chat del Analista de IA.
- Externo — conecte Claude, Cursor u otro cliente MCP. Consulte Conexión de una IA externa.
Dónde encontrarlo
En el panel de administración, abra el menú de la cuenta (arriba a la derecha, junto a su nombre) y elija MCP/API.
El endpoint
Todo se dirige a una sola dirección:
POST https://<your-domain>/api/mcp
El transporte es Streamable HTTP (JSON-RPC 2.0) — un único endpoint que los clientes MCP listos para usar hablan de forma nativa, y al que también puede llamar directamente desde cualquier lenguaje (consulte Ejemplos de código más abajo).
Su token de API
El acceso programático utiliza un token personal (PAT) — creado y gestionado directamente en esta página, en el bloque API Token.
- Pulse Generar API token (o Regenerar si ya tiene uno).
- Copie el token de inmediato — se muestra solo una vez.
El token tiene el aspecto qbx_…. Qubix almacena únicamente su hash y nunca puede volver a
mostrarlo.
- Un token por usuario. Hereda su rol y sus permisos, de modo que a través de la API ve exactamente los mismos datos y acciones que en la interfaz.
- Regenerar emite un nuevo token y el anterior deja de funcionar de inmediato.
- Revocar elimina el token y corta todo el acceso que lo utilizaba.
Un token personal equivale a iniciar sesión como usted. No lo publique ni lo comparta. Si se filtra, pulse Regenerar aquí — el token antiguo muere al instante.
Conectar un cliente
La mayoría de los clientes MCP requieren una pequeña configuración: el endpoint más la cabecera
Authorization. Mientras el token se muestra justo después de la generación, esta página ya
rellena el valor real en el ejemplo de abajo — cópielo tal cual.
{
"mcpServers": {
"qubix": {
"url": "https://<your-domain>/api/mcp",
"headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
}
}
}
Para la configuración paso a paso de un asistente concreto (Claude Code, Claude Desktop, Cursor), consulte Conexión de una IA externa.
Ejemplos de código
Para llamar al endpoint desde su propio código, envíe una solicitud JSON-RPC con las cabeceras de autenticación y de Streamable-HTTP. La página ofrece fragmentos listos para cURL, JavaScript y Python — cambie de pestaña y copie. Por ejemplo, para listar los métodos disponibles:
curl -X POST 'https://<your-domain>/api/mcp' \
-H 'Authorization: Bearer qbx_YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
import requests
res = requests.post(
"https://<your-domain>/api/mcp",
headers={
"Authorization": "Bearer qbx_YOUR_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json, text/event-stream",
},
json={"jsonrpc": "2.0", "id": 1, "method": "tools/list"},
)
print(res.text)
Estas llamadas en bruto ilustran el protocolo desde cualquier lenguaje. Los clientes listos para usar (Claude, Cursor) no las necesitan — utilizan la configuración de arriba.
Qué expone la API
La página enumera el catálogo de métodos completo —alrededor de un centenar de métodos hoy en día— y cada uno está etiquetado como lectura o escritura. Cubren, dentro de sus permisos:
- Analítica — el panel, geo, ofertas, redes, fuentes de tráfico, las pantallas de Facebook y el embudo de visitantes, además de un desglose detallado para un único anuncio, campaña, oferta, creativo, PWA, geo o fuente de tráfico.
- Creativos — búsqueda semántica y los temas de creativos con mejor rendimiento.
- Britva — consulte reglas de automatización, anuncios pausados e historial de disparos; cree, edite y libere reglas.
- Acciones — pause y reanude anuncios y campañas; gestione ofertas, redes, fuentes de tráfico, campañas del tracker, píxeles, sitios web, dominios, PWAs y campañas push.
- Consultas libres — un método de consulta de solo lectura para preguntas que los métodos predefinidos no cubren.
Cada método muestra sus parámetros y si modifica datos. Utilice el cuadro de búsqueda para encontrar uno por nombre o descripción.
Pausar un anuncio, eliminar una regla o una oferta a través de la API modifica sus campañas en vivo. En clientes de chat, dichas acciones se ejecutan solo tras su confirmación — revise lo que se propone antes de aprobar.