Cloudinary

officiel

Interagissez avec la plateforme de gestion des médias de Cloudinary en langage naturel.

GitHub
10

Que pouvez-vous faire avec Cloudinary MCP ?

  • Téléverser et gérer des médias — Téléversez des images, des vidéos et des fichiers bruts, puis organisez-les à l’aide de dossiers, de tags et de relations entre ressources.
  • Rechercher et transformer des ressources — Recherchez des ressources à l’aide de filtres avancés et appliquez-leur des opérations et des transformations.
  • Générer des images avec l’IA — Créez de nouvelles images à partir de prompts textuels ou d’images de référence, puis enregistrez-les dans votre compte.
  • Analyser le contenu multimédia — Lancez le balisage par IA, la modération, le sous-titrage, la détection d’objets et l’analyse des filigranes ou de la qualité des ressources.
  • Configurer les paramètres de l’environnement — Créez des transformations nommées, des préréglages de téléversement, des profils de diffusion en continu et des déclencheurs de webhook.
  • Gérer les métadonnées structurées — Créez des champs de métadonnées, définissez des règles de validation et gérez les valeurs des sources de données pour les champs de type liste.

Serveur MCP hébergé

npx add-mcp 'https://asset-management.mcp.cloudinary.com/mcp'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

Serveurs MCP Cloudinary

Le Model Context Protocol (MCP) est un nouveau protocole standardisé permettant de gérer le contexte entre les grands modèles de langage (LLM) et les systèmes externes. Ce dépôt fournit des serveurs MCP complets pour la plateforme de gestion des médias Cloudinary, qui vous permettent d’utiliser le langage naturel pour téléverser, générer, transformer, analyser et organiser vos ressources multimédias directement depuis des applications d’IA comme Cursor et Claude.

Avec ces serveurs MCP, vous pouvez gérer facilement l’ensemble de votre flux de travail multimédia grâce à l’IA conversationnelle : téléverser, générer et transformer des images et des vidéos, configurer des pipelines de traitement automatisés, analyser du contenu avec des outils basés sur l’IA et organiser vos ressources à l’aide de métadonnées structurées. Que vous développiez des applications riches en médias, gériez de vastes bibliothèques de ressources ou automatisiez des flux de travail de contenu, ces serveurs vous donnent un accès direct à toute la gamme des fonctionnalités d’optimisation et de gestion des médias de Cloudinary.

Les serveurs MCP suivants sont disponibles pour Cloudinary :

Nom du serveurDescriptionServeur MCP distant
Gestion des ressourcesTéléverser, gérer, rechercher et transformer vos ressources multimédias, et générer de nouvelles images par IA à partir de prompts textuels ou d’images de référenceasset-management
Configuration de l’environnementConfigurer et gérer les paramètres de votre environnement Cloudinary, les préréglages de téléversement et les transformationsenvironment-config
Métadonnées structuréesCréer, gérer et interroger des champs de métadonnées structurées pour améliorer l’organisation et la recherche des ressourcesstructured-metadata
AnalyseExploiter les fonctionnalités d’analyse de contenu, de modération et de balisage automatique par IA pour vos ressources multimédiasanalysis
MediaFlowsCréer et gérer des automatisations de flux de travail low-code pour les images et les vidéos avec l’aide de l’IAmediaflows

Table des matières

Documentation

Pour consulter des guides détaillés, des tutoriels et une documentation complète sur l’utilisation des serveurs MCP de Cloudinary :

Installation

Serveurs MCP distants (recommandé)

Les serveurs MCP distants sont hébergés par Cloudinary et prêts à l’emploi immédiatement. Aucune installation locale n’est nécessaire.

Serveurs MCP locaux

Les serveurs MCP locaux s’exécutent sur votre machine à l’aide de packages npm. Choisissez cette option si vous avez besoin de davantage de contrôle ou de personnalisation.

Remarque : après l’installation, vous devrez configurer vos variables d’environnement (CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET) avec vos identifiants réels.

Images Docker

Les images Docker officielles des serveurs MCP Cloudinary sont disponibles sur Docker Hub. Elles offrent une option de déploiement conteneurisée pour exécuter les serveurs MCP localement ou dans des environnements cloud.

Disponibles sur Docker Hub : Images Docker MCP Cloudinary

Les images Docker offrent plusieurs avantages :

  • Environnements isolés - Exécutez les serveurs MCP dans des conteneurs sans affecter les dépendances de votre système
  • Déploiement facile - Configuration rapide nécessitant un minimum de réglages
  • Environnement d’exécution cohérent - Garantit le même environnement sur différentes machines et plateformes
  • Évolutivité - Déployez facilement plusieurs instances ou intégrez-les à des systèmes d’orchestration de conteneurs

Pour utiliser les images Docker, assurez-vous que Docker est installé sur votre système et transmettez vos identifiants Cloudinary sous forme de variables d’environnement lors du lancement des conteneurs. Consultez la documentation de chaque image Docker sur Docker Hub pour obtenir des instructions d’utilisation spécifiques.

Exemples de configuration

Configuration des serveurs MCP distants

Les serveurs distants sont hébergés par Cloudinary et accessibles via une URL :

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp"
    },
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp"
    },
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
    },
    "cloudinary-analysis-remote": {
      "url": "https://analysis.mcp.cloudinary.com/mcp"
    },
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp"
    }
  }
}

Transport : Les serveurs distants prennent en charge deux points de terminaison — /mcp (Streamable HTTP, recommandé, sans état) et /sse (SSE, obsolète, conservé pour assurer la rétrocompatibilité). Le point de terminaison /sse accepte également les requêtes POST comme alias de /mcp, de sorte que les clients qui envoient du Streamable HTTP à /sse fonctionneront. Utilisez /mcp pour les nouvelles configurations.

Serveurs MCP distants avec authentification

Par défaut, les serveurs MCP distants hébergés par Cloudinary utilisent OAuth2 pour l’authentification. Vous pouvez également vous authentifier à l’aide de clés API transmises dans des en-têtes :

Utilisation de CLOUDINARY_URL (la méthode la plus simple)

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

Utilisation d’en-têtes individuels

{
  "mcpServers": {
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-cloud-name": "your_cloud_name",
        "cloudinary-api-key": "your_api_key",
        "cloudinary-api-secret": "your_api_secret"
      }
    }
  }
}

Avec une configuration personnalisée

{
  "mcpServers": {
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-region": "api-eu",
        "cloudinary-tools": "list-metadata-fields,get-metadata-field,create-metadata-field"
      }
    }
  }
}

Avec des en-têtes de débogage

Pour afficher les en-têtes de limitation du débit de l’API et les identifiants de requête dans les résultats des outils, activez l’intégration des en-têtes :

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-embed-headers": "true"
      }
    }
  }
}

Chaque résultat d’outil inclura un champ _headers contenant des informations sur la limitation du débit et le suivi des requêtes :

{
  "_headers": {
    "x-featureratelimit-limit": "10000",
    "x-featureratelimit-remaining": "9998",
    "x-featureratelimit-reset": "Thu, 13 Feb 2026 00:00:00 GMT",
    "x-request-id": "bfeaccc60050594832508590a358a1a4"
  }
}

Configuration des serveurs MCP locaux

Les serveurs locaux s’exécutent sur votre machine à l’aide de packages npm :

Option 1 : Utilisation de la variable d’environnement CLOUDINARY_URL (recommandé)

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-env-config": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/environment-config-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-smd": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/structured-metadata-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-analysis": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/analysis-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

Option 2 : Utilisation de variables d’environnement individuelles

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "cloud_name",
        "CLOUDINARY_API_KEY": "api_key",
        "CLOUDINARY_API_SECRET": "api_secret"
      }
    }
  }
}

Option 3 : Utilisation d’arguments de ligne de commande

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": [
        "-y", "--package", "@cloudinary/asset-management-mcp",
        "--",
        "mcp", "start",
        "--cloud-name", "cloud_name",
        "--api-key", "api_key",
        "--api-secret", "api_secret"
      ]
    }
  }
}

Configuration du serveur MCP MediaFlows

Pour MediaFlows, utilisez la configuration suivante :

{
  "mcpServers": {
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp",
      "headers": {
        "cld-cloud-name": "cloud_name",
        "cld-api-key": "api_key",
        "cld-secret": "api_secret"
      }
    }
  }
}

Configuration avancée des serveurs locaux

Chaque package npm prend en charge des options de configuration supplémentaires, au-delà des exemples de configuration de base ci-dessus.

Exécution en tant que serveur HTTP

Pour exécuter un serveur MCP local avec le transport Streamable HTTP plutôt qu’avec stdio, utilisez la commande serve :

npx -y --package @cloudinary/asset-management-mcp -- mcp serve

Le serveur écoute sur http://localhost:2718/mcp. Vous pouvez spécifier un port personnalisé :

npx -y --package @cloudinary/asset-management-mcp -- mcp serve --port 3000

Le transport SSE historique reste disponible via mcp start --transport sse (même indicateur --port, valeur par défaut 2718), mais il est obsolète. Utilisez mcp serve pour les nouvelles configurations :

npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse

Options de configuration disponibles

Pour afficher toutes les options de configuration disponibles pour un package :

npx -y --package @cloudinary/asset-management-mcp -- mcp start --help
npx -y --package @cloudinary/asset-management-mcp -- mcp serve --help

Liste complète des indicateurs disponibles (@cloudinary/asset-management-mcp ; les autres packages n’en prennent en charge qu’une partie) :

USAGE
  mcp start [--transport stdio|sse] [--port value] [--tool value]... [--mode dynamic]
            [--tool-annotations value] [--scope admin|builder|librarian]
            [--api-key value] [--api-secret value] [--oauth2 value]
            [--cloud-name value] [--server-url value] [--server-index value]
            [--region api|api-eu|api-ap] [--api-host value] [--mcp-apps value]
            [--log-level debug|warning|info|error] [--env value]...
  mcp serve [--port value] [--disable-static-auth] [--tool value]... [--mode dynamic]
            [--tool-annotations value] [--scope admin|builder|librarian]
            [--api-key value] [--api-secret value] [--oauth2 value]
            [--cloud-name value] [--server-url value] [--server-index value]
            [--region api|api-eu|api-ap] [--api-host value] [--mcp-apps value]
            [--log-level debug|warning|info|error] [--env value]...

COMMANDS
  start  Run the MCP server (stdio by default)
  serve  Run the MCP server with Streamable HTTP transport

FLAGS
  --transport              start only: the transport to use
                           [stdio|sse, default = stdio; sse is deprecated]
  --port                   The port to listen on [default = 2718]
  --disable-static-auth    serve only: disable static authentication, allowing
                           credentials to be passed via request headers only
  --tool...                Specify tools to mount on the server (repeatable)
  --mode                   dynamic: expose list_tools, describe_tool_input, and
                           execute_tool instead of individual tools [dynamic]
  --tool-annotations       Filter tools by annotations (comma-separated:
                           readOnly, destructive, idempotent, openWorld)
  --scope                  Mount tools/resources that match given scope
                           (repeatable) [admin|builder|librarian]
  --api-key                Sets the api_key auth field for the API
  --api-secret             Sets the api_secret auth field for the API
  --oauth2                 Sets the oauth2 auth field for the API
  --cloud-name             Allows setting the cloud_name parameter for all
                           supported operations
  --server-url             Overrides the default server URL used by the SDK
  --server-index           Selects a predefined server used by the SDK
  --region                 Sets the region variable for url substitution
                           [api|api-eu|api-ap]
  --api-host               Sets the host variable for url substitution
  --mcp-apps               Enable MCP Apps (interactive UI): bare flag or
                           all/true, none/false, or a comma-separated list of
                           asset-gallery,asset-details,asset-upload
  --log-level              The log level to use for the server
                           [debug|warning|info|error, default = info]
  --env...                 Environment variables made available to the server
  -h, --help               Print help information and exit

Débogage

Pour déboguer en détail les données utiles du réseau, utilisez la variable d’environnement CLOUDINARY_DEBUG :

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start

Vous pouvez combiner le mode de débogage avec d’autres options pour effectuer un dépannage complet :

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp serve --log-level debug

Remarque : Ces options de configuration s’appliquent à tous les packages MCP locaux :

  • @cloudinary/asset-management-mcp
  • @cloudinary/environment-config-mcp
  • @cloudinary/structured-metadata-mcp
  • @cloudinary/analysis-mcp

Authentification

Lorsque les serveurs MCP sont exécutés localement, l’authentification peut être configurée de plusieurs façons :

Option 1 : Variables d’environnement individuelles (recommandé)

export CLOUDINARY_CLOUD_NAME="cloud_name"
export CLOUDINARY_API_KEY="api_key"
export CLOUDINARY_API_SECRET="api_secret"

Option 2 : Variable d’environnement CLOUDINARY_URL

export CLOUDINARY_URL="cloudinary://api_key:api_secret@cloud_name"

Option 3 : Arguments de ligne de commande

Transmettez directement les identifiants en tant qu’arguments (voir les exemples de configuration ci-dessus)

Vous trouverez vos identifiants Cloudinary dans votre tableau de bord de la console Cloudinary, sous Settings > Security.

Fonctionnalités par serveur

Serveur de gestion des ressources

  • Téléverser et gérer des ressources multimédias (images, vidéos, fichiers bruts)
  • Rechercher et organiser des ressources à l’aide de filtres avancés et de la recherche visuelle
  • Générer de nouvelles images par IA à partir de prompts textuels ou d’images de référence, et les enregistrer directement dans votre compte
  • Effectuer des opérations et des transformations sur les ressources
  • Gérer les dossiers, les balises et les relations entre les ressources
  • Générer des archives et des liens de téléchargement

Serveur de configuration de l’environnement

  • Créer et gérer des transformations nommées et des préréglages de téléversement
  • Gérer les profils de diffusion en continu et les déclencheurs (notifications par webhook)
  • Configurer des mappages de téléversement

Serveur de métadonnées structurées

  • Créer et gérer des champs de métadonnées structurées
  • Configurer des règles conditionnelles de métadonnées et la validation
  • Gérer les valeurs des sources de données pour les champs de métadonnées de type liste
  • Organiser et rechercher les configurations de métadonnées

Serveur d’analyse

  • Analyse de contenu par IA, notamment balisage, modération et génération de légendes
  • Détection et reconnaissance d’objets à l’aide de plusieurs modèles d’IA
  • Analyse de la qualité des images et détection des filigranes
  • Modération du contenu et analyse de sécurité
  • Fonctionnalités de détection de mode, de texte et d’anatomie
  • Détection de logos et classification de produits (boutique)

Serveur MediaFlows

  • Créer et gérer des automatisations de flux de travail en langage naturel
  • Interroger les automatisations PowerFlow existantes dans votre environnement
  • Créer une logique conditionnelle basée sur les métadonnées, les balises et les propriétés des ressources
  • Automatiser les flux de travail de modération, d’approbation et de notification des ressources
  • Déboguer et comprendre les configurations d’automatisation existantes

Besoin d’accéder à davantage d’outils Cloudinary ?

Nous continuons d’ajouter des fonctionnalités à ces serveurs MCP. Si vous souhaitez nous faire part de vos commentaires, signaler un bogue ou demander une fonctionnalité, veuillez ouvrir une issue dans ce dépôt.

Dépannage

« La réponse de Claude a été interrompue… »

Si ce message s’affiche, Claude a probablement atteint sa limite de longueur de contexte et s’est arrêté au milieu de sa réponse. Cela se produit le plus souvent sur les serveurs qui déclenchent de nombreux appels d’outils en chaîne, comme le serveur de gestion des ressources lorsqu’il traite de longues listes de ressources.

Pour réduire le risque de rencontrer ce problème :

  • Essayez d’être précis et de formuler des requêtes concises.
  • Si une seule requête appelle plusieurs outils, essayez de la répartir en plusieurs appels plus petits afin de raccourcir les réponses.
  • Utilisez des paramètres de filtrage pour limiter la portée des recherches et des listes de ressources.

Problèmes d’authentification

Vérifiez que vos identifiants Cloudinary sont correctement configurés et disposent des autorisations nécessaires pour les opérations que vous souhaitez effectuer.

Fonctionnalités payantes

Certaines fonctionnalités peuvent nécessiter un forfait Cloudinary payant. Vérifiez que votre compte Cloudinary dispose du niveau d’abonnement requis pour les fonctionnalités que vous souhaitez utiliser, notamment :

  • Fonctionnalités avancées d’analyse par IA
  • Utilisation intensive de l’API
  • Fonctionnalités avancées de transformation

Licence

Sous licence MIT. Consultez le fichier LICENSE pour plus de détails.