Fracttal One permite conectarse con asistentes de inteligencia artificial como Google Gemini mediante el protocolo MCP (Model Context Protocol) con autenticación OAuth. Esta integración permite que Gemini acceda a los datos de mantenimiento de tu compañía en Fracttal One (activos, órdenes de trabajo, lecturas de medidores y más) directamente desde el chat de Gemini, sin necesidad de exportar archivos ni cambiar de plataforma.
La opción para agregar conectores MCP personalizados depende del plan de Gemini y, en cuentas de Google Workspace, de la configuración que defina el administrador. Si no ves la opción + Personalizado en la pestaña Conectores, verifica tu plan de Gemini o consulta con el administrador de Google Workspace de tu organización.
Paso 1: Crear el consumidor OAuth en Fracttal One
La configuración comienza en Fracttal One, donde crearás un consumidor OAuth para generar las credenciales (Clave y Secreto) que necesitarás en Gemini.
En Fracttal One, ve a Configuración > Conexiones API.
Selecciona la pestaña Consumidores OAuth (①) y haz clic en el botón (+) (②) para crear un nuevo consumidor.
Completa el formulario con los siguientes datos:
Tipo de autorización: selecciona Código de autorización.
Nombre: escribe un nombre descriptivo, por ejemplo
Gemini MCP.URL de redirección: este campo es obligatorio. Por ahora, ingresa la URL del servidor MCP (
https://one.fracttal.com/mcp/oauth/fracttal-one) como valor provisional; la reemplazarás en el Paso 3 por la URI que te proporcionará Gemini.
Grupo de Permisos: selecciona un grupo de permisos (el campo es obligatorio). Cuando la conexión se realiza a través de un cliente MCP, este grupo no se aplica: se utilizan el perfil y los permisos del usuario que autoriza la conexión.
- Haz clic en Guardar.
- Fracttal One genera las credenciales del consumidor. Copia los valores de Clave y Secreto usando el ícono de copiar. Los necesitarás en Gemini.
Paso 2: Configurar el conector MCP en Gemini
Con las credenciales de Fracttal One en mano, ve a Gemini para configurar el conector MCP.
En Gemini, haz clic en Personalizar en el menú lateral y selecciona la pestaña Conectores.
Haz clic en + Personalizado para agregar un conector MCP personalizado. Se abrirá el diálogo "Conectarse a un servidor de MCP".
Ingresa la URL del servidor MCP de Fracttal One en el campo URL del servidor de MCP:
https://one.fracttal.com/mcp/oauth/fracttal-one
Haz clic en Ajustes adicionales > Mostrar más para expandir los campos de autenticación. Aparecerán los campos ID de cliente, Secreto de cliente y el botón Copiar URI de redirección.
- Ingresa las credenciales que obtuviste de Fracttal One en los campos correspondientes:
- ID de cliente: pega la Clave de Fracttal One.
- Secreto de cliente: pega el Secreto de Fracttal One.
- Haz clic en Copiar URI de redirección (①). Guarda esta URI; la necesitarás para completar el consumidor OAuth en Fracttal One.
No cierres esta ventana de Gemini. Volverás a ella después de agregar la URI de redirección en Fracttal One.
Paso 3: Completar la conexión
Ahora regresa a Fracttal One para agregar la URI de redirección y luego vuelve a Gemini para finalizar la conexión.
En Fracttal One, abre el consumidor OAuth que creaste en el Paso 1 y, en el campo URL de redirección, reemplaza el valor provisional por la URI que copiaste de Gemini.
- Regresa a Gemini y haz clic en Siguiente. Gemini mostrará una pantalla de consentimiento. Marca la casilla "Entiendo y acepto los riesgos" y haz clic en Conectar.
- Se abrirá la página de autorización de Fracttal One. Haz clic en Otorgar acceso para aprobar la conexión.
- De vuelta en Gemini, se abrirá el diálogo Guardar tu aplicación personalizada con el nombre del conector ya completado y la lista de acciones disponibles. Si lo deseas, edita el nombre y haz clic en Conectar para guardarlo.
- Verás un banner de confirmación indicando que el conector está activo y listo para usarse.
Paso 4: Consultar datos de Fracttal One desde Gemini
Con la conexión activa, puedes consultar datos de mantenimiento directamente desde el chat de Gemini.
- En el campo de prompt de Gemini, menciona el conector escribiendo
@Fracttalseguido de tu consulta. Por ejemplo: "@Fracttal dime cuáles son las órdenes de trabajo abiertas de esta semana".
La primera vez que Gemini necesite usar una acción del conector, mostrará un mensaje para que autorices esa acción. Haz clic en Permitir siempre para que Gemini la use sin volver a preguntarte. Si prefieres autorizarla solo para esta consulta, haz clic en Permitir una vez.
- Gemini procesará la consulta accediendo a los datos de tu compañía en Fracttal One y te mostrará la respuesta directamente en el chat.
Notas:
Permisos del usuario: los datos que Gemini puede consultar dependen de los permisos del usuario que autorizó la conexión, no del grupo de permisos del consumidor OAuth.
Gestión de credenciales: puedes consultar y gestionar las credenciales del consumidor OAuth (Clave y Secreto) desde Fracttal One en Configuración > Conexiones API > Consumidores OAuth.
Revocación del acceso: puedes revocar el acceso desde Fracttal One eliminando el consumidor OAuth o revisando las autorizaciones activas en la sección de Autorizaciones de apps.
Servicio de terceros: Gemini es un producto de Google y su disponibilidad, funcionalidades e interfaz pueden cambiar sin previo aviso por parte de Fracttal. Fracttal no controla ni garantiza el funcionamiento de servicios de terceros.