Un conector permite que ONE acceda a una herramienta que vive fuera de Factorial IT. Agrega uno cuando quieras que el asistente busque cosas en, o realice acciones en, otro sistema que tu equipo ya utiliza.

Funcionalidad

Descripción general

Cada conector es un servidor del Protocolo de Contexto de Modelo (MCP) que registras mediante su URL. Cuando está conectado, ONE puede llamar a las herramientas que ofrece ese servidor mientras chateas con él. Por ejemplo, puede encontrar una página en Notion o llevar a cabo una tarea en otro servicio.

Razones típicas para agregar uno:

• Buscar datos en otro lugar. Trae información que posee una herramienta en la que tu equipo confía.
• Actuar en otro lugar. Permite que el asistente complete tareas dentro de un servicio conectado.
• Extender lo que el asistente puede hacer. Conecta cualquier herramienta que soporte el Protocolo de Contexto de Modelo.

No necesitas un conector si el asistente solo tiene que trabajar con datos de Factorial IT o las directrices de tu empresa. Para eso, utiliza elementos de la base de conocimientos.

Antes de comenzar

• Para agregar, editar, re-autenticar o eliminar conectores, o para cambiar sus permisos de herramienta, necesitas el permiso de Gestionar agentes de IA. Para verlos, Ver agentes de IA es suficiente.
• Necesitas la URL de un servidor MCP que soporte autenticación OAuth.

Cómo usar

1. Ve a Agentes de IA > Configuración y selecciona la pestaña Conectores.
2. Haz clic en Agregar conector. Se abre una ventana.
3. Completa los detalles:
   • Nombre: cómo se etiqueta el conector, por ejemplo Notion.
   • URL del servidor: el punto final MCP, por ejemplo https://example.com/mcp.
4. Abre Configuraciones avanzadas solo si tu servidor MCP no soporta el Registro Dinámico de Clientes. En ese caso, registra Factorial IT en la consola OAuth del proveedor e ingresa el ID de cliente y el secreto de cliente. Los clientes públicos que dependen de PKCE pueden dejar el secreto en blanco.
5. Haz clic en Conectar. Serás enviado al servidor MCP para iniciar sesión. Una vez que otorgues acceso, regresarás a Factorial IT y el conector mostrará Conectado.

Estados del conector

Ver un conector

La pestaña Conectores muestra primero los conectores integrados (Factorial IT y el conector del centro de ayuda), seguido de cualquier conector que hayas agregado. Los conectores integrados siempre están Conectados. Haz clic en cualquier conector para abrir su página.

En la página de un conector que agregaste encontrarás:

• Configuraciones: el Nombre, la URL del servidor y, si ingresaste uno, el ID de cliente. El secreto de cliente nunca se muestra. Usa Editar conexión para cambiar estos valores. Cambiar la URL del servidor o las credenciales de OAuth significa que debes autenticarte nuevamente.
• Permisos de chat y Permisos de agente: cada herramienta que ofrece el servidor MCP, cada una con su política. Consulta "Establecer permisos de herramienta" a continuación.

La lista de herramientas se obtiene del servidor MCP cada vez que abres la página, por lo que siempre coincide con lo que el servidor ofrece actualmente. Las herramientas solo se muestran mientras el conector está Conectado. Si el servidor no responde, verás una advertencia en lugar de las herramientas, y Configuraciones seguirá siendo utilizable.

Los conectores integrados no tienen Configuraciones ni menú de Acciones. No puedes editarlos ni eliminarlos, pero puedes cambiar sus permisos de herramienta.

Gestionar un conector

En la página de un conector que agregaste, usa el menú de Acciones en la esquina superior derecha:

• Re-autenticar: inicia sesión en el servidor MCP nuevamente. Esta opción solo se muestra cuando el conector no está Conectado.
• Eliminar: elimina el conector junto con sus credenciales guardadas, una vez que confirmes. Si un agente está utilizando el conector, no puedes eliminarlo hasta que lo apagues en ese agente.

Establecer permisos de herramienta

La página del conector controla cómo ONE puede usar cada herramienta. Cuando el conector está Conectado, sus herramientas se enumeran en dos secciones:

• Permisos de chat cubren tus propias conversaciones con ONE.
• Permisos de agente cubren ONE cuando trabaja sin supervisión, por ejemplo, en un ticket donde lo has agregado como agente. Cuando activas el conector para un agente personalizado, ese agente toma una copia de estas configuraciones y la mantiene. Los cambios realizados aquí después no alcanzan a ese agente.

Ambas secciones agrupan herramientas en Herramientas de solo lectura y Herramientas de lectura y escritura. Una herramienta se considera de solo lectura solo si el servidor MCP la marca con la anotación readOnlyHint. Cualquier otra cosa se trata como de lectura y escritura.

Para establecer una política para todo un grupo, utiliza el menú a la derecha de ese grupo. La elección también se aplica a herramientas que el servidor agregue en el futuro, y anula cualquier configuración de herramienta por herramienta en el grupo. Para establecer una herramienta, expande el grupo y elige una política con los íconos al lado del nombre de la herramienta. Cuando las herramientas en un grupo tienen políticas mixtas, el grupo muestra Personalizado.

Políticas predeterminadas, hasta que las cambies:

Esto significa que los agentes pueden usar herramientas de lectura y escritura de inmediato. Para mantener a los agentes limitados a la lectura en un conector, establece Herramientas de lectura y escritura en Siempre rechazar bajo Permisos de agente. Cualquier agente personalizado que ya esté utilizando el conector tiene su propia copia, así que actualízalo también en ese agente.

Cómo ONE usa conectores

Durante una conversación, ONE tiene acceso a las herramientas de cada conector conectado y elige la correcta para cada solicitud. Para dirigirlo hacia un conector particular, escribe @ en el cuadro de mensaje y selecciona el conector. ONE verifica los Permisos de chat del conector antes de ejecutar cualquier herramienta. Por defecto, te pregunta antes de usar una herramienta que escriba o cambie datos.

Solución de problemas y FAQ

Solución de problemas

• El conector muestra Error. La conexión falló. Abre su página y usa Acciones > Re-autenticar.
• El conector permanece en Autenticación pendiente. La autenticación no se completó. Re-autentica y completa el inicio de sesión en el servidor MCP.
• No aparecen herramientas en la página del conector. Las herramientas solo se muestran mientras el conector está Conectado, y el servidor debe responder. Si ves una advertencia, el servidor no respondió.
• No puedes eliminar un conector. Un agente todavía lo está utilizando. Apágalo primero en ese agente.
• La conexión falla en un servidor sin Registro Dinámico de Clientes. Registra Factorial IT en la consola OAuth del proveedor e ingresa el ID de cliente y el secreto de cliente bajo Configuraciones avanzadas.
• Un cambio de permiso no alcanzó a un agente. El agente mantiene su propia copia. Cambia la política dentro del agente.

FAQ

1. ¿Qué permiso necesito para agregar un conector?
   Gestionar agentes de IA. Ver agentes de IA solo te permite ver conectores.
    
2. ¿Puedo editar o eliminar los conectores integrados?
   No. Solo puedes cambiar sus permisos de herramienta.
    
3. ¿Cómo decide Factorial IT si una herramienta es de solo lectura?
   Solo las herramientas que el servidor MCP marca con readOnlyHint son de solo lectura. Cualquier otra herramienta es de lectura y escritura.
    
4. ¿Por qué no hay Requiere aprobación para los agentes?
   Un agente funciona por sí mismo, así que nadie está allí para aprobar la herramienta.
    
5. ¿Puedo ver el secreto de cliente después de guardarlo?
   No. Nunca se muestra nuevamente.