Conectores (servidores MCP)¶

Un conector lleva las acciones de un servicio externo a tu organización: un sistema de tickets, una base de conocimientos o cualquier otra aplicación que ofrezca un servidor MCP. MCP (Model Context Protocol) es un estándar con el que un programa ofrece acciones que un modelo de IA puede llamar. Esta página muestra cómo añadir un conector, permitir su dirección, elegir qué acciones puede usar la IA y convertirlas en herramientas que usan las personas y los asistentes.

Quién gestiona los conectores¶

Añadir, cambiar y actualizar conectores puede hacerlo quien puede configurar las herramientas de la organización: los administradores de la organización (org-admin) y un rol propio con write sobre toolbox. Eliminar un conector requiere delete sobre toolbox. Solo un administrador puede permitir la dirección de un conector nuevo (más abajo).

Abre Sala de máquinas y elige la pestaña Conectores. Desde la AI Toolbox también llegas, con Conectores en la barra de arriba. Ves una tabla con el Nombre, la URL del servidor, la Autenticación y las Acciones de cada conector: Todas · 12 cuando la IA puede usar cada acción, 8 de 12 cuando elegiste una parte, o Aún no detectadas e Inaccesible mientras OS no conoce las acciones. Cuando un conector no ofrece acciones porque una dirección no está permitida, se indica encima de la tabla y junto al nombre del conector (más abajo). Un conector que instaló una suscripción solo puede verse aquí.

Añadir un conector¶

1. Elige Añadir conector.
2. Rellena:
   • Nombre: letras minúsculas, cifras, - y _, como máximo 32 caracteres. Queda fijo en cuanto el conector existe.
   • Título y Descripción: cómo se llama el conector en OS.
   • URL del servidor: la dirección del servidor MCP, por ejemplo https://mcp.example.com/mcp.
   • Región (opcional): dónde está el servidor, como eu o nl.

3. En Credencial, en Iniciar sesión con, elige cómo se identifica el conector ante el servidor:

   Opción	Cuándo
   Ninguna	El servidor no pide identificación.
   Token Bearer	El servidor te da un token fijo. Escribe el token y, si el servidor lo espera en un encabezado distinto de Authorization, el nombre de ese encabezado.
   OAuth — toda la organización	El conector obtiene él mismo un token con un identificador de cliente y un secreto de cliente, para toda la organización. Rellena el Endpoint de token, el Client ID, el Client secret y, si hace falta, los Scopes y la Audience (opcional).
   OAuth — por usuario	Cada persona inicia sesión en el servicio con su propia cuenta, y las acciones funcionan con esa cuenta (más abajo).

4. Añade si hace falta Encabezados que acompañan cada llamada, y Valores de instalación: valores fijos para esta organización. Un valor de instalación que marcas como Secreto no se vuelve a mostrar nunca. En un encabezado, {$nombre} representa el valor de instalación con ese nombre.

5. Elige Añadir conector.

Los secretos solo se escriben. Un token, un secreto de cliente y un valor de instalación secreto se guardan cifrados y después no se muestran a nadie, tampoco a ti. Al editar (Editar en la página del conector) dejas un campo así vacío para conservar lo que tiene (Guardado; déjelo en blanco para conservarlo), o eliges Sustituir la credencial para escribir una nueva. Si eliges otra forma de iniciar sesión, vuelves a escribir también su secreto. Guarda un cambio con Guardar cambios.

OS rechaza un encabezado que eludiría o filtraría la identificación: Cookie, Proxy-Authorization, Authorization junto a una credencial, o el encabezado que usa la propia credencial. También se rechaza un secreto en la URL del servidor. El mensaje nombra el campo, nunca el valor.

Permitir la dirección¶

Las funciones de IA de tu organización no llaman a ninguna dirección externa que la organización no haya permitido. Eso vale también para un conector: mientras la dirección del servidor, o el endpoint de token de un inicio de sesión OAuth, no esté permitida, el conector no ofrece ninguna acción.

La página del conector indica en Hosts cada dirección que usa, con No permitido o Bloqueado por el despliegue cuando es así. Un administrador permite una dirección en el documento de reglas:

1. Elige Ir a las reglas en la página del conector, o abre Gestión de usuarios y elige Documento de reglas.
2. Elige Añadir regla. Ponle un nombre a la regla en Nombre, por ejemplo sistema-tickets, deja Efecto en permit: permite y elige egress_host en Tipo.
3. En Condiciones, elige la celda Toda cosa, toda persona. En Nombres, escribe la dirección, por ejemplo mcp.example.com, o *.example.com para toda dirección por debajo: una dirección por línea. Elige Listo.
4. Elige Guardar documento de reglas.

Si no puedes cambiar reglas tú mismo, pídeselo a un administrador: permitir una dirección decide adónde van los datos de la organización.

La dirección se aplica en unos segundos. Después elige Actualizar conector en la página del conector. Bloqueado por el despliegue no puedes resolverlo tú: el operador del despliegue no permite esa dirección para ninguna organización.

Leer las acciones¶

Después de añadir y después de cada cambio, OS lee la lista de acciones del servidor, normalmente en menos de un minuto, y luego cada hora. La página del conector muestra en Acciones en qué punto está:

Elige Actualizar conector para leer la lista de nuevo enseguida. Mientras la lectura falle, el conector no ofrece ninguna acción.

Elegir qué acciones puede usar la IA¶

Un conector nuevo aún no ofrece nada: primero eliges. En Gestionar acciones aparece cada acción que ofrece el servidor, con su descripción. Elige arriba:

• Elegir: solo las acciones que activas. Una acción que el servidor añade más tarde solo se suma cuando la activas. Así un conector no gana una capacidad sin que lo notes.
• Todo, también lo que venga después: cada acción, también las que el servidor añada más tarde.

Elige Guardar. Una acción activada está disponible: un asistente puede recibirla y puedes hacer una herramienta con ella. Una acción desactivada no la puede usar nadie en la organización. Una acción activada que el servidor ya no ofrece sigue en la lista con No encontrada en la última lectura; desactívala para quitarla.

Versiones simuladas de las acciones¶

Debajo de las acciones está la tarjeta Versiones simuladas. Cada acción que ofrece el conector puede tener una versión simulada: una respuesta fija u otra herramienta, que responde en lugar de la acción en las ejecuciones de una evaluación y en las pruebas. Una conversación siempre usa la acción real. Elige para cada acción qué responde y elige Guardar versiones simuladas; eso es una nueva versión del conector. Un conector que instaló una suscripción muestra las versiones simuladas en gris.

Poner una acción en la caja de herramientas¶

Una acción disponible aún no es una herramienta de la AI Toolbox. Elige Añadir a la caja de herramientas junto a la acción. Se abre la pantalla Crear una nueva herramienta con Preajuste ya elegido, sobre esa acción:

1. En ¿Para quién es?, elige Para personas o Solo para asistentes, y elige Continuar.
2. El Nombre viene propuesto, y la Descripción es la del servidor. Escribe un Título y ajusta el resto si quieres.
3. Elige Crear herramienta.

Después, la acción muestra Herramienta: nombre, con un enlace a la herramienta.

El formulario con el que alguien ejecuta la herramienta sigue al servidor: cuando el servidor cambia la entrada de una acción, el formulario cambia con ella. Cuando el servidor quita la acción, la herramienta deja de estar disponible.

Configurar el inicio de sesión por usuario¶

Con OAuth — por usuario, cada acción funciona con la cuenta de la persona que la usa. Para ello, registra primero OS como aplicación en el servicio (el proveedor) y rellena en OS:

• el Endpoint de autorización y el Endpoint de token del proveedor;
• el Client ID y, si el proveedor lo pide, el Client secret (opcional). Un cliente público no usa secreto;
• los Scopes, separados por espacios, y si hace falta la Audience (opcional).

El formulario muestra la URI de redirección. Cópiala con Copiar y regístrala en el proveedor: ahí vuelve una persona después de iniciar sesión. Permite también la dirección del endpoint de token (más arriba).

Después, cada persona conecta su propia cuenta en la página Mis conexiones. Hasta que alguien lo haga, una herramienta sobre una acción así le pide que inicie sesión primero. Si quitas a alguien de la organización, OS olvida su conexión por sí solo.

Una app de IA que un miembro conecta a un grupo de la AI Toolbox no puede usar una acción así: la app trabaja con una clave, no con la cuenta de la persona (Conectar una aplicación de IA a un grupo).

Versiones y restaurar¶

Cada cambio de la dirección, los encabezados, los valores de instalación o las acciones elegidas es una versión nueva. Aparecen en Versiones, la más reciente primero, con la hora, la dirección, los nombres de los encabezados y las acciones. Cada cambio se aplica enseguida; no hay borradores.

Elige Restaurar en una versión anterior para que su dirección, sus encabezados, sus valores de instalación y sus acciones pasen a ser los más recientes. Los valores de instalación secretos conservan lo que tiene la última versión: si un secreto era distinto entonces, vuelves a escribirlo. La identificación del conector pertenece al propio conector, no a una versión, y sigue igual al restaurar.

Eliminar un conector¶

Elige Eliminar junto al conector en la tabla y confirma. OS lo rechaza mientras:

• una herramienta esté sobre una de sus acciones. Elimina primero esas herramientas;
• un asistente use una de sus acciones. Quita primero la acción de ese asistente.

Después de eliminarlo, nadie puede usar ya las acciones del conector.

Por la API¶

Todo lo de esta página también se puede hacer por la API de OS, en /api/v1/organisations/{id}/toolbox/mcp-servers. Un administrador también puede permitir una dirección con POST /api/v1/organisations/{id}/allowed-hosts y {"host": "mcp.example.com"}; eso añade la regla al documento de reglas (El documento de reglas).