search_assetsRecherchez dans la photothèque en langage naturel. Classement hybride plein texte et sémantique, filtres à base de règles en option.
Développeurs · Serveur MCP
Connectez votre photothèque à un agent IA
Freedam intègre un serveur Model Context Protocol. Ses onze outils permettent aux agents de rechercher, organiser, importer, partager et modifier des médias, avec les mêmes tokens à droits limités et le même journal d'audit que le reste de l'API.
Qu'est-ce que MCP
Une méthode standard pour qu'un agent appelle des outils externes
Le Model Context Protocol est un standard ouvert qui décrit des outils, des ressources et des prompts à un client IA de sorte qu'un modèle de langage puisse les appeler en toute sécurité. Choisissez un client compatible MCP, pointez-le vers le serveur Freedam, donnez-lui un token, et l'agent peut travailler avec votre photothèque.
Comme le serveur fonctionne à l'intérieur du produit, chaque appel d'outil respecte le même modèle de permissions qu'un utilisateur humain. Un token en lecture seule ne peut pas supprimer un média, quoi que demande le prompt.
Exemple de configuration client
// Example MCP client configuration
{
"mcpServers": {
"freedam": {
"url": "https://{workspace}.freedam.io/mcp/freedam",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Onze outils
Chaque outil correspond à une fonction normale de l'API, avec une entrée validée par un schéma. Il n'existe aucun endpoint privé ou réservé aux agents.
get_assetRécupérez un média par son identifiant global. Renvoie les métadonnées, les conversions et les droits.
update_asset_metadataModifiez les titres, les descriptions, les mots-clés, les champs IA et les métadonnées structurées, avec validation.
list_collectionsParcourez les collections par nom, par parent ou uniquement les racines. Résultats paginés.
create_collectionCréez une collection, éventuellement sous un parent et avec un type choisi.
add_to_collectionAjoutez une liste de médias à une collection existante en un seul appel.
upload_assetsOuvrez un lot d'import et envoyez-y des fichiers en streaming. Chaque lot peut recevoir une collection de destination.
get_operation_statusInterrogez une opération de longue durée et lisez sa progression, ses erreurs et le décompte de ses résultats.
create_shareGénérez un lien de partage pour un média ou une collection, avec expiration, filigrane et contrôle d'accès.
get_vocabulariesLisez les vocabulaires contrôlés et leurs termes. Utile quand un agent doit choisir des valeurs valides.
bulk_updateAppliquez un ensemble de modifications de champs à de nombreux médias à la fois et suivez le résultat via une opération.
Les mêmes tokens à droits limités
Le serveur MCP utilise le même système de tokens que l'API REST. Créez un token avec les droits dont l'agent a besoin, et rien de plus.
Le même journal d'audit
Chaque appel d'outil est enregistré dans le même journal d'audit qu'une action humaine, avec le token, l'heure et le média concerné.
Les mêmes limites de débit
Les limites de débit des tokens s'appliquent aussi aux appels MCP. Un agent bloqué dans une boucle atteint la même limite qu'un script.
Cas d'usage
Ce que font couramment les équipes une fois le serveur MCP connecté.
Confier le tri à un agent
Laissez un modèle de langage traiter un nouveau lot d'import : supprimer les doublons, compléter les métadonnées manquantes et proposer des collections, le tout par des appels d'outils à droits limités.
Une recherche conversationnelle pour les équipes non techniques
Connectez l'assistant de chat de votre équipe à la photothèque. Le marketing demande « les photos produit du printemps 2025 sur fond crème » ; l'agent recherche, lit et partage.
Des workflows de publication agentiques
Un agent planificateur choisit les médias, un agent rédacteur écrit les légendes, un agent relecteur applique la checklist de la marque, tous avec le même serveur MCP.
Développeurs · MCP
Donnez à vos agents un accès sûr à votre photothèque
Créez un token et pointez votre client compatible MCP vers le serveur. Le modèle peut alors travailler dans les limites des permissions que vous définissez.