Elium
Busca y lee la base de conocimiento gobernada de Elium de una empresa, con los permisos del usuario autenticado.
Documentación
MCP
Conecta Elium con ChatGPT, Claude o tu propio sistema.
Acerca de
El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los modelos de IA y aplicaciones externas acceder de forma segura a datos contextuales en tiempo real de sistemas conectados. En el contexto de Elium, MCP permite un puente entre tu base de conocimiento y herramientas de IA como ChatGPT u otros asistentes compatibles.
A través de MCP, un asistente de IA puede consultar tu contenido de Elium, por ejemplo, para responder preguntas de usuarios, resumir documentación o proporcionar soporte contextual sin necesidad de copiar o exportar datos manualmente. El acceso se gestiona mediante autenticación OAuth, garantizando que solo usuarios y aplicaciones autorizados puedan recuperar información según sus permisos en Elium.
Cada instancia de Elium expone su endpoint MCP en https://your-platform-name.elium.com/services/mcp, que se puede utilizar para conectar de forma segura el conocimiento de tu plataforma a ecosistemas de IA externos.
Herramientas disponibles
Una vez establecida la conexión, el servidor MCP de Elium expone cinco herramientas de solo lectura que un asistente de IA puede invocar para recuperar información de tu base de conocimiento. Cada herramienta se ejecuta con los permisos del usuario autenticado, por lo que un asistente solo puede acceder al contenido que ese usuario ya tiene permitido ver en Elium.
| Herramienta | Qué hace |
|---|---|
findRelevantArticles | Busca en toda la base de conocimiento por significado. La forma predeterminada de responder una pregunta. |
findSpecificArticles | Busca con filtros: palabras clave, plantilla, espacios, rango de fechas. |
readArticle | Devuelve el contenido completo y los metadatos de un artículo. |
findSpaces | Lista los espacios a los que el usuario puede acceder. |
findTemplates | Lista las plantillas de artículos disponibles. |
findRelevantArticles
Realiza una búsqueda semántica (basada en significado) de toda la base de conocimiento a partir de una pregunta en lenguaje natural y devuelve los artículos más relevantes, ordenados por relevancia. No acepta filtros ni delimitación de alcance. Esta es la herramienta que un asistente utiliza por defecto para responder una pregunta.
Cada resultado incluye el título del artículo, un enlace para abrirlo y un fragmento de contenido coincidente. Los fragmentos también pueden provenir de documentos adjuntos, cuando estos son la mejor coincidencia.
findSpecificArticles
Ejecuta una búsqueda más dirigida, para cuando un asistente necesita filtrar en lugar de ordenar por significado. Admite:
- búsqueda por palabras clave (un resultado debe contener todos los términos proporcionados)
- filtrado por plantilla, por espacios específicos y por rango de fechas
- elección del orden de clasificación
- límite en el número de resultados (10 por defecto, hasta 50)
Esto es útil para solicitudes como "los cinco artículos más recientes creados con la plantilla Política en el espacio de RR. HH.".
readArticle
Recupera el contenido completo de un solo artículo a partir de su identificador, devuelto como Markdown, junto con sus metadatos clave: propietario, espacio, plantilla, etiquetas, atributos personalizados (etiqueta y valor), fecha de revisión o caducidad, estado de aprobación, fecha de la última versión y si el artículo está archivado.
Un asistente normalmente llama a esta herramienta después de una búsqueda, cuando necesita más contexto del que proporciona un fragmento. Utiliza los metadatos para evaluar cuán actual y confiable es el contenido.
Nota: los artículos muy largos (cuerpos de más de aproximadamente 15 000 caracteres) se truncan. En ese caso, se proporciona al asistente un enlace para leer la versión completa en línea.
findSpaces
Lista los espacios a los que el usuario puede acceder. Esto muestra al asistente cómo está organizada la base de conocimiento y devuelve los ID de espacio necesarios para delimitar una búsqueda con findSpecificArticles.
Un filtro de nombre opcional reduce la lista. Coincide en cualquier parte del nombre e ignora mayúsculas y acentos. Omítelo para listar todos los espacios accesibles.
Cada resultado proporciona el espacio y los derechos del usuario en él: si puede publicar contenido, si la publicación es directa o pasa por un flujo de aprobación, su rol y el número de miembros.
Esto es útil como primer paso antes de una búsqueda dirigida, o para solicitudes como "¿en qué espacios puedo publicar?".
findTemplates
Lista las plantillas de artículos (tipos de artículo) disponibles y muestra si cada plantilla es global o está instalada en espacios específicos. Acepta el mismo filtro de nombre opcional que findSpaces.
Esto permite a un asistente encontrar la plantilla adecuada antes de filtrar una búsqueda, para solicitudes como "busca todos los artículos que usan la plantilla FAQ".
Ejemplos en la práctica
Aquí hay algunas cosas que un asistente conectado puede hacer y las herramientas que utiliza entre bastidores.
- "¿Cómo solicito el permiso de paternidad?" Una búsqueda basada en significado (
findRelevantArticles) responde a partir de los artículos de RR. HH. más relevantes, con enlaces. - "Resume las políticas que actualizamos este trimestre." Un filtro por plantilla y rango de fechas (
findSpecificArticles), luego una lectura de cada resultado (readArticle) para resumirlo. - "¿Nuestra política de retención de datos sigue vigente?" Una lectura del artículo (
readArticle), luego una verificación de su fecha de revisión y estado de aprobación antes de responder. - "¿En qué espacios puedo publicar?" Una lista de los espacios del usuario y sus derechos (
findSpaces). - "Encuentra todos los artículos FAQ en el espacio de Soporte." Una consulta de plantilla (
findTemplates), una consulta de espacio (findSpaces) y luego una búsqueda filtrada (findSpecificArticles).
Cada ejemplo se ejecuta con los permisos del propio usuario. El asistente nunca ve contenido que el usuario no pudiera abrir ya en Elium.
Sobre la autenticación
Elium utiliza el protocolo OAuth 2.0 para autenticar y autorizar el acceso al endpoint MCP. OAuth garantiza que las aplicaciones externas solo puedan acceder a los datos de Elium en nombre de usuarios que hayan otorgado permiso explícitamente.
Hay dos formas de configurar la autenticación OAuth para integraciones MCP:
1. Creación manual de cliente OAuth (recomendada)
Los administradores de la plataforma pueden crear manualmente un cliente OAuth directamente en el Panel de administración de Elium. (Hay un tutorial paso a paso justo debajo)
Una vez creado, las credenciales del cliente (ID de cliente y secreto de cliente) se pueden utilizar para autenticarse con el endpoint MCP según el flujo de OAuth 2.0.
Este enfoque brinda a los administradores control total sobre la configuración del cliente y las URL de redirección.
2. Registro dinámico de clientes (DCR)
Opcionalmente, Elium admite el Registro Dinámico de Clientes (DCR).
Cuando DCR está habilitado, los sistemas externos pueden registrarse dinámicamente como clientes OAuth en tu instancia.
Para habilitar DCR, Elium solicitará:
- Un
client_namepara identificar la aplicación externa - Una lista de
redirect_urispermitidos que definen a dónde se redirige a los usuarios después de la autenticación
Solo se aceptan solicitudes que coincidan con las URL de redirección de la lista blanca, lo que garantiza que los tokens de acceso se emitan de forma segura a aplicaciones legítimas.
Esta opción está disponible bajo demanda y se puede solicitar simplemente en support@elium.com
Aunque este mecanismo es seguro en uso estándar, recomendamos permitir solo URL de redirección de confianza para reducir los riesgos de ataques.
Recomendación
Para integraciones de terceros o experimentales, recomendamos utilizar la creación manual de cliente OAuth para un control administrativo más estricto.
Instrucciones de configuración
Selecciona la sección de tu aplicación para obtener instrucciones detalladas de configuración.
ChatGPT
⚠️ MCP personalizado aún está en desarrollo en ChatGPT.
Paso 1: crea la aplicación conectada de ChatGPT en Elium
- Nombre: ChatGPT
- URL de redirección: https://chatgpt.com/connector_platform_oauth_redirect

Paso 2: agrega el conector personalizado a ChatGPT
Es posible que necesites activar el modo Desarrollador para hacer esto (en la sección Conectores).
Haz clic en "Configuración avanzada" y luego activa el modo Desarrollador.


Vuelve a la pantalla de Conectar y haz clic en "Crear".

La URL del servidor MCP de Elium es: https:// nombre-de-tu-plataforma.elium.com/services/mcp
Selecciona "OAuth" en el menú desplegable de autenticación.

Acepta la conexión.

Ahora puedes buscar en tu plataforma Elium directamente desde ChatGPT.
Claude
Paso 1: crea la aplicación conectada de Claude en Elium
- Nombre: Claude
- URL de redirección: https://claude.ai/api/mcp/auth_callback

Paso 2: agrega el conector personalizado a Claude
La URL del servidor MCP de Elium es: https:// nombre-de-tu-plataforma.elium.com/services/mcp

Usa el ID de cliente y el secreto de la aplicación conectada de Elium.

Paso 3: actívalo en la conversación

Ahora puedes buscar en Elium desde tu conversación de Claude.
