Conecta tus chats de IA

Un chat de IA compatible con servidores MCP remotos (Model Context Protocol) puede explorar datos de FastBI, ejecutar análisis y consultar informes con el acceso que autorices.

Conectar con OAuth

1. En FastBI, abre User settings → Connect your AI with MCP y copia MCP server URL: https://fastbi.app/api/mcp/v1.
2. Añade la URL en los ajustes de integraciones o MCP del cliente. Si te lo pide, selecciona Streamable HTTP y OAuth. Los nombres de los controles dependen del cliente.
3. Inicia la conexión e inicia sesión en FastBI con Google, Microsoft o correo y contraseña.
4. En Connect …, revisa el nombre de la aplicación y Return address. Elige Organization y las funciones necesarias en Allow access to. Selecciona Allow access para aceptar o Cancel para rechazar.
5. Vuelve al chat, habilita FastBI para esa conversación si hace falta y pide la lista de funciones disponibles.

Iniciar sesión confirma tu identidad. La autorización posterior permite acceder a la organización elegida, no a todas tus organizaciones.

Copia la URL del servidor MCP y elige las funciones que podrá usar tu cliente de IA.

Elegir permisos

• Catalog: explorar datos conectados y esquemas.
• Reports: leer informes y ejecutar widgets guardados.
• Ad hoc analysis: hacer preguntas y ejecutar análisis.
• SQL Workbench: planificar consultas, ejecutar SQL y leer resultados.

AdHoc y SQL requieren el rol Analyst. Se mantienen las restricciones de tu pertenencia activa al espacio y tus permisos. Los datos solicitados se envían al cliente de IA; los análisis y consultas consumen tus créditos habituales de FastBI.

Hacer una consulta puntual

Indica la fuente, métrica, fechas, zona horaria y exclusiones. Adapta este ejemplo:

Usa FastBI para mostrar los ingresos netos semanales de las últimas cuatro semanas completas en USD. Usa nuestra fuente de pedidos, excluye los cancelados y aplica la zona horaria de los informes. Incluye un gráfico, el periodo cubierto y las fuentes.

El cliente puede usar un informe adecuado o iniciar un análisis AdHoc. Responde a las preguntas aclaratorias, espera a que termine y revisa filtros y totales. Continúa en la misma conversación para profundizar. Si el cliente no muestra el gráfico, abre el resultado en FastBI.

Recuperar datos periódicamente

Programa la tarea en un cliente o automatización que admita llamadas MCP autenticadas durante ejecuciones programadas. Conectar FastBI no crea una programación. Sin esa función, puedes hacer consultas puntuales.

1. Crea un informe guardado con las métricas y filtros que quieras repetir.
2. Pide al cliente que ejecute el widget correspondiente para obtener resultados actualizados. Define periodo, zona horaria, frecuencia y destino en su programador.
3. Haz una ejecución manual y comprueba el periodo y la actualización de los datos antes de activar la programación.

Cada día laborable a las 09:00 Asia/Bangkok, usa FastBI para ejecutar el widget «Ingresos» del informe «Ventas diarias» para el día completo anterior. Devuelve ingresos, número de pedidos, comparación con el día precedente, periodo y última actualización de los datos.

Adapta los nombres a tu espacio y comprueba la tarea guardada en el cliente. Los Jobs de FastBI sincronizan datos seleccionados con el Lake; la programación del cliente los recupera. Programa la consulta después de que termine correctamente la sincronización. Cada ejecución puede consumir créditos.

Cómo funciona OAuth y cómo revocar el acceso

Tras tu aprobación, el cliente recibe un código temporal en su dirección de retorno. Lo intercambia mediante PKCE por tokens de acceso y renovación. No tienes que introducir tu contraseña de FastBI en el cliente de IA.

Los tokens de acceso duran como máximo una hora. Un cliente compatible los renueva automáticamente durante el periodo de autorización de 30 días. Después debes volver a conectar y autorizar: renovar tokens no prolonga indefinidamente el permiso. Las tareas programadas también necesitan acceso vigente.

Para desconectar, abre User settings → Connect your AI with MCP → Connected AI apps → Revoke. Esto impide nuevos accesos, pero no borra datos que el cliente ya haya recibido.

Tokens manuales

En Manual access tokens, introduce un nombre, selecciona Allowed features y pulsa Create access token. Copia el token cuando aparezca en el campo bearer token del cliente para la misma URL MCP. No lo pegues en chats ni en configuraciones compartidas. Estos tokens caducan a los 30 días y se pueden revocar en User settings.

Si falla la conexión, revisa caducidad, organización, funciones autorizadas y rol. Si los resultados están desactualizados, revisa el periodo del informe y la última sincronización correcta. Para incorporar una fuente MCP externa a FastBI, consulta MCP integrations.