MCP para agentes de IA (Claude, ChatGPT y más)
Conectar un asistente de IA a freedam significa que puede trabajar de verdad en tu biblioteca, y no solo hablar de ella. En lugar de copiar y pegar nombres de archivo en una ventana de chat, conectas Claude, ChatGPT o cualquier asistente compatible con el Model Context Protocol (MCP, el estándar abierto para dar a las herramientas de IA acceso a otro software), y puede buscar, obtener, importar, organizar y compartir recursos en tu nombre.
Qué hace
freedam incluye su propia conexión MCP de serie. No hay nada adicional que instalar ni ejecutar: forma parte del producto y está disponible en tu instancia. Con ella, un asistente puede:
- Buscar en la biblioteca con lenguaje natural, la misma búsqueda inteligente que usa el resto de las personas
- Consultar un recurso con sus metadatos, vistas previas y derechos de uso
- Editar metadatos: títulos, descripciones, palabras clave y campos estructurados, con la misma validación que en el resto del producto
- Explorar y crear colecciones, incluidas las anidadas, y archivar recursos en ellas
- Importar archivos, opcionalmente directamente en una colección elegida
- Crear enlaces para compartir con fechas de caducidad y controles de acceso
- Usar tus vocabularios aprobados, para que elija términos válidos en lugar de inventar los suyos
- Ejecutar cambios en bloque sobre muchos recursos a la vez e informar de su avance
Eso cubre flujos de trabajo reales: un asistente puede revisar un lote de importación reciente, completar los metadatos que faltan con tus vocabularios, clasificar los recursos en colecciones y devolverte un enlace para compartir cuando termine. No hay poderes especiales exclusivos de la IA: todo lo que un asistente puede hacer es algo que el producto ya permite.
Cómo funciona
Creas un token de API en Ajustes → Tokens de API, eligiendo exactamente lo que el asistente puede hacer, y luego pegas la dirección de tu instancia y el token en los ajustes de tu asistente:
{
"mcpServers": {
"freedam": {
"url": "https://your-instance.example.com/mcp/freedam",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
Lo importante: el asistente pasa por las mismas comprobaciones de permisos que una persona usuaria. A un token que solo puede leer la biblioteca no se le puede convencer de que elimine un recurso, por muy ingenioso que sea el mensaje. Y cada acción queda en el mismo registro de auditoría que todo lo demás, así que siempre puedes ver qué token hizo qué, cuándo y en qué recurso.
Conviene saber
- Los permisos se aplican en cada acción. Un token nunca puede tener más poder que la persona que lo creó, y la falta de un permiso significa una acción rechazada, no un rodeo silencioso.
- Se aplican límites de velocidad. Un asistente trabaja dentro de los mismos límites por token que cualquier otra integración, de modo que un bucle descontrolado choca con un tope en lugar de afectar a tu biblioteca.
- Los tokens se muestran una sola vez. Copia el token cuando lo crees; freedam solo conserva una huella. Si lo pierdes, revócalo y crea uno nuevo.
- Las instancias autoalojadas tienen la misma conexión: forma parte del producto, no es un complemento alojado.
La conexión MCP se apoya en la misma base que la API REST, así que lo que empiece un asistente, lo puede terminar un script. ¿Quieres verlo trabajar con una biblioteca real? Prueba la demostración.