Guía de inicio · Piloto por invitación
Tus preguntas. Los datos de Bulbo.
Bulbo MCP conecta tu asistente de IA con las consultas de precios del Explorador de datos. Tú eliges la zona, el periodo y las horas; Bulbo devuelve los datos y su cobertura.
Necesitas una cuenta invitada, correo verificado y un cliente compatible con MCP por HTTP y claves Bearer. El piloto tiene acceso y cotización independientes de la suscripción al Explorador. La suscripción de tu cliente de IA se contrata por separado.
Empieza en tres pasos
1. Activa tu acceso
Solicita una invitación y entra con ese mismo correo. Si aún no está verificado, completa la verificación y vuelve a iniciar sesión.
Abrir mi acceso2. Crea una clave
Ponle el nombre de tu aplicación y elige su vigencia. Cópiala cuando aparezca: solo se muestra una vez. Guarda una clave distinta para cada aplicación.
3. Conecta y pregunta
Copia la URL de tu cuenta y agrega Bulbo a tu cliente de IA. Prueba primero el catálogo y después una consulta mensual.
Ver conexión
Preguntas listas para usar
Cambia MONTERREY por una zona del catálogo. Pide a tu asistente que use las herramientas de Bulbo y conserve la fuente y las advertencias en su respuesta.
- Primera consulta
- Consulta el catálogo de Bulbo y dime qué zonas del SIN puedo consultar y cuál es el corte esperado para MDA y MTR.
- Promedios mensuales
- Dame el precio zonal promedio de MONTERREY, SIN, MDA, por mes de enero a diciembre de 2025, todas las horas. Incluye unidad, cobertura y una tabla para Excel.
- Promedios anuales
- Dame el precio zonal promedio anual de 2020 a 2025 por zona de carga y sistema, mercado MDA. Presenta los años en columnas.
- MTR vs. MDA
- Compara los precios zonales MTR y MDA en MONTERREY, SIN, por mes de 2025. Usa las mismas fechas y horas para ambos mercados y muestra la diferencia.
- Cambio anual
- Compara los promedios mensuales de 2025 contra los mismos meses de 2024 para MONTERREY, SIN, MDA. Muestra el cambio absoluto y porcentual, y señala periodos incompletos.
Conecta tu cliente
En la configuración MCP de tu aplicación, selecciona Streamable HTTP, pega la URL que aparece en Mi acceso y usa el encabezado Authorization: Bearer TU_CLAVE. Introduce la clave en el gestor de secretos de la aplicación, nunca en una conversación.
Este piloto usa claves personales. Los conectores que exigen únicamente OAuth todavía no son compatibles. Si tu aplicación no permite configurar un encabezado de autorización, usa el Explorador de datos.
Ejemplo: VS Code, chat de la extensión
Abre MCP: Open User Configuration desde la paleta de comandos. Agrega esta configuración, conservando los servidores que ya tengas. Sustituye la URL si Mi acceso muestra otra. VS Code te pedirá la clave.
{
"inputs": [
{
"type": "promptString",
"id": "bulbo-token",
"description": "Clave personal de Bulbo MCP",
"password": true
}
],
"servers": {
"bulbo": {
"type": "http",
"url": "https://bulbo.ai/api/bulbo-mcp",
"headers": {
"Authorization": "Bearer ${input:bulbo-token}"
}
}
}
}Este ejemplo usa una entrada secreta interactiva; no se transfiere al Agent Host de VS Code. Consulta la referencia de configuración y la guía de servidores MCP de VS Code para tu modalidad de trabajo.
Cómo leer los resultados
- El precio es el precio zonal y sus componentes disponibles, en MXN/MWh. Los promedios son aritméticos; no están ponderados por demanda.
- Se consultan los registros de CENACE disponibles en la base de Bulbo. Revisa la cobertura de la respuesta: un periodo solicitado puede estar incompleto.
- Para MTR se aplica el corte operativo de siete días. Las comparaciones MTR–MDA usan observaciones coincidentes; un dato faltante no equivale a cero.
- Las consultas pueden reutilizar la caché del Explorador. La respuesta incluye metadatos de fuente y cobertura; revisa también las advertencias antes de comparar.
- Tu asistente puede presentar tablas, pero la interpretación la genera tu modelo de IA. Para copiar, pivotear, descargar o visualizar directamente, abre el Explorador.
Herramientas y límites del piloto
bulbo_catalog— zonas, sistemas y cortes esperados de publicación.bulbo_prices— precios por hora, día, mes, año, periodo completo o perfil horario; promedio, mínimo o máximo. El detalle por hora muestra el precio observado.bulbo_annual_prices— promedio anual por zona y sistema.bulbo_compare_prices— MTR vs. MDA o cambio interanual.
Hasta 5 claves activas, con vigencia de 7, 30 o 90 días. La cuenta comparte un máximo de 30 solicitudes por minuto y 1,000 por día UTC, incluidas las solicitudes de conexión y listado. Cada respuesta admite hasta 5,000 filas y 2 MiB: reduce el periodo o usa promedios mensuales si tu consulta es demasiado grande.
Las consultas de datos tienen un límite adicional compartido con el Explorador: 10 por minuto y una activa a la vez por cuenta. Si se alcanza el límite, la respuesta indica cuántos segundos esperar antes de volver a intentar.
El servicio consulta datos de mercado mediante herramientas delimitadas. No permite SQL libre, cambios en la base de mercado ni acceso a archivos privados de clientes.
Si algo no funciona
- No aparece el botón para crear clave
- Revisa el estado de acceso y verifica tu correo. El piloto requiere invitación y activación del servicio por Bulbo.
- La aplicación dice que no tiene autorización
- Comprueba la URL, el encabezado Bearer y la vigencia de la clave. Si la perdiste, revócala en Mi acceso y crea otra.
- Límite alcanzado o servicio temporalmente no disponible
- Respeta el tiempo de reintento indicado. Evita consultas automáticas en bucle; reduce el rango y prioriza promedios mensuales.
- No hay datos para mi consulta
- Consulta el catálogo, confirma el nombre de la zona, el mercado y las fechas. No rellenes los faltantes con valores inventados.