Cloudinary

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

Serveurs MCP Cloudinary

Le Model Context Protocol (MCP) est un protocole nouveau et standardisé pour 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 de Cloudinary, vous permettant d'utiliser le langage naturel pour téléverser, transformer, analyser et organiser vos ressources médiatiques directement depuis des applications d'IA comme Cursor et Claude.

Avec ces serveurs MCP, vous pouvez gérer de manière transparente l'ensemble de votre flux de travail médiatique grâce à l'IA conversationnelle — du téléversement et de la transformation d'images et de vidéos, à la configuration de pipelines de traitement automatisés, en passant par l'analyse de contenu avec des outils basés sur l'IA et l'organisation des ressources avec des métadonnées structurées. Que vous créiez des applications riches en médias, gériez de grandes bibliothèques de ressources ou automatisiez des flux de travail de contenu, ces serveurs offrent un accès direct à la suite complète de capacités d'optimisation et de gestion des médias de Cloudinary.

Les serveurs MCP suivants sont disponibles pour Cloudinary :

Nom du serveur	Description	Serveur MCP distant
Gestion des ressources	Téléversez, gérez et transformez vos ressources médiatiques avec des capacités avancées de recherche et d'organisation	asset-management
Configuration de l'environnement	Configurez et gérez les paramètres de votre environnement Cloudinary, les préréglages de téléversement et les transformations	environment-config
Métadonnées structurées	Créez, gérez et interrogez des champs de métadonnées structurées pour une meilleure organisation et recherche des ressources	structured-metadata
Analyse	Exploitez les capacités d'analyse de contenu, de modération et d'auto-étiquetage basées sur l'IA pour vos ressources médiatiques	analysis
MediaFlows	Créez et gérez des automatisations de flux de travail low-code pour les images et les vidéos avec une assistance basée sur l'IA	mediaflows

Table des matières

• Documentation
• Installation
  • Serveurs MCP distants (recommandé)
  • Serveurs MCP locaux
  • Images Docker
• Exemples de configuration
  • Configuration avancée du serveur local
• Authentification
• Fonctionnalités par serveur
• Besoin d'accéder à d'autres outils Cloudinary ?
• Dépannage
• Fonctionnalités payantes
• Licence

Documentation

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

• Documentation MCP et outils LLM Cloudinary — Guide complet pour intégrer Cloudinary avec des applications d'IA/LLM
• Documentation MCP MediaFlows — Instructions de configuration et directives pour utiliser le serveur MediaFlows (MCP)

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 requise.

Serveurs MCP locaux

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

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

Images Docker

Les images Docker officielles pour les serveurs MCP Cloudinary sont disponibles sur Docker Hub, offrant une option de déploiement conteneurisé 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 avec un minimum de configuration requise
• 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 dans 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 comme variables d'environnement lors de l'exécution des conteneurs. Consultez la documentation individuelle de chaque image Docker sur Docker Hub pour 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 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/sse"
    },
    "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 la rétrocompatibilité). Le point de terminaison /sse accepte également les requêtes POST comme alias pour /mcp, de sorte que les clients qui envoient Streamable HTTP à /sse fonctionneront. Utilisez /mcp pour les nouvelles configurations.

Serveurs MCP distants avec authentification

Les serveurs MCP distants hébergés par Cloudinary utilisent OAuth2 par défaut pour l'authentification. Vous pouvez également vous authentifier en utilisant des clés API via des en-têtes :

Utilisation de CLOUDINARY_URL (le 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 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 en-têtes de débogage

Pour afficher les en-têtes de limite de 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 avec les informations de limite de débit et de traçage 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 paquets 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", "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 du serveur local

Chaque paquet 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 SSE

Pour exécuter un serveur MCP local en utilisant le transport Server-Sent Events (SSE) au lieu de stdio :

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

Vous pouvez spécifier un port personnalisé (par défaut 2718) :

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

Options de configuration disponibles

Pour voir toutes les options de configuration disponibles pour n'importe quel paquet :

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

Liste complète des indicateurs disponibles :

USAGE
  mcp start [--transport stdio|sse] [--port value] [--tool 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]
            [--log-level debug|warning|info|error] [--env value]...

FLAGS
  --transport       The transport to use for communicating with the server
                    [stdio|sse, default = stdio]
  --port            The port to use when the SSE transport is enabled
                    [default = 2718]
  --tool...         Specify tools to mount on the server (repeatable)
  --scope           Mount tools/resources that match given scope
                    [admin|builder|librarian]
  --api-key         Sets the apiKey auth field for the API
  --api-secret      Sets the apiSecret auth field for the API
  --oauth2          Sets the oauth2 auth field for the API
  --cloud-name      Allows setting the cloudName parameter for all 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
  --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 un débogage détaillé des charges utiles 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 débogage avec d'autres options pour un dépannage complet :

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

Remarque : Ces options de configuration s'appliquent à tous les paquets MCP locaux :

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

Authentification

Lors de l'exécution de serveurs MCP localement, l'authentification peut être configurée de plusieurs manières :

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 les identifiants directement comme arguments (voir les exemples de configuration ci-dessus)

Vous pouvez trouver vos identifiants Cloudinary dans votre Tableau de bord de la console Cloudinary sous Paramètres > Sécurité.

Fonctionnalités par serveur

Serveur de gestion des ressources

• Téléversez et gérez les ressources médiatiques (images, vidéos, fichiers bruts)
• Recherchez et organisez les ressources avec des capacités de filtrage avancées
• Gérez les opérations et transformations des ressources
• Gérez les dossiers, les étiquettes et les relations entre ressources
• Générez des archives et des liens de téléchargement

Serveur de configuration de l'environnement

• Configurez les préréglages de téléversement et les paramètres de transformation
• Gérez les profils de diffusion en continu et les notifications webhook
• Configurez les mappages de téléversement

Serveur de métadonnées structurées

• Créez et gérez des champs de métadonnées structurées
• Configurez des règles de métadonnées conditionnelles et la validation
• Organisez et recherchez les configurations de métadonnées
• Gérez les relations et l'ordre des champs de métadonnées

Serveur d'analyse

• Analyse de contenu basée sur l'IA, y compris l'étiquetage, la modération et le sous-titrage
• Détection et reconnaissance d'objets avec plusieurs modèles d'IA
• Analyse de la qualité d'image et détection de filigranes
• Modération de contenu et analyse de sécurité
• Capacités de détection de la mode, du texte et de l'anatomie

Serveur MediaFlows

• Créez et gérez des automatisations de flux de travail en langage naturel
• Interrogez les automatisations PowerFlow existantes dans votre environnement
• Créez une logique conditionnelle basée sur les métadonnées, les étiquettes et les propriétés des ressources
• Automatisez les flux de travail de modération, d'approbation et de notification des ressources
• Déboguez et comprenez les configurations d'automatisation existantes

Besoin d'accéder à d'autres outils Cloudinary ?

Nous continuons d'ajouter plus de fonctionnalités à ces serveurs MCP. Si vous souhaitez laisser des commentaires, signaler un bug ou soumettre une demande de fonctionnalité, veuillez ouvrir un problème sur ce dépôt.

Dépannage

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

Si vous voyez ce message, 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 avec de grandes listes de ressources.

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

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

Problèmes d'authentification

Assurez-vous que vos identifiants Cloudinary sont correctement configurés et disposent des autorisations nécessaires pour les opérations que vous essayez d'effectuer.

Fonctionnalités payantes

Certaines fonctionnalités peuvent nécessiter un plan Cloudinary payant. Assurez-vous que votre compte Cloudinary dispose du niveau d'abonnement nécessaire pour les fonctionnalités que vous prévoyez d'utiliser, telles que :

• Fonctionnalités avancées d'analyse IA
• Utilisation de l'API à volume élevé
• Capacités de transformation avancées

Licence

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