Saltar al contingut principal
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.
Aquesta pàgina tracta del servidor MCP de Flexxible KB, que dona accés a la base de coneixement. El servidor MCP de Flexxible, 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.
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. 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.

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.
Executa l’ordre en un terminal. Afegeix --scope user per tenir-lo a tots els projectes.
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. 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.

Següents passos