Skip to main content
El servidor MCP de Flexxible permet connectar assistents d’intel·ligència artificial, com Claude o ChatGPT, amb la plataforma. Un cop connectat, l’assistent pot consultar en llenguatge natural la informació de l’organització (workspaces, sessions, aplicacions instal·lades, grups, fluxos, informes, etc.) i, si se li concedeix permís, modificar la configuració o executar operacions sobre els dispositius.

​
Què és MCP

Model Context Protocol (MCP) és un estàndard obert que defineix com les aplicacions d’intel·ligència artificial es connecten amb eines i fonts de dades externes. Funciona com un connector universal: qualsevol aplicació compatible amb MCP pot utilitzar qualsevol servidor MCP sense necessitat de desenvolupaments específics. Un servidor MCP publica un conjunt d’eines (tools). Cada eina fa una acció concreta, com llistar els workspaces d’una organització o reiniciar un dispositiu, i inclou una descripció que indica a l’assistent per a què serveix i quins paràmetres necessita. Quan se li fa una petició, l’assistent:
  1. Interpreta la petició i tria les eines necessàries.
  2. Crida aquestes eines al servidor MCP amb els paràmetres adequats.
  3. Utilitza els resultats per elaborar la resposta o decidir el pas següent.
Per exemple, davant la pregunta “Quants dispositius amb Windows 11 estan sense connexió al tenant Contoso?”, l’assistent localitza l’organització Contoso, compta els workspaces que compleixen les condicions i respon amb el resultat. mcp-diagram

​
Com funciona el servidor MCP de Flexxible

El servidor MCP de Flexxible està disponible a l’adreça següent:
Les seves característiques principals són:
  • Basat en l’API de Flexxible. Les operacions de l’API Gen 2 (v2) es publiquen com a eines independents que cobreixen workspaces, sessions, aplicacions instal·lades, alertes, pegats, grups de reporte, grups de workspaces, fluxos, microserveis, operacions, Activitat Digital, ubicacions, xarxes, usuaris, rols, tenants i auditoria, entre d’altres.
  • Autorització amb clau d’API. La connexió s’autoritza una sola vegada amb una clau d’API de la plataforma, que s’introdueix en una pàgina de Flexxible. L’assistent mai no veu la clau: rep un token d’accés independent que només és vàlid per al servidor MCP.
  • Permisos triats per l’usuari. En autoritzar la connexió es trien els permisos de l’assistent. L’assistent només pot fer el que permetin, alhora, aquests permisos i el rol de la clau d’API.
  • Accés limitat a les organitzacions de la clau. L’assistent només pot accedir a l’organització de la clau d’API i als seus tenants. Qualsevol altra organització es rebutja abans d’arribar a l’API.
  • Accions identificades. Cada eina indica si només consulta dades o si pot modificar-les o eliminar-les, cosa que permet a les aplicacions d’IA sol·licitar confirmació abans d’executar un canvi.
  • Operacions acotades. Cada operació sobre dispositius o sessions (reiniciar, apagar, tancar sessió, enviar una notificació, etc.) es dirigeix a una llista explícita de, com a màxim, 100 elements.
El servidor MCP funciona amb l’entorn Flexxible (api.flexxible.net). Les claus d’API de l’entorn FXXOne no són compatibles.

​
Permisos

Les claus d’API no tenen permisos propis: el que poden fer depèn del rol assignat a la clau. En connectar l’assistent es trien, a més, els permisos de la connexió, que actuen com un límit addicional sobre aquest rol.
Les operacions en dispositius actuen sobre equips reals: els usuaris d’un dispositiu reiniciat o apagat perden la feina no desada, i un microservei fa el que indiqui el seu script. Els fluxos i les programacions actuen més tard i de manera repetida sobre tots els dispositius als quals es dirigeixen, per la qual cosa també requereixen aquest permís.
Afegir dispositius a un grup de workspaces (permís d’Escriptura) els sotmet a les programacions existents del grup i als fluxos que s’hi dirigeixen.

​
Adreces per domini

A més de l’adreça principal, el servidor ofereix adreces que només inclouen les eines d’una àrea concreta. Estan pensades per a aplicacions que carreguen alhora totes les eines d’un connector, com Microsoft Copilot Studio, en les quals un conjunt més reduït funciona millor. A Claude i ChatGPT es recomana utilitzar l’adreça principal. Cada adreça es forma afegint la ruta a https://mcp.flexxible.net (per exemple, https://mcp.flexxible.net/mcp/devices). Totes les adreces inclouen, a més, dues eines generals: una que mostra la identitat de la connexió (organització, clau d’API i permisos) i una altra que llista les organitzacions accessibles. És possible afegir diverses adreces a la mateixa aplicació.

​
Requisits

  • Una clau d’API de la plataforma (API Gen 2).
  • Una aplicació d’IA compatible amb servidors MCP remots amb autenticació OAuth, com Claude o ChatGPT. El pla contractat o les polítiques de l’organització poden restringir la possibilitat d’afegir connectors personalitzats.

​
Crear una clau d’API per a l’assistent

Per crear la clau cal tenir el rol d’Administrador d’organització.
  1. Accedeix a Configuració → Organització.
  2. Selecciona la pestanya Claus d’API.
  3. Fes clic a Crear clau d’API.
  4. Emplena el formulari:
api-3
  • Nom. Identificador de la clau d’API. Per exemple, Assistent IA - Claude.
  • Rol. Rol amb els permisos mínims necessaris per al que es vol que faci l’assistent.
  • Durada. Temps de validesa de la clau. La connexió amb l’assistent deixa de funcionar quan la clau caduca.
  1. Fes clic a Desar i copia la clau.
Utilitzar una clau d’API específica per a l’assistent facilita auditar-ne l’activitat i revocar l’accés sense afectar altres integracions.
La clau d’API només s’ha d’introduir a la pàgina d’autorització de Flexxible. No s’ha d’enganxar mai en una conversa amb l’assistent.

​
Connectar un assistent d’IA

El procés és similar en totes les aplicacions compatibles amb MCP:
  1. A l’aplicació d’IA, afegeix un connector o servidor MCP personalitzat.
  2. Introdueix un nom (per exemple, Flexxible) i l’adreça https://mcp.flexxible.net/mcp.
  3. Si l’aplicació sol·licita el tipus d’autenticació, selecciona OAuth. No cal introduir un ID ni un secret de client: l’aplicació s’identifica automàticament davant el servidor.
  4. Inicia la connexió. L’aplicació obre la pàgina d’autorització de Flexxible al navegador.
  5. Completa els dos passos de la pàgina d’autorització, que es descriuen a continuació.
  6. Torna a l’aplicació d’IA i comprova que el connector està actiu a la conversa.
Als apartats Connectar Claude i Connectar ChatGPT es detallen els passos per a cada aplicació.

​
Pàgina d’autorització

En iniciar la connexió, l’aplicació d’IA obre una pàgina de Flexxible amb dos passos. La pàgina està disponible en castellà, anglès, català, basc i portuguès del Brasil, i l’idioma es pot canviar des del selector de la part superior dreta.

​
Pas 1: Revisar l’accés

mcp-consent-step1 La pàgina mostra la informació següent:
  • Aplicació que sol·licita l’accés. Les aplicacions que s’identifiquen amb una identitat publicada, com Claude o ChatGPT, mostren Publicada per i el seu domini. Les aplicacions que es registren de manera automàtica apareixen com a Aplicació no verificada, ja que qualsevol aplicació es pot registrar amb qualsevol nom. En aquest cas, només s’ha de continuar si s’acaba d’iniciar la connexió des d’una aplicació de confiança.
  • L’accés s’enviarà a. Domini de l’aplicació que rebrà l’accés. Si es tracta d’una aplicació instal·lada al mateix equip, es mostra un avís.
  • Servidor MCP. Adreça del servidor que s’està autoritzant.
  • Permisos. Lectura sempre està inclòs. Escriptura apareix marcat si l’aplicació ho sol·licita. Administració i Operacions en dispositius no es marquen mai de manera automàtica, encara que l’aplicació els sol·liciti (en aquest cas apareixen com a Sol·licitat): per concedir-los, s’han de marcar manualment.
Fes clic a Continuar per passar al pas següent, o a Denegar per cancel·lar la connexió.

​
Pas 2: Introduir la clau d’API

mcp-consent-step2 La pàgina resumeix l’aplicació i els permisos triats. El botó Canviar permet tornar al pas anterior sense perdre la selecció.
  1. Enganxa la clau d’API al camp Clau d’API.
  2. Fes clic a Autoritzar.
La plataforma comprova la clau abans de desar l’autorització. Si la clau no és vàlida, es mostra un missatge d’error i és possible corregir-la sense sortir de la pàgina. Un cop autoritzada la connexió, el navegador torna a l’aplicació d’IA.

​
Connectar Claude

Els connectors personalitzats estan disponibles a Claude (web), Claude Desktop i Cowork per als plans Free, Pro, Max, Team i Enterprise. Al pla Free només es pot afegir un connector personalitzat.
Els noms dels menús de Claude corresponen a la seva interfície en anglès. Si Claude està configurat en un altre idioma, els menús apareixen traduïts (per exemple, en castellà, Personalizar → Conectores).

​
Plans Free, Pro i Max

  1. Accedeix a Customize → Connectors. A Claude Desktop, selecciona Customize a la barra lateral i, a continuació, Connectors.
  2. Fes clic a + Add → Add custom connector.
  3. Introdueix un nom per al connector (per exemple, Flexxible) i l’adreça del servidor: https://mcp.flexxible.net/mcp. Fes clic a Continue.
  4. Revisa la configuració d’autenticació que Claude ha detectat i fes clic a Continue.
  5. Configura les opcions següents:
    • Authentication. Mantén una opció amb inici de sessió (Sign in now o Sign in when needed). No seleccionis No sign in.
    • OAuth client. Selecciona Use Claude’s published identity (Recommended). Amb aquesta opció, la pàgina d’autorització mostra l’aplicació com a Publicada per claude.ai.
    • Request headers. Deixa-ho buit. El servidor no admet claus d’API a les capçaleres: la clau s’introdueix sempre a la pàgina d’autorització.
  6. Fes clic a Add. Si la pàgina d’autorització no s’obre automàticament, fes clic a Connect al costat del connector.
  7. Completa els dos passos de la pàgina d’autorització. En acabar, el connector apareix com a connectat.

​
Plans Team i Enterprise

En aquests plans, un propietari de l’organització afegeix el connector una sola vegada i, després, cada membre el connecta amb la seva pròpia clau d’API. Per afegir el connector a l’organització (només propietaris o, a Enterprise, rols personalitzats amb el permís Manage access to Libraries):
  1. Accedeix a Organization settings → Connectors.
  2. Fes clic a Add, situa el cursor sobre Custom i selecciona Web.
  3. Segueix els passos 3 a 6 de l’apartat anterior.
Per començar a utilitzar el connector (cada membre):
  1. Accedeix a Customize → Connectors.
  2. Localitza el connector afegit pel propietari. Sol mostrar l’etiqueta Custom.
  3. Fes clic a Connect i completa la pàgina d’autorització amb una clau d’API pròpia.

​
Utilitzar el connector en una conversa

  1. En una conversa, fes clic al botó + de la part inferior esquerra del quadre de text.
  2. Selecciona Connectors i activa Flexxible.
  3. Escriu la petició.
Quan Claude utilitzarà una eina de Flexxible, sol·licita permís amb les opcions Allow once (permetre una vegada) o Always allow (permetre sempre). Per canviar aquesta configuració més endavant, accedeix a Customize → Connectors, selecciona el connector i, a Tool permissions, tria per a cada grup d’eines (de només lectura o d’escriptura i eliminació) o per a cada eina entre Always allow, Needs approval o Blocked.
Es recomana mantenir Needs approval per a les eines que modifiquen o eliminen dades, de manera que Claude sol·liciti confirmació abans de cada canvi.
Per a més informació, consulta la documentació oficial de Claude.

​
Connectar ChatGPT

La connexió amb servidors MCP personalitzats està disponible a ChatGPT web per als plans Business i Enterprise/Edu. No està disponible a les aplicacions mòbils.
  • Business. Només els administradors i propietaris de l’espai de treball poden afegir i publicar servidors MCP personalitzats.
  • Enterprise/Edu. Els administradors i propietaris poden afegir-los i concedir a altres membres el permís Create plugins with MCPs des de Workspace settings → Permissions & roles. Només els administradors i propietaris poden publicar-los per a l’espai de treball.
Al pla Pro, ChatGPT només permet connectar servidors MCP personalitzats amb permisos de lectura. Els noms dels menús corresponen a la interfície en anglès de ChatGPT, on els connectors s’anomenen Plugins.

​
Afegir el servidor

  1. Accedeix a Plugins des de la barra lateral.
  2. Fes clic al botó + i selecciona Add custom MCP server.
  3. Introdueix un nom (per exemple, Flexxible) i, opcionalment, una descripció.
  4. A Connection, introdueix l’adreça del servidor: https://mcp.flexxible.net/mcp.
  5. A l’autenticació, selecciona OAuth. No cal introduir un ID ni un secret de client.
  6. Revisa l’avís de risc i marca la casella I understand and want to continue.
  7. Fes clic a Create as a plugin.
  8. Completa els dos passos de la pàgina d’autorització de Flexxible quan ChatGPT l’obri i revisa les eines detectades.
  9. Instal·la el plugin creat.
Segons com s’identifiqui ChatGPT davant el servidor, la pàgina d’autorització el mostra com a Publicada per chatgpt.com o com a Aplicació no verificada. Tots dos casos són normals si s’acaba d’iniciar la connexió des de ChatGPT.
Perquè altres membres de l’espai de treball el puguin utilitzar, un administrador o propietari l’ha de publicar des de la consola d’administració de ChatGPT. Cada membre autoritza després la connexió amb la seva pròpia clau d’API.

​
Utilitzar el plugin en una conversa

  1. Inicia una conversa nova.
  2. Escriu @ al quadre de text i selecciona Flexxible.
  3. Escriu la petició.
La selecció s’aplica només al missatge en què es fa. Si una petició posterior necessita dades noves de Flexxible, torna a esmentar el plugin amb @. ChatGPT sol·licita confirmació abans d’executar les accions que modifiquen dades, en funció dels permisos configurats a ChatGPT i del context de l’acció.
En els espais de treball, ChatGPT utilitza una còpia fixa de les eines del servidor presa en publicar-lo. Quan Flexxible afegeix eines noves, un administrador ha d’actualitzar la llista d’eines (Refresh) des de la configuració de l’espai de treball perquè estiguin disponibles.
Per a més informació, consulta la documentació oficial de ChatGPT.

​
Exemples d’ús

Un cop connectat, n’hi ha prou de demanar a l’assistent el que es necessita en llenguatge natural. Alguns exemples: Workspaces i sessions
  • “Quants dispositius amb Windows 11 estan sense connexió al tenant Contoso?”
  • “Quins dispositius tenen actualitzacions de Windows pendents?”
  • “Mostra les alertes i l’ús de disc del dispositiu LAPTOP-042.”
  • “Quins dispositius tenen Zoom instal·lat i en quina versió?”
  • “Qui té una sessió iniciada als servidors de sessions ara mateix?”
  • “Reinicia els dispositius KIOSK-01 i KIOSK-02.” (Operacions en dispositius)
Grups
  • “Crea un grup de workspaces anomenat Quioscs amb aquests tres dispositius.” (Escriptura)
  • “Afegeix un reinici diari a les 2:00, hora de Madrid, al grup Quioscs.” (Operacions en dispositius)
  • “Llista els grups de reporte i la seva configuració de producte.”
  • “Obtén l’informe mensual del grup de reporte Oficines de setembre de 2026.”
Automatització
  • “Quins fluxos estan habilitats i què fan?”
  • “Quins microserveis estan habilitats en aquesta organització?”
  • “Executa el microservei de neteja de disc al dispositiu LAPTOP-042.” (Operacions en dispositius)
  • “El reinici d’ahir a la nit es va completar correctament a tots els dispositius?”
Administració
  • “Qui va eliminar el grup Quioscs i quan?”
  • “Llista els usuaris amb el rol Helpdesk.”
  • “Quants grups de workspaces, fluxos i usuaris pot tenir aquesta organització?”
La majoria de les aplicacions d’IA sol·liciten confirmació abans d’executar una eina que modifica dades. Abans d’aprovar-la, es recomana revisar-ne els detalls (noms, dispositius, horaris).
Les operacions executades des de l’assistent es registren a Operacions, igual que les executades des de la plataforma, i s’executen de manera asíncrona: l’assistent pot consultar-ne l’estat i el resultat a cada dispositiu.

​
Treballar amb diverses organitzacions

Si la clau d’API pertany a una organització amb tenants, l’assistent pot treballar amb qualsevol organització d’aquest arbre:
  • Per defecte, les peticions s’apliquen a l’organització de la clau d’API.
  • Per treballar amb un tenant, n’hi ha prou d’anomenar-lo a la petició (per exemple, “…al tenant Contoso”). L’assistent el cerca pel seu nom.
  • Les preguntes de recompte i resum poden abastar diverses organitzacions alhora (per exemple, “…a tots els meus tenants”). Les organitzacions es processen en lots de 25 i l’assistent pot continuar amb el lot següent.
  • Les organitzacions que no pertanyen a l’arbre de la clau es rebutgen, encara que se’n conegui l’ID.
  • Un tenant acabat de crear pot trigar fins a cinc minuts a estar disponible.

​
Gestionar la connexió

​
Ampliar o reduir els permisos

No cal concedir tots els permisos en connectar. Quan una petició necessita un permís que no s’ha concedit, el servidor sol·licita a l’aplicació d’IA una nova autorització: la pàgina d’autorització s’obre amb el permís addicional sol·licitat i, després de marcar-lo i tornar a introduir la clau d’API, la petició continua. Si l’aplicació no mostra aquesta sol·licitud, desconnecta el connector i torna’l a connectar marcant el permís necessari. Per reduir els permisos, desconnecta el connector a l’aplicació d’IA i torna’l a connectar amb menys permisos marcats.

​
Revocar l’accés

Per tallar l’accés completament, revoca o elimina la clau d’API a Configuració → Organització → Claus d’API. Totes les connexions que utilitzen aquesta clau deixen de funcionar.

​
Durada de la connexió

La connexió es renova de manera automàtica mentre s’utilitza: cada renovació la manté activa durant 30 dies més. Cal tornar a connectar en els casos següents:
  • La connexió no s’ha utilitzat durant 30 dies.
  • La clau d’API ha caducat. Una connexió no dura mai més que la seva clau.
  • La clau d’API s’ha revocat.

​
Límits d’ús

Cada connexió pot fer, per minut, fins a:
  • 60 consultes.
  • 30 canvis d’escriptura o administració.
  • 5 operacions en dispositius, inclosos els canvis en fluxos i programacions.
A més, l’API de Flexxible limita el nombre de sol·licituds per clau d’API. Aquest límit és compartit per totes les connexions que utilitzen la mateixa clau.

​
Resolució de problemes

​
Bones pràctiques

  • Crea una clau d’API específica per a l’assistent, amb el rol mínim necessari i una durada limitada.
  • Concedeix només els permisos necessaris i amplia’ls quan calgui.
  • Revisa amb atenció les accions que proposa l’assistent abans de confirmar-les, especialment les operacions en dispositius.
  • Revoca la clau d’API quan es deixi d’utilitzar o si hi ha la sospita que s’ha vist compromesa.