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

# Conectar tus propios agentes

> Cómo conectar Claude, Cursor, Copilot o cualquier cliente MCP a Flexxible KB con una clave de agente, y qué pueden hacer a través del servidor MCP y de la API REST.

Además de los agentes de Flexxible Assist, puedes conectar a la base de conocimiento tus propios agentes de IA: Claude, Cursor, GitHub Copilot en VS Code o cualquier cliente compatible con MCP. Un agente conectado busca, lee y escribe páginas igual que Teammate, y todo lo que hace queda registrado.

> [!NOTE]
>
> Esta página trata del servidor MCP de Flexxible KB, que da acceso a la base de conocimiento. El [servidor MCP de Flexxible](https://docs.flexxible.com/features/integrations/mcp.md), que da acceso a workspaces, sesiones y operaciones de la plataforma, es un servicio distinto, con otra dirección y otra autorización.

## Cómo funciona

* **Un agente es una identidad de tu organización.** Lo creas en **Ajustes** → **Agentes**, con un nombre, como "Claude Code".
* **Cada agente tiene sus claves.** Una clave por cada sitio en el que se ejecuta, para poder revocarlas de una en una.
* **La clave se envía como token Bearer.** Lo que tenga la clave actúa como ese agente en tu organización.
* **Todo queda a su nombre.** Sus cambios aparecen en el Historial con el nombre del agente, y sus llamadas en **Actividad**.

Solo los propietarios y los administradores crean agentes y gestionan sus claves.

## Crear un agente y su clave

**1. Crea el agente**

En **Ajustes** → **Agentes**, bajo **Tus agentes**, selecciona **Nuevo agente**, ponle un nombre y selecciona **Crear agente**.

**2. Crea una clave**

Abre el agente, selecciona **Nueva clave** y ponle el nombre del sitio en el que se va a usar, por ejemplo "Claude en el portátil de Marta". Selecciona **Crear clave**.

**3. Copia la clave**

Copia la clave en ese momento: no se vuelve a mostrar. **Copiar para Claude Code** copia directamente el comando de configuración con la clave incluida.

> [!WARNING]
>
> Trata una clave de agente como una contraseña. No la pegues en una conversación con el asistente, en una página ni en un repositorio. Si se filtra, revócala desde el agente: lo que la use dejará de funcionar al momento.

## Direcciones

Las direcciones de tu organización se muestran en **Ajustes** → **Agentes** → **Conectar un agente**, con un botón para copiar cada una.

| Qué | Dirección |
| - | - |
| Servidor MCP | `https://kb.flexxible.com/mcp` |
| API REST | `https://kb.flexxible.com/api/v1` |
| Especificación OpenAPI | `https://kb.flexxible.com/api/v1/openapi.json` |
| Guía para agentes | `https://kb.flexxible.com/llms.txt` |

En todos los casos, la clave se envía en la cabecera `Authorization: Bearer <clave de agente>`.

![Sección Conectar un agente de los ajustes: direcciones del servidor MCP y de la API REST, y la configuración para Claude Code, Claude Desktop, Cursor, VS Code y curl.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-connect-agent.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=ec9ca24b43028f38e1e41f1f69d4cd48)

## Configurar el cliente

La sección **Cómo conectar** de los ajustes ofrece la configuración lista para copiar. Sustituye `<clave de agente>` por tu clave.

> [tab] Claude Code
>
> Ejecuta el comando en un terminal. Añade `--scope user` para tenerlo en todos los proyectos.
>
> ```bash theme={null}
> claude mcp add --transport http flx-kb https://kb.flexxible.com/mcp --header "Authorization: Bearer <clave de agente>"
> ```

> [tab] Claude Desktop
>
> En **Customize** → **Connectors** → **Add custom connector**, escribe la dirección del servidor MCP, elige **No sign-in** y, en **Request headers**, añade la cabecera `authorization` con el valor `Bearer <clave de agente>`.
>
> Si no ves la sección **Request headers**, añade el servidor al archivo `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
>
> Añádelo a `.cursor/mcp.json` en el proyecto, o a `~/.cursor/mcp.json` para todos los proyectos. Pon la clave en la variable de entorno `FLX_KB_KEY` de tu shell, de modo que no quede en el archivo.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "flx-kb": {
>       "url": "https://kb.flexxible.com/mcp",
>       "headers": {
>         "Authorization": "Bearer ${env:FLX_KB_KEY}"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Añádelo a `.vscode/mcp.json` en el proyecto. VS Code pide la clave una vez y la guarda de forma 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
>
> La API REST: busca y, después, lee una página como 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>"
> ```

Una vez conectado, prueba con una pregunta como: *"¿Qué cliente de VPN usamos? Búscalo en flx-kb."*

## Herramientas del servidor MCP

El servidor MCP publica herramientas con nombres y descripciones pensados para modelos de IA, e incluye instrucciones sobre cómo utilizarlas.

| Área | Herramientas | Qué permiten |
| - | - | - |
| Buscar y leer | `kb_search`, `kb_fetch`, `kb_list_pages`, `kb_page_tree`, `kb_list_spaces` | Buscar por significado y por palabras, leer una página como Markdown y recorrer el árbol y los espacios. |
| Cambios | `kb_page_history`, `kb_recent_changes`, `kb_undo_change` | Consultar el historial de una página y los últimos cambios, y deshacer un cambio. |
| Escribir | `kb_create_page`, `kb_edit_page` | Crear una página, editarla con cambios precisos, cambiar su título o moverla. |
| Comentarios | `kb_list_comments`, `kb_comment`, `kb_resolve_comment` | Leer los comentarios de una página, comentar, y resolver o reabrir un hilo. |
| Diagramas | `kb_list_diagrams`, `kb_read_diagram`, `kb_create_diagram`, `kb_draw_diagram`, `kb_edit_diagram`, `kb_duplicate_diagram`, `kb_diagram_history`, `kb_restore_diagram` | Leer, dibujar, modificar y restaurar diagramas. |
| Bóveda | `kb_list_credentials` | Consultar los nombres, los hosts y los usuarios de las credenciales. Nunca sus valores. |
| Compartir | `kb_share_page` | Cambiar con qué organizaciones se comparte una página. |
| Validación | `kb_mark_ready_for_review` | Marcar una página como lista para revisar. |
| Iconos | `kb_list_icons` | Consultar los iconos propios de la organización. |

La API REST ofrece las mismas operaciones. La especificación OpenAPI las describe todas.

## Reglas para los agentes

Las mismas reglas se aplican a cualquier agente, sea de Flexxible Assist o tuyo:

* **Nunca obtienen el valor de una credencial.** Ven nombres, tipos, hosts y usuarios, y pueden enlazar una credencial en una página.
* **No pueden escribir secretos.** Toda escritura pasa por un detector de secretos. Si añade una contraseña, un token o una clave, se rechaza con la indicación de usar la Bóveda.
* **Editan, no reescriben.** Los cambios se envían como sustituciones exactas de texto sobre la página tal como está, de modo que una persona que esté editando la misma página conserva su trabajo. Si alguien cambió el mismo texto entretanto, la escritura se rechaza y el agente debe volver a leer la página.
* **Pueden deshacer sus propios errores.** Un agente no puede deshacer el cambio que creó una página, porque equivaldría a eliminarla.
* **Solo validan las personas.** Un agente puede marcar una página como lista para revisar, pero no validarla.
* **Solo acceden a tu organización.** Una clave da acceso a las páginas de tu organización y a las que otras organizaciones comparten con ella, que son de solo lectura.

## Gestionar agentes y claves

Abre un agente en **Ajustes** → **Agentes** para ver sus claves, con la fecha de creación y de último uso de cada una.

* **Revocar** invalida una clave al momento.
* **Eliminar agente** invalida todas sus claves. Sus ediciones se quedan en el Historial.
* **Actividad** muestra cada llamada del agente y con qué clave se hizo. Consulta [Actividad de los agentes](https://docs.flexxible.com/features/flexxible-kb/assist-agents.md#actividad-de-los-agentes).

## Siguientes pasos

* [Agentes de Flexxible Assist](https://docs.flexxible.com/features/flexxible-kb/assist-agents.md)
* [Bóveda](https://docs.flexxible.com/features/flexxible-kb/vault.md)
* [Servidor MCP de Flexxible](https://docs.flexxible.com/features/integrations/mcp.md)
