Un conector permite que ONE acceda a una herramienta que se encuentra fuera de Factorial IT. Agrega uno cuando quieras que el asistente busque información 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 a través de 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 realizar una tarea en otro servicio.

Razones típicas para agregar uno:

• Buscar datos en otro lugar. Traer información que posee una herramienta en la que tu equipo confía.
• Actuar en otro lugar. Permitir que el asistente complete tareas dentro de un servicio conectado.
• Ampliar lo que puede hacer el asistente. Conectar 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 la guía de tu propia empresa. Para eso, usa 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, volverás a Factorial IT y el conector mostrará Conectado.

Estados de los conectores

Ver un conector

La pestaña Conectores muestra primero los conectores integrados (Factorial IT y el conector del centro de ayuda), seguidos 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 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 podrás 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 a ONE cuando trabaja sin supervisión, por ejemplo, en un ticket donde lo has agregado como agente. Cuando enciendes 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-escritura. Una herramienta cuenta como de solo lectura solo si el servidor MCP la marca con la anotación readOnlyHint. Cualquier otra cosa se trata como lectura-escritura.

Para establecer una política para todo un grupo, usa 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 junto al 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-escritura de inmediato. Para mantener a los agentes limitados a la lectura en un conector, establece Herramientas de lectura-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 utiliza conectores

Durante una conversación, ONE tiene acceso a las herramientas de cada conector conectado y elige la adecuada 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 aún lo está utilizando. Apágalo en ese agente primero.
• 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 en Configuraciones avanzadas.
• Un cambio de permiso no llegó 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-escritura.
    
4. ¿Por qué no hay opción de Requiere aprobación para los agentes?
   Un agente opera por sí solo, 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.