> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

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](https://mintcdn.com/flexxible/oSiN5oYVpjTv7FuO/images/features/mcp-diagram.png?fit=max\&auto=format\&n=oSiN5oYVpjTv7FuO\&q=85\&s=82d7537248e895dcf8ba87125526ab8b)

## Com funciona el servidor MCP de Flexxible

El servidor MCP de Flexxible està disponible a l'adreça següent:

```
https://mcp.flexxible.net/mcp
```

Les seves característiques principals són:

* **Basat en l'API de Flexxible.** Les operacions de l'[API Gen 2](../../api-reference/introduction) (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](../integrations/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](#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.

> [!NOTE]
>
> 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.

| Permís | Permet a l'assistent |
| :- | :- |
| **Lectura** (sempre inclòs) | Consultar workspaces, sessions, grups, fluxos, informes, usuaris i la resta de la informació de les organitzacions. No modifica res. |
| **Escriptura** | Modificar la configuració: crear, editar i eliminar grups de workspaces i els seus membres, grups de reporte, grups de processos d'Activitat Digital, ubicacions, xarxes i xarxes sense fil. També eliminar fluxos i programacions. |
| **Administració** | Gestionar usuaris, rols i tenants, crear enllaços màgics de descàrrega de FlexxAgent i eliminar registres de workspaces d'un en un. |
| **Operacions en dispositius** | Actuar sobre els dispositius, immediatament o de manera programada: reiniciar o apagar workspaces, desconnectar o tancar sessions, enviar missatges emergents i notificacions, executar microserveis, controlar serveis de Windows, actualitzar FlexxAgent, canviar el grup de reporte d'un workspace, eliminar workspaces en bloc i crear o modificar fluxos i programacions. |

> [!WARNING]
>
> 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.

> [!NOTE]
>
> 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`).

| Ruta | Contingut |
| :- | :- |
| `/mcp` | Totes les eines. |
| `/mcp/devices` | Workspaces: inventari, estat, alertes i historial d'alertes, discos, pegats, serveis, esdeveniments Plug and Play, GPO, aplicacions instal·lades, sessions d'usuari i registres de connexió. |
| `/mcp/workspace-groups` | Grups de workspaces, els seus membres i les seves programacions (encesa, apagada i reinici). |
| `/mcp/reporting-groups` | Grups de reporte, informes mensuals, versions de FlexxAgent i enllaços màgics, destinacions de les polítiques de pegats i configuracions de producte. |
| `/mcp/automation` | Fluxos, microserveis, operacions i els seus resultats. |
| `/mcp/operations` | Accions sobre workspaces i sessions (reiniciar, apagar, tancar sessió, missatges emergents i notificacions, actualitzar FlexxAgent, executar microserveis, etc.), operacions i els seus resultats, i notificacions. |
| `/mcp/digital-activity` | Grups de processos d'Activitat Digital i els seus processos. |
| `/mcp/network` | Ubicacions, xarxes, xarxes sense fil i els dispositius que hi estan connectats. |
| `/mcp/admin` | Usuaris, rols, tenants, auditoria, límits de l'organització i configuracions de producte. |

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](https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/api-3.png?fit=max\&auto=format\&n=SlGXA3JTqSPrj5Ic\&q=85\&s=03303071e39a57343ae377d57b008ce0)

* **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.

5. Fes clic a **Desar** i copia la clau.

> [!TIP]
>
> 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.

> [!WARNING]
>
> 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](#connectar-claude) i [Connectar ChatGPT](#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](https://mintcdn.com/flexxible/oSiN5oYVpjTv7FuO/images/features/mcp-consent-step1.png?fit=max\&auto=format\&n=oSiN5oYVpjTv7FuO\&q=85\&s=193b5713189a3c1dbae6116589819fb1)

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](https://mintcdn.com/flexxible/oSiN5oYVpjTv7FuO/images/features/mcp-consent-step2.png?fit=max\&auto=format\&n=oSiN5oYVpjTv7FuO\&q=85\&s=2e3cdc2236be3138f850a59dda6756c7)

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.

> [!NOTE]
>
> 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ó](#connectar-un-assistent-dia). 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**.

> [!TIP]
>
> 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](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

## 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.

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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ó.

> [!NOTE]
>
> 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](https://help.openai.com/en/articles/12584461).

## 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ó?"

> [!NOTE]
>
> 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](../traceability/operations), 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

| Problema | Solució |
| :- | :- |
| **No s'ha reconegut aquesta clau d'API** a la pàgina d'autorització. | Copia de nou la clau completa des de la plataforma, sense espais ni salts de línia. Comprova que és una clau de l'API Gen 2 i que no s'ha revocat. |
| **Aquesta clau d'API ha caducat** a la pàgina d'autorització. | Crea una nova clau d'API i utilitza-la. |
| **Aquesta pàgina ha caducat, ja s'ha utilitzat o s'ha obert en un altre navegador.** | Inicia de nou la connexió des de l'aplicació d'IA i completa-la al mateix navegador. |
| **Massa intents** a la pàgina d'autorització. | Espera un minut i torna-ho a provar. |
| L'assistent indica que la clau d'API s'ha rebutjat. | La clau pot haver caducat o haver estat revocada. Desconnecta el connector i torna'l a connectar amb una clau vàlida. |
| El connector deixa de funcionar al cap d'un temps. | La connexió caduca després de 30 dies sense ús i sempre que caduca la seva clau d'API. Torna a connectar, amb una clau nova si l'anterior ha caducat. |
| L'assistent indica que s'ha arribat a un límit d'ús. | Espera aproximadament un minut. Si el límit és el de l'API de Flexxible, acota la petició a una sola organització o a menys elements. |
| L'assistent indica que una organització no pertany a l'arbre de la clau d'API. | L'organització no és un tenant de l'organització de la clau. Demana a l'assistent que llisti les organitzacions accessibles i comprova que s'està utilitzant la clau correcta. |
| L'assistent indica que falta un permís. | Aprova la nova autorització que ofereix l'aplicació d'IA, o desconnecta i torna a connectar marcant el permís necessari. |
| Una petició es rebutja encara que el permís està concedit. | El rol de la clau d'API no permet aquesta acció. Sol·licita a l'administrador de l'organització una clau amb un rol adequat. |
| Una operació s'ha acceptat, però no sembla tenir efecte. | Les operacions s'executen de manera asíncrona. Demana a l'assistent l'estat de l'operació: els resultats arriben per dispositiu a mesura que FlexxAgent els notifica. |

## 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.
