search_assetsBusca en la biblioteca con lenguaje natural. Clasificación híbrida de texto completo y semántica, con filtros basados en reglas opcionales.
Desarrolladores · Servidor MCP
Conecta tu biblioteca con un agente de IA
Freedam incluye un servidor Model Context Protocol integrado. Sus once herramientas permiten a los agentes buscar, organizar, importar, compartir y actualizar recursos, con los mismos tokens con permisos limitados y el mismo registro de auditoría que el resto de la API.
Qué es MCP
Una forma estándar de que un agente llame a herramientas externas
El Model Context Protocol es un estándar abierto para describir herramientas, recursos y prompts a un cliente de IA de forma que un modelo de lenguaje pueda llamarlos de manera segura. Elige un cliente compatible con MCP, apúntalo al servidor de Freedam, dale un token y el agente podrá trabajar con tu biblioteca.
Como el servidor se ejecuta dentro del producto, cada llamada a una herramienta respeta el mismo modelo de permisos que un usuario humano. Un token con permisos de solo lectura no puede eliminar un recurso, diga lo que diga el prompt.
Ejemplo de configuración del cliente
// Example MCP client configuration
{
"mcpServers": {
"freedam": {
"url": "https://{workspace}.freedam.io/mcp/freedam",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Once herramientas
Cada herramienta corresponde a una capacidad normal de la API, con una entrada validada por esquema. No hay endpoints privados ni exclusivos para agentes.
get_assetObtiene un recurso por su ID global. Devuelve los metadatos, las conversiones y los derechos.
update_asset_metadataEdita títulos, descripciones, palabras clave, campos de IA y metadatos estructurados, con validación.
list_collectionsRecorre las colecciones por nombre, por colección principal o solo las raíces. Con paginación.
create_collectionCrea una colección nueva, opcionalmente dentro de una colección principal y con un tipo elegido.
add_to_collectionAñade una lista de recursos a una colección existente en una sola llamada.
upload_assetsAbre un lote de importación y envía archivos en streaming. A cada lote se le puede asignar una colección de destino.
get_operation_statusConsulta una operación de larga duración y lee su progreso, sus errores y sus recuentos de resultados.
create_shareGenera un enlace compartido para un recurso o una colección, con vencimiento, marca de agua y controles de acceso.
get_vocabulariesLee los vocabularios controlados y sus términos. Útil cuando un agente tiene que elegir valores válidos.
bulk_updateAplica un conjunto de cambios de campos a muchos recursos a la vez y sigue el resultado a través de una operación.
Los mismos tokens con permisos limitados
El servidor MCP usa el mismo sistema de tokens que la API REST. Emite un token con los permisos que necesita el agente, y nada más.
El mismo registro de auditoría
Cada llamada a una herramienta queda registrada en el mismo registro de auditoría que una acción humana, con el token, la hora y el recurso afectado.
Los mismos límites de solicitudes
Los límites de solicitudes de los tokens también se aplican a las llamadas MCP. Un agente atrapado en un bucle alcanza el mismo límite que alcanzaría un script.
Casos de uso
Formas habituales en que los equipos usan el servidor MCP una vez conectado.
Delega la selección de recursos en un agente
Deja que un modelo de lenguaje procese un nuevo lote de importación: eliminar duplicados, completar los metadatos que faltan y sugerir colecciones, todo con llamadas a herramientas con permisos limitados.
Búsqueda conversacional para equipos no técnicos
Conecta el asistente de chat de tu equipo con la biblioteca. Marketing pide «las fotos de producto de primavera 2025 con fondo crema»; el agente busca, lee y comparte.
Flujos de publicación con agentes
Un agente planificador elige los recursos, un agente editor escribe los textos, un agente revisor aplica la lista de control de la marca, todos con el mismo servidor MCP.
Desarrolladores · MCP
Da a tus agentes un acceso seguro a tu biblioteca
Crea un token y apunta tu cliente compatible con MCP al servidor. El modelo podrá trabajar entonces dentro de los permisos que definas.