Skip to main content
El servidor MCP de Flexxible permite conectar asistentes de inteligencia artificial, como Claude o ChatGPT, con la plataforma. Una vez conectado, el asistente puede consultar en lenguaje natural la información de la organización (workspaces, sesiones, aplicaciones instaladas, grupos, flujos, informes, etc.) y, si se le concede permiso, modificar la configuración o ejecutar operaciones sobre los dispositivos.

​
Qué es MCP

Model Context Protocol (MCP) es un estándar abierto que define cómo las aplicaciones de inteligencia artificial se conectan con herramientas y fuentes de datos externas. Funciona como un conector universal: cualquier aplicación compatible con MCP puede utilizar cualquier servidor MCP sin necesidad de desarrollos específicos. Un servidor MCP publica un conjunto de herramientas (tools). Cada herramienta realiza una acción concreta, como listar los workspaces de una organización o reiniciar un dispositivo, e incluye una descripción que indica al asistente para qué sirve y qué parámetros necesita. Cuando se le hace una petición, el asistente:
  1. Interpreta la petición y elige las herramientas necesarias.
  2. Llama a esas herramientas en el servidor MCP con los parámetros adecuados.
  3. Utiliza los resultados para elaborar la respuesta o decidir el siguiente paso.
Por ejemplo, ante la pregunta “¿Cuántos dispositivos con Windows 11 están sin conexión en el tenant Contoso?”, el asistente localiza la organización Contoso, cuenta los workspaces que cumplen las condiciones y responde con el resultado. mcp-diagram

​
Cómo funciona el servidor MCP de Flexxible

El servidor MCP de Flexxible está disponible en la siguiente dirección:
Sus características principales son:
  • Basado en la API de Flexxible. Las operaciones de la API Gen 2 (v2) se publican como herramientas independientes que cubren workspaces, sesiones, aplicaciones instaladas, alertas, parches, grupos de reporte, grupos de workspaces, flujos, microservicios, operaciones, Actividad Digital, ubicaciones, redes, usuarios, roles, tenants y auditoría, entre otros.
  • Autorización con clave de API. La conexión se autoriza una sola vez con una clave de API de la plataforma, que se introduce en una página de Flexxible. El asistente nunca ve la clave: recibe un token de acceso independiente que solo es válido para el servidor MCP.
  • Permisos elegidos por el usuario. Al autorizar la conexión se eligen los permisos del asistente. El asistente solo puede hacer lo que permitan, a la vez, esos permisos y el rol de la clave de API.
  • Acceso limitado a las organizaciones de la clave. El asistente solo puede acceder a la organización de la clave de API y a sus tenants. Cualquier otra organización se rechaza antes de llegar a la API.
  • Acciones identificadas. Cada herramienta indica si solo consulta datos o si puede modificarlos o eliminarlos, lo que permite a las aplicaciones de IA solicitar confirmación antes de ejecutar un cambio.
  • Operaciones acotadas. Cada operación sobre dispositivos o sesiones (reiniciar, apagar, cerrar sesión, enviar una notificación, etc.) se dirige a una lista explícita de, como máximo, 100 elementos.
El servidor MCP funciona con el entorno Flexxible (api.flexxible.net). Las claves de API del entorno FXXOne no son compatibles.

​
Permisos

Las claves de API no tienen permisos propios: lo que pueden hacer depende del rol asignado a la clave. Al conectar el asistente se eligen, además, los permisos de la conexión, que actúan como un límite adicional sobre ese rol.
Las operaciones en dispositivos actúan sobre equipos reales: los usuarios de un dispositivo reiniciado o apagado pierden el trabajo no guardado, y un microservicio realiza lo que indique su script. Los flujos y las programaciones actúan más tarde y de forma repetida sobre todos los dispositivos a los que se dirigen, por lo que también requieren este permiso.
Añadir dispositivos a un grupo de workspaces (permiso de Escritura) los somete a las programaciones existentes del grupo y a los flujos que se dirigen a él.

​
Direcciones por dominio

Además de la dirección principal, el servidor ofrece direcciones que solo incluyen las herramientas de un área concreta. Están pensadas para aplicaciones que cargan a la vez todas las herramientas de un conector, como Microsoft Copilot Studio, en las que un conjunto más reducido funciona mejor. En Claude y ChatGPT se recomienda usar la dirección principal. Cada dirección se forma añadiendo la ruta a https://mcp.flexxible.net (por ejemplo, https://mcp.flexxible.net/mcp/devices). Todas las direcciones incluyen, además, dos herramientas generales: una que muestra la identidad de la conexión (organización, clave de API y permisos) y otra que lista las organizaciones accesibles. Es posible añadir varias direcciones a la misma aplicación.

​
Requisitos

  • Una clave de API de la plataforma (API Gen 2).
  • Una aplicación de IA compatible con servidores MCP remotos con autenticación OAuth, como Claude o ChatGPT. El plan contratado o las políticas de la organización pueden restringir la posibilidad de añadir conectores personalizados.

​
Crear una clave de API para el asistente

Para crear la clave es necesario tener el rol de Administrador de organización.
  1. Acceder a Configuración → Organización.
  2. Seleccionar la pestaña Claves de API.
  3. Hacer clic en Crear clave de API.
  4. Rellenar el formulario:
api-3
  • Nombre. Identificador de la clave de API. Por ejemplo, Asistente IA - Claude.
  • Rol. Rol con los permisos mínimos necesarios para lo que se quiere que haga el asistente.
  • Duración. Tiempo de validez de la clave. La conexión con el asistente deja de funcionar cuando la clave caduca.
  1. Hacer clic en Guardar y copiar la clave.
Utilizar una clave de API específica para el asistente facilita auditar su actividad y revocar el acceso sin afectar a otras integraciones.
La clave de API solo debe introducirse en la página de autorización de Flexxible. No se debe pegar nunca en una conversación con el asistente.

​
Conectar un asistente de IA

El proceso es similar en todas las aplicaciones compatibles con MCP:
  1. En la aplicación de IA, añadir un conector o servidor MCP personalizado.
  2. Introducir un nombre (por ejemplo, Flexxible) y la dirección https://mcp.flexxible.net/mcp.
  3. Si la aplicación solicita el tipo de autenticación, seleccionar OAuth. No es necesario introducir un ID ni un secreto de cliente: la aplicación se identifica automáticamente ante el servidor.
  4. Iniciar la conexión. La aplicación abre la página de autorización de Flexxible en el navegador.
  5. Completar los dos pasos de la página de autorización, que se describen a continuación.
  6. Volver a la aplicación de IA y comprobar que el conector está activo en la conversación.
En los apartados Conectar Claude y Conectar ChatGPT se detallan los pasos para cada aplicación.

​
Página de autorización

Al iniciar la conexión, la aplicación de IA abre una página de Flexxible con dos pasos. La página está disponible en español, inglés, catalán, euskera y portugués de Brasil, y el idioma puede cambiarse desde el selector de la parte superior derecha.

​
Paso 1: Revisar el acceso

mcp-consent-step1 La página muestra la siguiente información:
  • Aplicación que solicita el acceso. Las aplicaciones que se identifican con una identidad publicada, como Claude o ChatGPT, muestran Publicada por y su dominio. Las aplicaciones que se registran de forma automática aparecen como Aplicación no verificada, ya que cualquier aplicación puede registrarse con cualquier nombre. En ese caso, solo se debe continuar si se acaba de iniciar la conexión desde una aplicación de confianza.
  • El acceso se enviará a. Dominio de la aplicación que recibirá el acceso. Si se trata de una aplicación instalada en el propio equipo, se muestra un aviso.
  • Servidor MCP. Dirección del servidor que se está autorizando.
  • Permisos. Lectura siempre está incluido. Escritura aparece marcado si la aplicación lo solicita. Administración y Operaciones en dispositivos nunca se marcan de forma automática, aunque la aplicación los solicite (en ese caso aparecen como Solicitado): para concederlos, se deben marcar manualmente.
Hacer clic en Continuar para pasar al siguiente paso, o en Denegar para cancelar la conexión.

​
Paso 2: Introducir la clave de API

mcp-consent-step2 La página resume la aplicación y los permisos elegidos. El botón Cambiar permite volver al paso anterior sin perder la selección.
  1. Pegar la clave de API en el campo Clave de API.
  2. Hacer clic en Autorizar.
La plataforma comprueba la clave antes de guardar la autorización. Si la clave no es válida, se muestra un mensaje de error y es posible corregirla sin salir de la página. Una vez autorizada la conexión, el navegador vuelve a la aplicación de IA.

​
Conectar Claude

Los conectores personalizados están disponibles en Claude (web), Claude Desktop y Cowork para los planes Free, Pro, Max, Team y Enterprise. En el plan Free solo se puede añadir un conector personalizado.
Los nombres de los menús de Claude corresponden a su interfaz en inglés. Si Claude está configurado en español, los menús aparecen traducidos (por ejemplo, Personalizar → Conectores).

​
Planes Free, Pro y Max

  1. Acceder a Customize → Connectors. En Claude Desktop, seleccionar Customize en la barra lateral y, a continuación, Connectors.
  2. Hacer clic en + Add → Add custom connector.
  3. Introducir un nombre para el conector (por ejemplo, Flexxible) y la dirección del servidor: https://mcp.flexxible.net/mcp. Hacer clic en Continue.
  4. Revisar la configuración de autenticación que Claude ha detectado y hacer clic en Continue.
  5. Configurar las siguientes opciones:
    • Authentication. Mantener una opción con inicio de sesión (Sign in now o Sign in when needed). No seleccionar No sign in.
    • OAuth client. Seleccionar Use Claude’s published identity (Recommended). Con esta opción, la página de autorización muestra la aplicación como Publicada por claude.ai.
    • Request headers. Dejar vacío. El servidor no admite claves de API en las cabeceras: la clave se introduce siempre en la página de autorización.
  6. Hacer clic en Add. Si la página de autorización no se abre automáticamente, hacer clic en Connect junto al conector.
  7. Completar los dos pasos de la página de autorización. Al terminar, el conector aparece como conectado.

​
Planes Team y Enterprise

En estos planes, un propietario de la organización añade el conector una sola vez y, después, cada miembro lo conecta con su propia clave de API. Para añadir el conector a la organización (solo propietarios o, en Enterprise, roles personalizados con el permiso Manage access to Libraries):
  1. Acceder a Organization settings → Connectors.
  2. Hacer clic en Add, situar el cursor sobre Custom y seleccionar Web.
  3. Seguir los pasos 3 a 6 del apartado anterior.
Para empezar a usar el conector (cada miembro):
  1. Acceder a Customize → Connectors.
  2. Localizar el conector añadido por el propietario. Suele mostrar la etiqueta Custom.
  3. Hacer clic en Connect y completar la página de autorización con una clave de API propia.

​
Utilizar el conector en una conversación

  1. En una conversación, hacer clic en el botón + de la parte inferior izquierda del cuadro de texto.
  2. Seleccionar Connectors y activar Flexxible.
  3. Escribir la petición.
Cuando Claude va a usar una herramienta de Flexxible, solicita permiso con las opciones Allow once (permitir una vez) o Always allow (permitir siempre). Para cambiar esta configuración más adelante, acceder a Customize → Connectors, seleccionar el conector y, en Tool permissions, elegir para cada grupo de herramientas (de solo lectura o de escritura y eliminación) o para cada herramienta entre Always allow, Needs approval o Blocked.
Se recomienda mantener Needs approval para las herramientas que modifican o eliminan datos, de modo que Claude solicite confirmación antes de cada cambio.
Para más información, consulta la documentación oficial de Claude.

​
Conectar ChatGPT

La conexión con servidores MCP personalizados está disponible en ChatGPT web para los planes Business y Enterprise/Edu. No está disponible en las aplicaciones móviles.
  • Business. Solo los administradores y propietarios del espacio de trabajo pueden añadir y publicar servidores MCP personalizados.
  • Enterprise/Edu. Los administradores y propietarios pueden añadirlos y conceder a otros miembros el permiso Create plugins with MCPs desde Workspace settings → Permissions & roles. Solo los administradores y propietarios pueden publicarlos para el espacio de trabajo.
En el plan Pro, ChatGPT solo permite conectar servidores MCP personalizados con permisos de lectura. Los nombres de los menús corresponden a la interfaz en inglés de ChatGPT, donde los conectores se denominan Plugins.

​
Añadir el servidor

  1. Acceder a Plugins desde la barra lateral.
  2. Hacer clic en el botón + y seleccionar Add custom MCP server.
  3. Introducir un nombre (por ejemplo, Flexxible) y, opcionalmente, una descripción.
  4. En Connection, introducir la dirección del servidor: https://mcp.flexxible.net/mcp.
  5. En la autenticación, seleccionar OAuth. No es necesario introducir un ID ni un secreto de cliente.
  6. Revisar el aviso de riesgo y marcar la casilla I understand and want to continue.
  7. Hacer clic en Create as a plugin.
  8. Completar los dos pasos de la página de autorización de Flexxible cuando ChatGPT la abra y revisar las herramientas detectadas.
  9. Instalar el plugin creado.
Según cómo se identifique ChatGPT ante el servidor, la página de autorización lo muestra como Publicada por chatgpt.com o como Aplicación no verificada. Ambos casos son normales si se acaba de iniciar la conexión desde ChatGPT.
Para que otros miembros del espacio de trabajo puedan utilizarlo, un administrador o propietario debe publicarlo desde la consola de administración de ChatGPT. Cada miembro autoriza después la conexión con su propia clave de API.

​
Utilizar el plugin en una conversación

  1. Iniciar una conversación nueva.
  2. Escribir @ en el cuadro de texto y seleccionar Flexxible.
  3. Escribir la petición.
La selección se aplica solo al mensaje en el que se realiza. Si una petición posterior necesita datos nuevos de Flexxible, volver a mencionar el plugin con @. ChatGPT solicita confirmación antes de ejecutar las acciones que modifican datos, en función de los permisos configurados en ChatGPT y del contexto de la acción.
En los espacios de trabajo, ChatGPT utiliza una copia fija de las herramientas del servidor tomada al publicarlo. Cuando Flexxible añade herramientas nuevas, un administrador debe actualizar la lista de herramientas (Refresh) desde la configuración del espacio de trabajo para que estén disponibles.
Para más información, consulta la documentación oficial de ChatGPT.

​
Ejemplos de uso

Una vez conectado, basta con pedir al asistente lo que se necesita en lenguaje natural. Algunos ejemplos: Workspaces y sesiones
  • “¿Cuántos dispositivos con Windows 11 están sin conexión en el tenant Contoso?”
  • “¿Qué dispositivos tienen actualizaciones de Windows pendientes?”
  • “Muestra las alertas y el uso de disco del dispositivo LAPTOP-042.”
  • “¿Qué dispositivos tienen Zoom instalado y en qué versión?”
  • “¿Quién tiene una sesión iniciada en los servidores de sesiones ahora mismo?”
  • “Reinicia los dispositivos KIOSK-01 y KIOSK-02.” (Operaciones en dispositivos)
Grupos
  • “Crea un grupo de workspaces llamado Quioscos con estos tres dispositivos.” (Escritura)
  • “Añade un reinicio diario a las 2:00, hora de Madrid, al grupo Quioscos.” (Operaciones en dispositivos)
  • “Lista los grupos de reporte y su configuración de producto.”
  • “Obtén el informe mensual del grupo de reporte Oficinas de septiembre de 2026.”
Automatización
  • “¿Qué flujos están habilitados y qué hacen?”
  • “¿Qué microservicios están habilitados en esta organización?”
  • “Ejecuta el microservicio de limpieza de disco en el dispositivo LAPTOP-042.” (Operaciones en dispositivos)
  • “¿El reinicio de anoche se completó correctamente en todos los dispositivos?”
Administración
  • “¿Quién eliminó el grupo Quioscos y cuándo?”
  • “Lista los usuarios con el rol Helpdesk.”
  • “¿Cuántos grupos de workspaces, flujos y usuarios puede tener esta organización?”
La mayoría de las aplicaciones de IA solicitan confirmación antes de ejecutar una herramienta que modifica datos. Antes de aprobarla, se recomienda revisar los detalles (nombres, dispositivos, horarios).
Las operaciones ejecutadas desde el asistente se registran en Operaciones, igual que las ejecutadas desde la plataforma, y se ejecutan de forma asíncrona: el asistente puede consultar su estado y el resultado en cada dispositivo.

​
Trabajar con varias organizaciones

Si la clave de API pertenece a una organización con tenants, el asistente puede trabajar con cualquier organización de ese árbol:
  • Por defecto, las peticiones se aplican a la organización de la clave de API.
  • Para trabajar con un tenant, basta con nombrarlo en la petición (por ejemplo, “…en el tenant Contoso”). El asistente lo busca por su nombre.
  • Las preguntas de recuento y resumen pueden abarcar varias organizaciones a la vez (por ejemplo, “…en todos mis tenants”). Las organizaciones se procesan en lotes de 25 y el asistente puede continuar con el siguiente lote.
  • Las organizaciones que no pertenecen al árbol de la clave se rechazan, aunque se conozca su ID.
  • Un tenant recién creado puede tardar hasta cinco minutos en estar disponible.

​
Gestionar la conexión

​
Ampliar o reducir los permisos

No es necesario conceder todos los permisos al conectar. Cuando una petición necesita un permiso que no se ha concedido, el servidor solicita a la aplicación de IA una nueva autorización: la página de autorización se abre con el permiso adicional solicitado y, tras marcarlo y volver a introducir la clave de API, la petición continúa. Si la aplicación no muestra esta solicitud, desconectar el conector y volver a conectarlo marcando el permiso necesario. Para reducir los permisos, desconectar el conector en la aplicación de IA y volver a conectarlo con menos permisos marcados.

​
Revocar el acceso

Para cortar el acceso por completo, revocar o eliminar la clave de API en Configuración → Organización → Claves de API. Todas las conexiones que utilizan esa clave dejan de funcionar.

​
Duración de la conexión

La conexión se renueva de forma automática mientras se utiliza: cada renovación la mantiene activa durante 30 días más. Es necesario volver a conectar en los siguientes casos:
  • La conexión no se ha utilizado durante 30 días.
  • La clave de API ha caducado. Una conexión nunca dura más que su clave.
  • La clave de API se ha revocado.

​
Límites de uso

Cada conexión puede realizar, por minuto, hasta:
  • 60 consultas.
  • 30 cambios de escritura o administración.
  • 5 operaciones en dispositivos, incluidos los cambios en flujos y programaciones.
Además, la API de Flexxible limita el número de solicitudes por clave de API. Este límite es compartido por todas las conexiones que utilizan la misma clave.

​
Solución de problemas

​
Buenas prácticas

  • Crear una clave de API específica para el asistente, con el rol mínimo necesario y una duración limitada.
  • Conceder solo los permisos necesarios y ampliarlos cuando haga falta.
  • Revisar con atención las acciones que propone el asistente antes de confirmarlas, en especial las operaciones en dispositivos.
  • Revocar la clave de API cuando deje de utilizarse o si existe la sospecha de que se ha visto comprometida.