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

# Connectar els teus propis agents

> Com connectar Claude, Cursor, Copilot o qualsevol client MCP a Flexxible KB amb una clau d'agent, i què poden fer a través del servidor MCP i de l'API REST.

A més dels agents de Flexxible Assist, pots connectar a la base de coneixement els teus propis agents d'IA: Claude, Cursor, GitHub Copilot a VS Code o qualsevol client compatible amb MCP. Un agent connectat cerca, llegeix i escriu pàgines igual que Teammate, i tot el que fa queda registrat.

> [!NOTE]
>
> Aquesta pàgina tracta del servidor MCP de Flexxible KB, que dona accés a la base de coneixement. El [servidor MCP de Flexxible](https://docs.flexxible.com/ca/features/integrations/mcp.md), que dona accés a workspaces, sessions i operacions de la plataforma, és un servei diferent, amb una altra adreça i una altra autorització.

## Com funciona

* **Un agent és una identitat de la teva organització.** El crees a **Configuració** → **Agents**, amb un nom, com ara "Claude Code".
* **Cada agent té les seves claus.** Una clau per cada lloc on s'executa, per poder-les revocar d'una en una.
* **La clau s'envia com a token Bearer.** El que tingui la clau actua com aquest agent a la teva organització.
* **Tot queda al seu nom.** Els seus canvis apareixen a l'Historial amb el nom de l'agent, i les seves crides a **Activitat**.

Només els propietaris i els administradors creen agents i gestionen les seves claus.

## Crear un agent i la seva clau

**1. Crea l'agent**

A **Configuració** → **Agents**, sota **Els teus agents**, selecciona **Agent nou**, posa-li un nom i selecciona **Crea l'agent**.

**2. Crea una clau**

Obre l'agent, selecciona **Clau nova** i posa-li el nom del lloc on s'utilitzarà, per exemple "Claude al portàtil de la Marta". Selecciona **Crea la clau**.

**3. Copia la clau**

Copia la clau en aquell moment: no es torna a mostrar. **Copia per a Claude Code** copia directament l'ordre de configuració amb la clau inclosa.

> [!WARNING]
>
> Tracta una clau d'agent com una contrasenya. No l'enganxis en una conversa amb l'assistent, en una pàgina ni en un repositori. Si es filtra, revoca-la des de l'agent: el que la utilitzi deixarà de funcionar al moment.

## Adreces

Les adreces de la teva organització es mostren a **Configuració** → **Agents** → **Connecta un agent**, amb un botó per copiar cadascuna.

| Què | Adreça |
| - | - |
| Servidor MCP | `https://kb.flexxible.com/mcp` |
| API REST | `https://kb.flexxible.com/api/v1` |
| Especificació OpenAPI | `https://kb.flexxible.com/api/v1/openapi.json` |
| Guia per a agents | `https://kb.flexxible.com/llms.txt` |

En tots els casos, la clau s'envia a la capçalera `Authorization: Bearer <clave de agente>`.

![Secció Connecta un agent de la configuració: adreces del servidor MCP i de l'API REST, i la configuració per a Claude Code, Claude Desktop, Cursor, VS Code i curl.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-connect-agent.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=ec9ca24b43028f38e1e41f1f69d4cd48)

## Configurar el client

La secció **Com connectar** de la configuració ofereix la configuració a punt per copiar. Substitueix `<clave de agente>` per la teva clau.

> [tab] Claude Code
>
> Executa l'ordre en un terminal. Afegeix `--scope user` per tenir-lo a tots els projectes.
>
> ```bash theme={null}
> claude mcp add --transport http flx-kb https://kb.flexxible.com/mcp --header "Authorization: Bearer <clave de agente>"
> ```

> [tab] Claude Desktop
>
> A **Customize** → **Connectors** → **Add custom connector**, escriu l'adreça del servidor MCP, tria **No sign-in** i, a **Request headers**, afegeix la capçalera `authorization` amb el valor `Bearer <clave de agente>`.
>
> Si no veus la secció **Request headers**, afegeix el servidor al fitxer `claude_desktop_config.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "flx-kb": {
>       "command": "npx",
>       "args": [
>         "-y",
>         "mcp-remote@0.15.2",
>         "https://kb.flexxible.com/mcp",
>         "--header",
>         "Authorization:${AUTH_HEADER}"
>       ],
>       "env": {
>         "AUTH_HEADER": "Bearer <clave de agente>"
>       }
>     }
>   }
> }
> ```

> [tab] Cursor
>
> Afegeix-lo a `.cursor/mcp.json` al projecte, o a `~/.cursor/mcp.json` per a tots els projectes. Posa la clau a la variable d'entorn `FLX_KB_KEY` del teu shell, de manera que no quedi al fitxer.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "flx-kb": {
>       "url": "https://kb.flexxible.com/mcp",
>       "headers": {
>         "Authorization": "Bearer ${env:FLX_KB_KEY}"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Afegeix-lo a `.vscode/mcp.json` al projecte. VS Code demana la clau una vegada i la desa de manera segura.
>
> ```json theme={null}
> {
>   "inputs": [
>     {
>       "type": "promptString",
>       "id": "flx-kb-key",
>       "description": "FLX KB agent key",
>       "password": true
>     }
>   ],
>   "servers": {
>     "flx-kb": {
>       "type": "http",
>       "url": "https://kb.flexxible.com/mcp",
>       "headers": {
>         "Authorization": "Bearer ${input:flx-kb-key}"
>       }
>     }
>   }
> }
> ```

> [tab] curl
>
> L'API REST: cerca i, després, llegeix una pàgina com a Markdown.
>
> ```bash theme={null}
> curl "https://kb.flexxible.com/api/v1/search?q=vpn" -H "Authorization: Bearer <clave de agente>"
> curl "https://kb.flexxible.com/api/v1/pages/vpn.md" -H "Authorization: Bearer <clave de agente>"
> ```

Un cop connectat, prova amb una pregunta com ara: *"Quin client de VPN utilitzem? Cerca-ho a flx-kb."*

## Eines del servidor MCP

El servidor MCP publica eines amb noms i descripcions pensats per a models d'IA, i inclou instruccions sobre com utilitzar-les.

| Àrea | Eines | Què permeten |
| - | - | - |
| Cercar i llegir | `kb_search`, `kb_fetch`, `kb_list_pages`, `kb_page_tree`, `kb_list_spaces` | Cercar per significat i per paraules, llegir una pàgina com a Markdown i recórrer l'arbre i els espais. |
| Canvis | `kb_page_history`, `kb_recent_changes`, `kb_undo_change` | Consultar l'historial d'una pàgina i els últims canvis, i desfer un canvi. |
| Escriure | `kb_create_page`, `kb_edit_page` | Crear una pàgina, editar-la amb canvis precisos, canviar-ne el títol o moure-la. |
| Comentaris | `kb_list_comments`, `kb_comment`, `kb_resolve_comment` | Llegir els comentaris d'una pàgina, comentar, i resoldre o tornar a obrir un fil. |
| Diagrames | `kb_list_diagrams`, `kb_read_diagram`, `kb_create_diagram`, `kb_draw_diagram`, `kb_edit_diagram`, `kb_duplicate_diagram`, `kb_diagram_history`, `kb_restore_diagram` | Llegir, dibuixar, modificar i restaurar diagrames. |
| Caixa forta | `kb_list_credentials` | Consultar els noms, els hosts i els usuaris de les credencials. Mai els seus valors. |
| Compartir | `kb_share_page` | Canviar amb quines organitzacions es comparteix una pàgina. |
| Validació | `kb_mark_ready_for_review` | Marcar una pàgina com a llesta per revisar. |
| Icones | `kb_list_icons` | Consultar les icones pròpies de l'organització. |

L'API REST ofereix les mateixes operacions. L'especificació OpenAPI les descriu totes.

## Regles per als agents

Les mateixes regles s'apliquen a qualsevol agent, tant si és de Flexxible Assist com si és teu:

* **Mai no obtenen el valor d'una credencial.** Veuen noms, tipus, hosts i usuaris, i poden enllaçar una credencial en una pàgina.
* **No poden escriure secrets.** Tota escriptura passa per un detector de secrets. Si afegeix una contrasenya, un token o una clau, es rebutja amb la indicació d'utilitzar la Caixa forta.
* **Editen, no reescriuen.** Els canvis s'envien com a substitucions exactes de text sobre la pàgina tal com és, de manera que una persona que estigui editant la mateixa pàgina conserva la seva feina. Si algú ha canviat el mateix text mentrestant, l'escriptura es rebutja i l'agent ha de tornar a llegir la pàgina.
* **Poden desfer els seus propis errors.** Un agent no pot desfer el canvi que va crear una pàgina, perquè equivaldria a eliminar-la.
* **Només validen les persones.** Un agent pot marcar una pàgina com a llesta per revisar, però no validar-la.
* **Només accedeixen a la teva organització.** Una clau dona accés a les pàgines de la teva organització i a les que altres organitzacions hi comparteixen, que són de només lectura.

## Gestionar agents i claus

Obre un agent a **Configuració** → **Agents** per veure'n les claus, amb la data de creació i d'últim ús de cadascuna.

* **Revoca** invalida una clau al moment.
* **Elimina l'agent** invalida totes les seves claus. Les seves edicions es queden a l'Historial.
* **Activitat** mostra cada crida de l'agent i amb quina clau es va fer. Consulta [Activitat dels agents](https://docs.flexxible.com/ca/features/flexxible-kb/assist-agents.md#actividad-de-los-agentes).

## Següents passos

* [Agents de Flexxible Assist](https://docs.flexxible.com/ca/features/flexxible-kb/assist-agents.md)
* [Caixa forta](https://docs.flexxible.com/ca/features/flexxible-kb/vault.md)
* [Servidor MCP de Flexxible](https://docs.flexxible.com/ca/features/integrations/mcp.md)
