Introducción
En el artículo anterior, construimos un asistente de IA utilizando el modo de búsqueda con IA integrado de Fess. Sin embargo, esa no es la única forma de aprovechar la IA. Existe un método para utilizar Fess como «herramienta de búsqueda» desde Claude Desktop y otros agentes de IA.
En este artículo, configuraremos Fess como un servidor MCP (Model Context Protocol) y construiremos un entorno en el que las herramientas de IA externas puedan buscar documentos internos de forma transparente.
Público objetivo
Personas interesadas en la integración de agentes de IA con sistemas de búsqueda
Personas que desean comprender el concepto de MCP
Personas que utilizan herramientas de IA como Claude Desktop en sus operaciones empresariales
¿Qué es MCP?
MCP (Model Context Protocol) es un protocolo que permite a las aplicaciones de IA acceder a fuentes de datos y herramientas externas. Permite a los modelos de IA realizar operaciones como «buscar», «leer un archivo» y «llamar a una API» de manera estandarizada.
Al exponer Fess como un servidor MCP, los agentes de IA pueden ejecutar operaciones como «buscar documentos internos» en un contexto natural.
Un cambio de paradigma
La búsqueda tradicional seguía el modelo de «un humano introduce palabras clave y lee los resultados». Con MCP, se hace realidad un nuevo modelo: «un agente de IA busca de forma autonoma, interpreta los resultados y los incorpora en sus respuestas».
Esto representa un cambio de «los humanos buscan» a «la IA busca en nombre de los humanos».
Construcción del servidor MCP de Fess
Instalación del plugin
La funcionalidad del servidor MCP de Fess se proporciona como un plugin webapp.
En el panel de administración, vaya a [Sistema] > [Plugins]
Instale
fess-webapp-mcpReinicie Fess
Funciones proporcionadas por el servidor MCP
El servidor MCP de Fess proporciona las siguientes funciones a los agentes de IA.
Tools
search: Búsqueda de texto completo en documentos internos
get_index_stats: Obtención del número de documentos del índice e información de memoria JVM
Los agentes de IA pueden invocar estas herramientas para buscar en el índice de Fess o verificar el estado del sistema.
Resources
fess://index/stats: Estadísticas del índice (número de documentos, información de configuración, memoria JVM)
Prompts
basic_search: Generación de consultas de búsqueda básicas
advanced_search: Generación de consultas de búsqueda detalladas que incluyen orden de clasificación y número de resultados
Integración con Claude Desktop
Configuración de Claude Desktop
Para conectar el servidor MCP de Fess a Claude Desktop, agregue la información del servidor MCP al archivo de configuración de Claude Desktop.
Agregue la siguiente configuración al archivo de configuración (claude_desktop_config.json).
Ejemplos de uso
Una vez que Fess está conectado como servidor MCP en Claude Desktop, se hacen posibles interacciones como las siguientes.
Ejemplo 1: Búsqueda de documentos internos
Usuario: «Por favor, infórmeme sobre el procedimiento de reembolso de gastos de viaje de negocios.»
Claude: (Invoca la herramienta de búsqueda de Fess) He buscado en los documentos internos sobre el reembolso de gastos de viaje de negocios. El procedimiento de reembolso es el siguiente: 1. Crear un informe de viaje de negocios… [Del Manual de Reembolso de Gastos de Viaje (portal/manual/travel-expense.html)]
Ejemplo 2: Investigación cruzada de documentos
Usuario: «Por favor, resuma las disposiciones sobre contraseñas en nuestra política de seguridad.»
Claude: (Busca en Fess «contraseña política de seguridad» e integra múltiples resultados) Las disposiciones sobre contraseñas están documentadas en los siguientes documentos: - Política Básica de Seguridad de la Información: Las contraseñas deben tener al menos 12 caracteres… - Reglamento de Gestión de Cuentas: Deben cambiarse cada 90 días… - Reglamento de Acceso Remoto: La autenticación multifactor es obligatoria…
Los agentes de IA interpretan los resultados de búsqueda y generan respuestas que integran información de múltiples documentos.
Integración con otras herramientas de IA
Dado que MCP es un protocolo estándar, Fess puede utilizarse desde herramientas de IA compatibles con MCP distintas de Claude Desktop.
Uso desde agentes de IA personalizados
También es posible conectarse a Fess mediante el protocolo MCP desde agentes de IA desarrollados internamente. Puede invocar la funcionalidad de búsqueda de Fess programáticamente utilizando bibliotecas cliente de MCP.
Consideraciones de seguridad
A continuación se presentan las consideraciones de seguridad al exponer el servidor MCP.
Control de acceso
Restrinja el acceso al servidor MCP solo a clientes de confianza
Restricciones a nivel de red (firewall, VPN)
Autenticación mediante tokens de API
Control de permisos en los resultados de búsqueda
La búsqueda basada en roles de Fess (tratada en la Parte 5) también se aplica a las búsquedas a través de MCP. Al asociar roles con tokens de API, puede controlar el alcance de los documentos a los que los agentes de IA pueden acceder.
Manejo de datos
Al integrar con servicios de IA basados en la nube, tenga en cuenta que el texto de los resultados de búsqueda se envía externamente. Si se incluyen documentos altamente confidenciales, considere la combinación con un LLM local (Ollama) o el filtrado de los resultados de búsqueda.
Resumen
En este artículo, explicamos cómo exponer Fess como un servidor MCP e integrarlo con agentes de IA.
El concepto del protocolo MCP y el paradigma «la IA busca»
Instalación y configuración del plugin fess-webapp-mcp
Ejemplos de integración con Claude Desktop
Consideraciones de seguridad (control de acceso, permisos, manejo de datos)
Al permitir que los agentes de IA accedan directamente al conocimiento interno, las posibilidades de aprovechamiento del conocimiento se amplían significativamente.
En el próximo artículo, trataremos la búsqueda multimodal.