Conectar Fracttal One con Microsoft Copilot Studio te permite consultar tus datos de mantenimiento en lenguaje natural dentro del ecosistema de Microsoft 365, sin salir de Copilot. La conexión se realiza desde un agente creado en Copilot Studio, mediante el protocolo MCP (Model Context Protocol) con autenticación OAuth 2.0, y el agente accede a Fracttal con los mismos permisos del usuario autenticado.
Requisitos
Cuenta activa en Fracttal One con permisos de administrador o acceso a la Configuración.
Acceso a la sección Conexiones API dentro de Fracttal One.
Licencia de Microsoft Copilot Studio con permisos de creador (maker) en el entorno de Power Platform.
Un grupo de permisos definido en Fracttal One con el alcance de datos que quieres exponer al agente.
Datos de conexión de Fracttal One
Estos valores son fijos y los vas a usar durante la configuración en Copilot Studio.
| Campo | Valor |
|---|---|
| URL del servidor MCP | https://one.fracttal.com/mcp/oauth/fracttal-one |
| URL de autorización | https://one.fracttal.com/oauth/authorize |
| URL de token | https://one.fracttal.com/oauth/token |
| URL de actualización (refresh) | https://one.fracttal.com/oauth/token |
| Ámbitos | Dejar vacío. Fracttal One controla el alcance mediante el grupo de permisos. |
Nota: las URL de autorización y de token están en la raíz del dominio. No incluyen /api/ ni /mcp/ en la ruta.
Paso a paso
Crea el servidor MCP en Copilot Studio
En tu agente, ve a Herramientas › Agregar una herramienta › Nueva herramienta › Model Context Protocol.
Completa los campos:
| Campo | Valor |
|---|---|
| Nombre | Fracttal One (o el nombre que prefieras) |
| Descripción del servidor | Una descripción clara de lo que hace el servidor. El agente usa este texto para decidir cuándo consultar Fracttal One. |
| URL del servidor | https://one.fracttal.com/mcp/oauth/fracttal-one |
| Autenticación | OAuth 2.0 |
| Tipo | Manual |
Importante: el campo Tipo ofrece tres opciones y solo Manual funciona con Fracttal One. La opción Detección dinámica intenta localizar la configuración automáticamente y la opción Dinámico intenta registrar el cliente por su cuenta, algo que Fracttal One rechaza por seguridad.
Crea el consumidor OAuth en Fracttal One
En otra pestaña, inicia sesión en Fracttal One. En la esquina superior derecha, haz clic en el menú de usuario y selecciona Configuración. En el menú lateral, selecciona Conexiones API y luego haz clic en la pestaña Consumidores OAuth.
Haz clic en el botón (+) para agregar un nuevo consumidor y completa el formulario:
| Campo | Valor |
|---|---|
| Tipo de autorización | Código de autorización |
| Nombre | El nombre de la conexión que prefieras (ej: COPILOT MCP) |
| URL de remarcación | https://global.consent.azure-apim.net/redirect (valor provisional, lo vas a reemplazar en el Paso 5) |
| Grupo de Permisos | Selecciona el grupo de permisos deseado. Sin embargo, el sistema usará los permisos del usuario autenticado. |
Una vez completado el formulario, haz clic en el ícono de Guardar, en la esquina superior derecha.
Copia la clave y el secreto generados
Al guardar, Fracttal One genera automáticamente una Clave y un Secreto para el consumidor.
Importante: el Secreto se muestra una sola vez y da acceso de lectura y escritura a los datos del grupo de permisos seleccionado. Guarda ambos valores en un gestor de contraseñas y no los compartas en capturas de pantalla ni en mensajes. Si el secreto queda expuesto, crea un consumidor nuevo y reemplaza las credenciales.
Completa la autenticación manual en Copilot Studio
Vuelve a la ventana de Copilot Studio, con Tipo en Manual, y completa los campos:
| Campo | Valor |
|---|---|
| Id. de cliente | Pega la Clave generada en el Paso 3 |
| Secreto de cliente | Pega el Secreto generado en el Paso 3 |
| Dirección URL de autorización | https://one.fracttal.com/oauth/authorize |
| Plantilla de URL de token | https://one.fracttal.com/oauth/token |
| Actualizar URL | https://one.fracttal.com/oauth/token |
| Ámbitos | Dejar vacío |
Haz clic en Crear. Copilot Studio genera una URL de redireccionamiento única, que combina la URL base de Azure con un sufijo identificador del conector.
Sincroniza la URL de redireccionamiento en Fracttal One
Copia la URL de redireccionamiento completa que generó Copilot Studio. Vuelve a Fracttal One, abre el consumidor OAuth creado en el Paso 2, reemplaza el valor del campo URL de remarcación por la URL completa con el sufijo y haz clic en Guardar.
Importante: Fracttal One compara la URL de redireccionamiento carácter por carácter. Si el consumidor mantiene la URL base, la autorización se interrumpe con un error de URL de redireccionamiento no coincidente. Si el error persiste, prueba agregando o quitando la barra final (/).
Conecta y autoriza
En la pantalla Agregar herramienta de Copilot Studio, despliega el selector Conexión y elige crear la conexión. Se abre una ventana de autorización de Fracttal One, donde debes iniciar sesión y confirmar los permisos de acceso.
Después de autorizar, aparece un indicador verde junto al nombre de la conexión y el botón Agregar y configurar queda disponible.
Valida la conexión con una consulta real
En la configuración del agente, confirma que la orquestación generativa está activada. Sin ella, el agente reconoce las herramientas de Fracttal One pero no las ejecuta.
Haz una pregunta simple y verificable y compara el resultado con lo que ves en Fracttal One.
¡Listo! Ya tienes Fracttal One conectado a tu agente de Microsoft Copilot.
Notas:
El uso de esta integración puede implicar consumo, límites o cobros asociados a los servicios de Microsoft. Estos costos y condiciones son determinados exclusivamente por Microsoft.
El agente puede solicitar confirmación antes de ejecutar acciones de escritura (crear, modificar o eliminar registros). Revisa siempre las acciones propuestas antes de confirmarlas.
El usuario es responsable de validar y supervisar las acciones, automatizaciones y resultados generados a través de plataformas de terceros conectadas a Fracttal, incluidos los que se deriven de instrucciones, configuraciones, prompts o flujos definidos en esas plataformas.